Hier wird beschrieben, wie Artikel markiert, mit Paket exportieren in eine Datei gepackt und auf dem Ziel mit Paket importieren übernommen werden, mit Vorschau vor dem Schreiben. Alles kommt als Entwurf an; Seiten gehören nicht zum Paket, die Seite unter der Adresse eines Artikels muss auf dem Ziel schon existieren.
Reihe 6: Erweiterungen Kapitel 7 von 10
Inhalte übertragen: Artikel auf eine andere Website bringen
Was hier steht, gibt es nur mit der Erweiterung „Inhalte übertragen“. Fehlt sie in Ihrer Administration, ist sie nicht installiert.
Kurz zusammengefasst
Mit Inhalte übertragen kommen Artikel von einer Sulu-Website auf eine andere, zum Beispiel von einer Testwebsite auf die echte, mit Bildern und Sprachen in einer einzigen Datei. Version 1 überträgt nur Artikel.
Die Bilder zeigen eine Beispiel-Website. Das Menü Export/Import gibt es ab Version 1.1, in Version 1.0 waren es zwei einzelne Buttons, die Fenster sind gleich geblieben.
Vorher hilfreich: 1.5 Artikel: News und Blogbeiträge
Schritt 1 von 6 Das Menü Export/Import
In der Werkzeugleiste jeder Artikelliste steht das Menü Export/Import mit zwei Einträgen: Paket exportieren ist erst wählbar, wenn Artikel markiert sind, und die Zahl dahinter nennt, wie viele es sind; Paket importieren ist immer wählbar.
Schritt 2 von 6 Artikel exportieren
Markieren Sie in der Artikelliste einen oder mehrere Artikel und wählen Sie Export/Import › Paket exportieren. Das Fenster fragt drei Dinge:
- Sprachen: welche Sprachen mitgehen. Voreingestellt sind alle vorhandenen.
- Fassung: Veröffentlicht nimmt die veröffentlichte Fassung, Aktueller Entwurf den Entwurf.
- Bilder: Bilddateien mitliefern legt die Bilder in die Datei. Nur Verweise lässt sie weg und passt, wenn sie auf dem Ziel schon liegen.
Verlinkte Artikel, die nicht markiert wurden, listet das Fenster auf, und mit Mit exportieren kommen sie dazu. Danach lädt der Browser eine Datei mit der Endung .sulu-transfer.zip herunter.
Schritt 3 von 6 Ein Paket importieren
Wählen Sie auf der Zielwebsite Export/Import › Paket importieren. Ziehen Sie die Datei in das gestrichelte Feld oder klicken Sie darauf. Mit Prüfen geht es weiter. Bis hierhin wird nichts geschrieben.
Schritt 4 von 6 Die Vorschau lesen
Die Vorschau nennt für jeden Artikel einen Zustand und eine Aktion:
- Neu: den Artikel gibt es hier nicht. Er wird angelegt.
- Vorhanden, unverändert: er wird aktualisiert.
- Hier geändert am …: jemand hat ihn nach dem letzten Import geändert. Er wird übersprungen, solange nicht „Aktualisieren“ gewählt ist.
- Stammt aus diesem System: das Paket wurde hier exportiert. Möglich ist nur „Als Kopie anlegen“.
- Nicht importierbar: das Template oder ein Recht fehlt, oder keine Sprache lässt sich importieren.
Die Vorschau sagt auch, wie viele Bilder schon da sind, welche Kategorien und Schlagwörter neu entstehen und welche Links sich nicht zuordnen ließen. Unter der Tabelle wählen Sie die Sprachen und den Status. Voreingestellt ist alles als Entwurf, veröffentlicht wird danach auf der Zielwebsite.
Schritt 5 von 6 Den Bericht lesen
Nach dem Import listet ein Bericht jeden Artikel mit einem Link zum Öffnen, die Bilder, neue Kategorien und Schlagwörter, geänderte Adressen und entfernte Links. Ein Artikel, der scheitert, steht rot. Die übrigen werden trotzdem übertragen. Jeder Artikel wird für sich geschrieben, von einem gescheiterten bleibt nichts zurück.
Seiten werden nicht übertragen. Liegt die Adresse eines Artikels unter einer Seite, zum Beispiel /ratgeber/neuigkeiten, muss es diese Seite mit derselben Adresse und in derselben Sprache auf dem Ziel schon geben. Fehlt sie, überspringt der Import die Sprache. Hat der Artikel nur diese eine Sprache, steht er als Nicht importierbar da, mit dem Hinweis „Die Seite, unter der die Adresse (Deutsch) liegt, gibt es hier nicht. Die Sprache wird übersprungen.“ Legen Sie die Seite zuerst an, veröffentlichen Sie sie und laden Sie das Paket noch einmal hoch.
Schritt 6 von 6 Einbau in Ihr Projekt
Die Erweiterung heißt SuluContentTransferBundle. Auf Packagist steht sie in Version 1.1.1 (Stand 22. Oktober 2026). Sie braucht Sulu 3 auf beiden Websites.
- Installieren Sie das Paket mit dem Befehl unten, tragen Sie das Bundle in
config/bundles.phpein und binden Sie die Routen inconfig/routes_admin.yamlein. - Tragen Sie das JavaScript in
assets/admin/package.jsonundassets/admin/app.jsein und bauen Sie den Admin neu. - Legen Sie die Tabelle
ct_transfer_mappingan, am besten mit einer Migration. Danach legtsulu:media:initden Medienordner „Import“ an. - Leeren Sie die Caches und geben Sie den Rollen die Rechte. Die Erweiterung nutzt die vorhandenen Rechte für Artikel und Medien.
Drei Dinge gehören zum Betrieb. Erstens braucht jedes System ein eigenes APP_SECRET oder eine eigene instance_id, auch wenn die Datenbank kopiert wurde. Sonst hält sich das Ziel für die Quelle und bietet nur „Als Kopie anlegen“ an. Zweitens kommt zuerst der Code auf das Ziel, denn jeder Artikel braucht sein Template, und danach folgen die Inhalte. Drittens gehören große Pakete in die Konsole. Der Befehl sulu:content-transfer:import hat die Option --dry-run zum Ansehen ohne Schreiben.
Alles Weitere steht in der README auf GitHub. Der Ordner docs beschreibt die Regeln der Zuordnung und das Format der Datei.
composer require manuxi/sulu-content-transfer-bundle
php bin/adminconsole sulu:content-transfer:import tutorials.sulu-transfer.zip --dry-run