Wenn die Dokumentation zu einer neuen Version noch fehlt, bleibt der Quellcode. So war es bei mir, als ich das SuluEventBundle auf Sulu 3 umgebaut habe. Vom ersten Umbau-Commit am 29. November 2025 bis zur Version 3.0.0 am 13. Dezember vergingen vierzehn Tage. Was davor mit dem Kalender geschah, steht im vorigen Beitrag.
Die Sulu-Dokumentation war damals noch nicht auf Version 3 umgestellt. Anleitungen, wie man ein eigenes Bundle umbaut, gab es kaum. Im Sulu-Slack habe ich nur eine Aufbewahrung von 90 Tagen, ältere Gespräche sind also nicht mehr sichtbar. Geblieben sind zwei Schlagworte: DimensionContent und Doctrine, das PHPCR endlich abgelöst hat. Alles Weitere musste ich im Quellcode nachlesen. Dabei war KI sehr hilfreich.
Was sich in Sulu 3 ändert
In Sulu 2 lagen Seiten im Content-Repository PHPCR, eigene Inhalte wie Events in Doctrine-Tabellen. Alles, was Seiten selbstverständlich können, musste ich für Events nachbauen: Sprachen, SEO, Excerpt, Autor. In Sulu 3 ist Doctrine für alle Inhalte zuständig, und es gibt ein gemeinsames Modell dafür.
Ein Inhalt besteht dort aus zwei Teilen. Die Hülle ist bei mir die Klasse Event. Sie trägt die Kennung und die Verknüpfungen zu Wiederholung und Social-Einstellungen. Die eigentlichen Inhalte stehen in DimensionContent-Einträgen. Ein solcher Eintrag hält die Inhalte für eine Sprache in einem Stand (Entwurf oder live) und in einer Version.
Der 4. Dezember
Am 4. Dezember kam der Umbau auf DimensionContent. Der Commit berührt 61 Dateien, 3.740 Zeilen kamen hinzu, 3.862 fielen weg.
Weg waren die Übersetzungs-Entitäten und die eigenen Tabellen für SEO und Excerpt, dazu die drei Modellklassen, die ich am 30. März 2021 eingeführt hatte, und eine Klasse von 435 Zeilen, die Listen für den Admin aufbaute. Die Klasse Event hat heute 79 Zeilen. An ihre Stelle trat EventDimensionContent.
Eine Kleinigkeit gefällt mir daran besonders. Die Bausteine, die ich 2021 mit Interfaces und Traits selbst gebaut hatte, also SEO, Excerpt und Autor, bringt Sulu 3 jetzt selbst mit. Die neue Klasse bindet sie als SeoTrait, ExcerptTrait und AuthorTrait aus Sulu ein.
class EventDimensionContent implements DimensionContentInterface, ExcerptInterface, SeoInterface, AuthorInterface /* … */
{
use AuthorTrait;
use DimensionContentTrait;
use ExcerptTrait;
use SeoTrait;
// … insgesamt 12 Traits aus vendor/sulu/sulu/packages/content
}
Reihenfolge im Dezember
- 29. November: MassiveSearch entfernt
- 1. Dezember: Liste, Formulare, Smart Content und Auswahlfelder laufen
- 2. Dezember: Admin-Suche läuft
- 4. Dezember: Umbau auf DimensionContent beginnt
- 8. Dezember: Speichern und Vorschau funktionieren, die Orte laufen
- 9. Dezember: SEO und Excerpt werden gespeichert, die Liste zeigt den Veröffentlichungsstand an, Link-Provider
- 10. Dezember: Sitemap-Provider
- 11. Dezember: Referenzen, SuluSharedTools entfernt
- 13. Dezember: Version 3.0.0
Smart Content habe ich am 1. und am 9. Dezember jeweils als lauffähig gemeldet. Dazwischen lag der Umbau auf DimensionContent.
Nach der 3.0.0
Mit der ersten Version war die Arbeit nicht getan. Bis zum 14. Januar folgten zehn Korrekturversionen, 3.0.1 bis 3.0.10.
Zwei Stolpersteine sind mir im Gedächtnis geblieben. Die Inhalte eines Events müssen per Eager Loading geladen werden. Das zeigte sich am 23. Dezember und noch einmal am 14. Januar. Dazu kam Sulu 3.0.1: Am 31. Dezember habe ich einen Fix für Sulu 3.0.1 zurückgenommen und die feste Bindung an Sulu 3.0.0 entfernt, am 6. Januar lief das Bundle mit Sulu 3.0.1.
Am 24. Januar kam mit Version 3.1.0 der Teaser-Provider hinzu.
Ein Tipp für den eigenen Umbau
Wer vor demselben Umbau steht, findet die Referenz im Quellcode von Sulu selbst. Unter vendor/sulu/sulu/packages/content liegt das Content-Paket, auf dem Seiten, Artikel und Schnipsel aufbauen. Zwei Ordner darin habe ich immer wieder geöffnet:
src/Domain/Modelenthält die Interfaces und Traits:ContentRichEntityInterfacefür die Hülle,DimensionContentInterfacefür den Inhalt, dazuSeoTrait,ExcerptTrait,AuthorTrait,RoutableTrait,WorkflowTraitund weitere. Meine KlasseEventDimensionContentbindet heute zwölf davon ein.src/Applicationenthält die Dienste, die mit diesen Modellen arbeiten, etwaContentWorkflowfür Veröffentlichen und Zurückziehen,ContentAggregator, der die Dimensionen einer Sprache zusammenführt, sowieContentNormalizerundContentMerger. Das EventBundle nutzt sie über Services wiesulu_content.content_workflowundsulu_content.content_aggregator.
Wie Sulu selbst einen Inhaltstyp auf dieser Grundlage baut, zeigt das Nachbarpaket vendor/sulu/sulu/packages/article, mit Admin, Formularen, Vorschau, Routing und Suche. Den Sulu-2-Branch des EventBundles gibt es weiterhin, weiterentwickelt habe ich ihn aber nicht, dafür fehlt mir die Zeit.
Repository: manuxi/SuluEventBundle auf GitHub