Spezifikation: die Extension syndication #

Diese Seite ist die Referenz für die Extension syndication (1.3.3). Eine Site exportiert einen Teil ihres Inhaltsbaums als Feed; eine andere Site importiert diesen Feed über SOAP und hält ihn per Cron auf dem gleichen Stand. Die Seite führt die Modul-Views und Richtlinien, die SOAP-Funktionen, die Tabellen, die Cronjob-Teile, jede Einstellung und die Art auf, wie sich ein Import authentifiziert. Lesen Sie sie, wenn Sie die Syndizierung installieren, zeitlich planen oder Fehler darin suchen. Die Einrichtung Schritt für Schritt steht auf der Funktionsseite.

Kurz gesagt #

• Einstiegspunkt in der Administration: /syndication/menu (der Reiter Syndizierung der Administration): ein Dashboard mit dem, was exportiert und was importiert wird, den letzten Läufen und den gefundenen Problemen.
• Zwei Cronjob-Teile erledigen die Arbeit: export_feed auf der exportierenden Site, import_feed auf der importierenden Site.
• Die importierende Site ruft den SOAP-Server der exportierenden Site auf; seit 1.2.0 kann sie dabei Login und Passwort senden.
• Elf Tabellen, angelegt aus sql/mysql.sql oder, auf jeder Datenbank, aus share/db_schema.dba (seit 1.3.1).

Beispiel: einen Export und einen Import von Hand ausführen #

Nachdem ein Feed und ein Import in /syndication/menu eingerichtet sind, führen Sie jeden Teil einmal im Wurzelverzeichnis der Installation aus und lesen seine Ausgabe, bevor Sie ihn in Cron eintragen:

# on the exporting site
php runcronjobs.php export_feed

# on the importing site
php runcronjobs.php import_feed

Prüfen Sie danach die importierten Objekte unter Syndizierung > Importe. Führen Sie beide Teile alle paar Minuten per Cron aus; für den Export werden 3 Minuten empfohlen.

Modul syndication #

Jede View verwendet den Navigationsteil ezsyndicationnavigationpart (seit 1.3.3; vorher ezsyndicationpart), daher kommt das linke Menü in jedem Administrationsdesign aus design/standard/templates/parts/syndication/menu.tpl. Das alte parts/s/menu.tpl bleibt bestehen und bindet es ein.

Richtlinienfunktionen: import_object_status, view_export, edit_export, remove_feed, create_feed, menu, view_import, edit_import, view_export_info, create_import und fetch_feed mit der Einschränkung Feed. Vor 1.3.3 nannte import_info als Skript import_info (ohne .php) und als Funktion import_view, die die Funktionsliste nicht definierte, und feed_info deklarierte kein Skript; beide Views sind jetzt vollständig.

Konsolenbefehle, Cronjob-Teile und Hintergrundläufe (seit 1.3.3) #

Die Arbeit steckt in ausführbaren Klassen (dem Muster #207 des Kernels); die Dateien in bin/php/ und cronjobs/ bestehen jeweils aus einem Aufruf. Ein Lauf setzt eine Sperre (jeweils ein Export und ein Import gleichzeitig, egal wer ihn startet), schreibt Zeitpunkt und Ergebnis für das Dashboard und löst die Ereignisse für ausführbare Klassen des Kernels aus, sodass das Audit ihn wie jeden Cronjob des Kernels sieht.

Der Cronjob und die Befehle überspringen Feeds und Importe, die nicht aktiv sind, und laufen als der Benutzer aus [Syndication] CronUser. Die Schaltflächen „jetzt ausführen“ der Administration starten denselben Befehl mit expProcessTools (setsid, die PHP-Kommandozeile) im Hintergrund und zeigen seinen Zustand und seine Ausgabe auf der Seite; die Zustandsdateien liegen in var/<site>/syndication/jobs/, die neuesten 20 werden aufbewahrt.

SOAP-Funktionen #

soap/initialize.php registriert diese Funktionen am SOAP-Server der exportierenden Site (soap.ini [ExtensionSettings] SOAPExtensions[]=syndication):

Klassen #

Alle in classes/: eZSyndication, eZSyndicationFeed, eZSyndicationFeedCacheManager, eZSyndicationFeedItem, eZSyndicationFeedItemExport, eZSyndicationFeedItemStatus, eZSyndicationFeedSource, eZSyndicationFeedSourceFilter, eZSyndicationFilter, eZSyndicationImport, eZSyndicationImportFilter. Die Filter aus [SyndicationFilters] sind eZFilterSection und eZFilterAttribute in classes/filter/; beide erweitern eZSyndicationFilter.

Tabellen #

Elf Tabellen, definiert in sql/mysql.sql und, seit 1.3.1, im engine-neutralen share/db_schema.dba, sodass ein Installer sie auf jeder Datenbank anlegen kann, die Exponential unterstützt. Das SOAP-Protokoll hat drei Indizes. (sql/mysql.sql enthält außerdem zwei auskommentierte ezsyndicate_export_event-Tabellen; sie werden nicht angelegt.)

Cronjob-Teile #

Die Extension trägt sich selbst in [CronjobSettings] ExtensionDirectories[] ein, sodass runcronjobs.php beide Skripte findet. Beide sind Stubs, die die oben genannten ausführbaren Klassen aufrufen.

Einstellungen #

Alle Werte sind die eigenen Standardwerte der Extension (Geltungsbereich: Extension, extension/syndication/settings/). Überschreiben Sie sie in settings/override/ oder in einem Siteaccess.

Authentifizierung des Imports (seit 1.2.0) #

eZSyndicationImport liest Login und Passwort für die exportierende Site aus der Serveradresse des Imports (https://<login>:<password>@<host>/) oder aus den Schlüsseln login und password des Options-Arrays (den Feldern Login und Passwort im ersten Schritt des Imports). Die Verbindung geht bei https an Port 443, sonst an Port 80. Schützen Sie den SOAP-Endpunkt der exportierenden Site mit einer HTTP-Zugriffskontrolle und halten Sie diese Zugangsdaten aus der Versionsverwaltung heraus.

Siehe auch #

• Funktionsseite, Verhaltensänderungen der Extensions
• Cronjobs in der Konsole, Betrieb einer Site
• Chronik, Release Notes
• Monate: 2025-09, 2026-03, 2026-07, 2026-09, 2026-10