Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

RSS-, Atom- und OPML-Feeds für Integrationen

Feeds als einfachste Pull-Integration - Inhalte als RSS 1.0, RSS 2.0, Atom, OPML oder Podcast-Feeds exportieren, die RSS-Feeds anderer Systeme per Cronjob importieren, wie importierte Einträge geschlüsselt werden…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/integrators/rss-atom-and-opml-feeds.md

On this page

This page is a translation. Read the English original

RSS-, Atom- und OPML-Feeds für Integrationen

Diese Seite richtet sich an Integratoren, die einen einfachen, standardisierten Weg brauchen, um Listen von Inhalten zwischen Systemen zu bewegen. Ein Feed ist eine Pull-Integration ohne Code: Exponential veröffentlicht einen Feed, den jeder Reader, Aggregator oder nachgelagerte System abrufen kann, und es kann die RSS-Feeds anderer Systeme lesen und deren Einträge zu Inhaltsobjekten machen. Die Seite der Administration beschreibt RSS-Feeds.

Inhalt

  1. Wann ein Feed genügt
  2. Exportieren
  3. Importieren
  4. Wie importierte Einträge geschlüsselt werden
  5. Caching und Aktualität
  6. Grenzen
  7. Checkliste

Wann ein Feed genügt

Passt gutPasst schlecht
Eine Partner-Website zeigt Ihre neuesten NachrichtenDas andere System braucht jedes Feld jedes Objekts
Ein Aggregator, ein Newsletter-Werkzeug oder ein Planer für soziale Medien übernimmt neue ArtikelAustausch in beide Richtungen, Bearbeitungen und Löschungen müssen mitreisen
Sie übernehmen den RSS-Feed einer Presseagentur oder eines KonzernunternehmensDie Quelle bietet nur Atom an (kein Atom-Import)
Ein Podcast-Verzeichnis liest Ihre EpisodenZustellung in Echtzeit innerhalb von Sekunden

Exportieren

Ein Export listet die neuesten Objekte unterhalb einer oder mehrerer Quellen (ein Ort, eine Klasse und wahlweise die Unterelemente) unter /rss/feed/<address> auf, auf der öffentlichen Website des Siteaccess des Exports. Formate (kernel/classes/ezrssexport.php):

FormatGespeicherter WertHinweise
RSS 1.01.0Wie RSS 2.0 und Atom mit der Feed-Bibliothek der expcomponents geschrieben (ezcFeed, der Fork der Feed-Bibliothek der Zeta Components)
RSS 2.02.0Die übliche Wahl; ein Bild lässt sich festlegen
Atom 1.0ATOMRFC 4287
OPML 2.0OPMLEine Liste anderer Feeds; site.ini [RSSSettings] OPMLMaxOutlines (Standard 5000)
Apple PodcastsITUNESRSS 2.0 mit den Podcast-Elementen

Je Quelle wählen Sie, welche Klassenattribute zu Titel, Beschreibung, Kategorie und Anhang des Eintrags werden. Exporte legen Sie unter Setup > RSS an und bearbeiten sie dort (/rss/list, Richtlinie rss/edit). Exporte werden in der Datenbank gespeichert (ezrss_export und zugehörige Tabellen), richten Sie sie also in jeder Umgebung ein oder nehmen Sie sie in die Datenbank auf, die Sie kopieren.

Testen Sie einen Export von der empfangenden Seite aus:

curl -s https://example.com/rss/feed/<address> | head -20

Importieren

Ein Import liest einen RSS-Feed (RSS 0.91, 0.92, 1.0 und 2.0; kernel/classes/ezrssimport.php) und legt für jeden Eintrag, den er noch nicht gesehen hat, ein Objekt unterhalb seines Ziels an. Das Importformular hat vier Teile: der Feed und seine URL, wohin die Einträge gehen (Ziel und Besitzer), was jeder Eintrag wird (die Klasse und die Zuordnung der Feed-Felder zu Attributen) und ob er läuft.

Nichts wird gelesen, bevor der Cronjob läuft: rssimport.php steht im globalen Teil von settings/cronjob.ini ([CronjobSettings] Scripts[]), der läuft, wenn runcronjobs.php ohne Teilnamen aufgerufen wird:

php runcronjobs.php -s <siteaccess> --script=rssimport.php   # one run, by hand
php runcronjobs.php -s <siteaccess>                          # the global part, as the crontab runs it

Der Import lehnt externe Entitäten ab und schaltet während des Parsens das Netzwerk ab (LIBXML_NONET), und er ruft nur http- und https-Adressen ab.

Wie importierte Einträge geschlüsselt werden

Jedes von einem Import angelegte Objekt erhält eine Remote-ID, die mit RSSImport_<import id>_ beginnt; die RSS-Übersicht zählt importierte Objekte anhand dieses Präfixes. Das ist dieselbe Idee, die jede Integration verwenden sollte: ein stabiler Schlüssel mit Präfix je Quelldatensatz (Idempotente Importe, geschlüsselt nach remote_id).

Ein Import fügt Objekte hinzu und entfernt oder aktualisiert sie nie. Damit ein lebhafter Feed nicht grenzenlos wächst, schalten Sie das Aufräumen ein (content.ini [RSSImportCleanupSettings], Befehl php bin/php/cleanuprss.php --apply, Cronjob-Teil cleanuprss), das je aktivem Import die neuesten N Einträge behält (Aufräumen von RSS-Importen).

Caching und Aktualität

EinstellungWirkung
site.ini [RSSSettings] CacheTimeSekunden, die ein geschriebener Feed aus dem Cache ausgeliefert wird; 0 schreibt ihn bei jeder Anfrage neu
Cache-ID rss_cacheLeeren Sie ihn nach einer Änderung, die sofort sichtbar sein muss: php bin/php/ezcache.php --clear-id=rss_cache --allow-root-user

Sagen Sie den Abnehmern, wie oft sie abrufen sollen; viel häufigeres Abrufen als CacheTime bringt nichts.

Grenzen

  • Kein Atom-Import: Der Importer liest nur das Attribut version eines RSS-Wurzelelements.
  • GET /api/ezp/<version>/content/node/<id>/listAtom der REST-API antwortet mit 500; verwenden Sie stattdessen einen RSS-Export.
  • Ein Export listet die neuesten Einträge, kein vollständiges Archiv: Er ersetzt keinen Datenexport.
  • Importe folgen keinen Aktualisierungen oder Löschungen von Einträgen an der Quelle.

Checkliste

  • To do: Export: Format, Adresse, Quellen, Anzahl der Einträge und Attributzuordnung mit dem Abnehmer abgestimmt.
  • To do: Export: CacheTime und das Abrufintervall in der Schnittstellenspezifikation festgehalten.
  • To do: Import: Ziel, Besitzer (ein Dienstkonto) und Klassenzuordnung gesetzt; die Feed-URL verwendet https.
  • To do: Import: Der Cronjob, der rssimport.php ausführt, steht in der Crontab und läuft für den richtigen Siteaccess.
  • To do: Import: Aufräumen konfiguriert, wenn der Feed lebhaft ist.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x