Reihe 6: Erweiterungen Kapitel 7 von 10

Inhalte übertragen: Artikel auf eine andere Website bringen

Inhalte pflegen
Gilt für: Erweiterung „Inhalte übertragen“ Stand: Sulu 3.0

Was hier steht, gibt es nur mit der Erweiterung „Inhalte übertragen“. Fehlt sie in Ihrer Administration, ist sie nicht installiert.

Kurz zusammengefasst

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.

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.

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.

  1. Installieren Sie das Paket mit dem Befehl unten, tragen Sie das Bundle in config/bundles.php ein und binden Sie die Routen in config/routes_admin.yaml ein.
  2. Tragen Sie das JavaScript in assets/admin/package.json und assets/admin/app.js ein und bauen Sie den Admin neu.
  3. Legen Sie die Tabelle ct_transfer_mapping an, am besten mit einer Migration. Danach legt sulu:media:init den Medienordner „Import“ an.
  4. 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.

Installation
composer require manuxi/sulu-content-transfer-bundle
Paket in der Konsole ansehen, ohne zu schreiben
php bin/adminconsole sulu:content-transfer:import tutorials.sulu-transfer.zip --dry-run

Mehr dazu