INCLUDE-Funktionen

Das WebsoziCMS bietet speziellen Code 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 (ggf. müsst ihr den Editor erst über den entsprechenden Button in die Quelltextansicht schalten)

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