Swiss Alpine Club SAC - Hut News

Dokumentation

Diese Dokumentation stellt eine Übersicht zur Verwendung der Hütten News zur Verfügung.

Switch language: English

Voraussetzungen

Die folgenden Anforderungen gelten bei der Verwendung der Hütten News.

Als erstes wird ein Zugang zum Hub benötigt, um dort eigene Nachrichten zu erfassen. Dieser kann per E-Mail an it@sac-cas.ch angefragt werden.
Danach wird die URL zum RSS Feed benötigt, damit die eigenen Nachrichten abgerufen werden können. Die URL ist nach folgendem Schema aufgebaut: https://news-hub.web.sac-cas.ch/hutnews/hut/25 wobei die 25 durch die jeweilige ID der Hütte ersetzt werden muss.
Die ID der Hütte kann über das Tourenportal gefunden werden. Dazu kann unter https://www.sac-cas.ch/de/huetten-und-touren/sac-tourenportal/?type=hut&sortField=display_name nach der entsprechenden Hütte gesucht werden. Die ID befindet sich dann in der Adresse zur jeweiligen Hütte.
Die Hütte mit der ID 25 hat dabei die Adresse https://www.sac-cas.ch/de/huetten-und-touren/sac-tourenportal/2147000025.

Im Anschluss kann der Feed in die eigene Seite integriert werden. Die genauen Anforderungen hängen dabei von der verwendeten Software ab.
Wenn Sie ein CMS einsetzen. z.B. TYPO3 oder Wordpress, können Sie ein RSS Feed Reader Plugin installieren, die oben erwähnte URL eintragen und dann können Sie die News auf einer von ihnen erstellten Seiten darstellen, oder die Ausgabe auf einer vorhandenen Seiten erweitern.

Inhalt der News

Der RSS Feed folgt der Spezifikation ohne Erweiterungen.

Jeder Eintrag hat genau einen Tag <category>. Der Wert ist entweder "General" oder "Conditions".
Jeder Eintrag hat keinen bis mehrere <enclosure> Tags um Bilder zur Verfügung zu stellen.

Optionale Parameter

Die folgenden zusätzlichen Parameter können der URL übergeben werden:

provideTitle=1 um einen <title> Tag pro Eintrag zu erzeugen. Nachrichten haben normalerweise keinen Titel, dieser wird aus dem Inhalt erzeugt.
format=rss, format=atom fordert den Feed im entsprechenden Format an. RSS ist dabei der Default wenn der Parameter fehlt.

Änderungen

Der Feed stellt immer alle aktuell vorhandenen Einträge im aktuellsten Zustand zur Verfügung.

Einträge können jederzeit entfernt werden. Das bedeutet sie sind nicht länger gültig.
Einträge können jederzeit aktualisiert werden. Der Tag <guid> kann genutzt werden um Einträge zu identifizieren. Der Wert bleibt immer gleich.

Support

Für Support können Sie gerne unser Feedback Formular nutzen: https://www.sac-cas.ch/de/feedback/.