INCLUDE-Funktionen

Aus WebSoziCMS Handbuch
Version vom 27. April 2017, 13:57 Uhr von Mhagge (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche


Das WebsoziCMS bietet speziellen Codes an für die Einbindung von externen Inhalten oder Funktionsinhalten. Texte, die auf einem anderen Server liegen, können damit eingelesen werden, Extrablöcke werden angezeigt und Flash kann damit einfacher eingegeben werden. Diese Codes können an beinahe beliebiger Stelle auf Seiten, in Blöcken, im Startseitentext oder in Artikeln angegeben werden (Achtung: der Editor muss vor der Eingabe von Codes erst über den entsprechenden Button in die Quelltextansicht geschaltet werden)

Folgende Möglichkeiten gibt es:

Externe Inhalte

Externe Inhalte können nach folgendem grundsätzlichem Muster eingelesen werden:

[include:example.com/text.txt]

oder

<wsc:include data="http://example.com/text.txt"></wsc:include>

Eingelesen werden können: HTML-Textabschnitte, CVS (Excel-Export), RSS, ATOM (auch Google Calendar), ICS (Outlook- oder Mozilla-Calendar-Termine), Text.

Einstellungen für die Anzeige: Parameter

Es gibt verschiedene Einstellungen, die übergeben werden können. Bei [include:example.com/text.txt] werden die Parameter mit dem ODER-Zeichen | getrennt:

Beispiel: [include:example.com/feed.rss|rsslimit=4]

Bei der Eingabe durch <wsc:include> werden Parameter als Attriute und mit <wsc:param> weitergegeben. Möglich sind folgende Attribute:

  • data="ADRESSE", erforderliche Adresse zum Einlesen der Texte
  • type="MIME-TYPE", erforderlich, wenn die Dateiendung fehlt, z.B muss bei http://www.dradio.de/rss/podcast/nachrichten/ der Mime-Type "application/xml+rss" angegeben werden.
  • cache="STUNDEN", kann angegeben werden, um den Text neu zu laden. Für STUNDEN wird eine Zahl eingesetzt.
  • Außerdem: xml:lang="SPRACHKÜRZEL", dir="TEXTRICHTUNG"

Beispiel: <wsc:include data="http:://example.com/rss/" type="application/xml+rss" cache="48"></wsc:include>

Spezielle Angaben für Dateitypen RSS, ATOM, ICS (Termine)

Hinweis: Podcasts werden erkannt und MP3-Dateien werden mit einem Flahs-MP3-Plaser ausgegeben.

limit: (nur <wsc:include> Anzahl der Nachrichten, die ausgegen werden sollen rsslimit: (nur [include] Anzahl der Nachrichten, die ausgegen werden sollen nodescription: Keine Beschreibung anzeigen, also nur die Titel

Beispiel:

<wsc:include data="http:://example.com/rss.xml"> <wsc:param name="limit" value="5" /> <wsc:param name="nodescription" value="1" /> </wsc:include>

oder

[include:http:://example.com/rss.xml|rsslimit=5&nodescription=1]

Spezielle Angaben für Dateitypen CSV (Tabellen)

Tabellen können formatiert werden. tableformat: Mit Kopfzeile: 1 oder 0 tableborders: Rahmen, CSS-Klasse admintable: 1 oder 0 textcolors: CSS-Farbangaben, mit Semikolon getrennt backgroundcolors: CSS-Farbangaben, mit Semikolon getrennt

Beispiel:

<wsc:include data="http://exmaple.com/table.csv" xml:lang="de" type="text/csv"> <wsc:param name="tableformat" value="1" /> <wsc:param name="tableborders" value="1" /> <wsc:param name="backgroundcolors" value="#fff;#ccc" /> </wsc:include>

Oder

[include:http://exmaple.com/table.csv|tableformat=1&tableborders=1&backgroundcolors=#fff;#ccc]

Probleme beheben

Die Importe werden zuerst anhand der Dateiendung geprüft. Ist keine Dateiendung vorhanden oder anders, kann die Datei ohne zusätzliche Angaben nicht importiert werden.

Dann müsst ihr den Mimetype anhängen

Beispiel SPD.de:

[include:http://www.spd.de/rss/news|type=application/rss+xml]

  • RSS: |type=application/rss+xml
  • ATOM: |type=application/atom+xml
  • CSV: |type=text/csv
  • HTML: |type=text/html
  • TEXT: |type=text/plain

Beispiel: rss-Feed von spd.de einbinden

Den RSS-Feed von spd.de bindest Du mit folgendem Quellcode ein (das funktioniert anlog mit jedem RSS-Feed, siehe oben)

[include:https://www.spd.de/aktuelles/feed.rss|rsslimit=5]

Die Zahl hinter rsslimit (im Beispiel die 5) kannst Du nach deinen Wünschen verändern, sie kennzeichnet die Zahl der eingelesenen Artikel (wobei die Zahl natürlich nicht höher sein kann als wie Artikel im RSS-Feed vorhanden sind - das muss nicht mit der visuellen Anzeige übereinstimmen)