Contao 5 - Struktur, Speicherort und Aufbau eigener Bundles

[Nacht69]

Guten Tag,

wir migrieren mehrere eigene sehr große Bundles von Contao 4 auf Contao 5 und wollen die bestehende Struktur dabei korrekt neu aufsetzen.

Wie sieht die Empfohlene Ordner- und Dateistruktur eines Bundles inkl. Platzierung von services.yaml aus (Aktueller Stand: Die services.yaml liegt zentral unter config/ im Contao-Projekt und wird von allen Bundles genutzt. Es wäre aber um einiges sinnvoller jeweils eine pro Bundle zu haben) ?

Existiert ein aktuelles Skeleton-Bundle für Contao 5, das diesen Aufbau sauber und richtig zeigt?
Mir ist wichtig, dass man auch sieht wie es mit mehreren Bundles auszusehen hat, die man dann je nach Kunden-Bedarf installieren kann.

Ich finde zwar Informationen diesbezüglich, leider sind diese aber widersprüchlich.

Danke schon mal

[Spooky]

Contao 4 oder 5 geben keine Struktur vor - bis auf Contao-spezifische Dinge wie die config.php, DCA und Language Dateien. Symfony gibt eine Struktur vor bzw. es gibt gewisse Konventionen - aber auch die haben wenig mit Contao oder mit einer gewissen Contao Version selbst zu tun.

(Aktueller Stand: Die services.yaml liegt zentral unter config/ im Contao-Projekt und wird von allen Bundles genutzt. Es wäre aber um einiges sinnvoller jeweils eine pro Bundle zu haben) ?

Was genau meinst du damit? In wie fern nutzen eure Bundles eine gemeinsame services.yaml? Normalerweise hast du die Service Defintionen natürlich pro Bundle.

Oder meinst du hier lokale Bundles, wo du im Endeffekt mehr oder weniger nur eine Namespace Trennung machst?

[BennyBorn]

Also wir schauen das wir uns generell mit der Struktur an den Core-Bundles orientieren.

Was mehrere individuelle Bundles pro Kundeninstallation angeht haben wir meistens im Projekt-Root einen Unterordner "bundles" und darin dann sowas wie das "customer-company-bundle" ggf. neben anderen Bundles die nicht öffentlich verfügbar sind (das muss man dann in der composer.json entsprechend bekannt machen).

[Nacht69]

Contao 4 oder 5 geben keine Struktur vor - bis auf Contao-spezifische Dinge wie die config.php, DCA und Language Dateien. Symfony gibt eine Struktur vor bzw. es gibt gewisse Konventionen - aber auch die haben wenig mit Contao oder mit einer gewissen Contao Version selbst zu tun.

Was genau meinst du damit? In wie fern nutzen eure Bundles eine gemeinsame services.yaml? Normalerweise hast du die Service Defintionen natürlich pro Bundle.

Oder meinst du hier lokale Bundles, wo du im Endeffekt mehr oder weniger nur eine Namespace Trennung machst?

Danke für eure Antworten

Das mit der gemeinsamen service.yaml hat sich erledigt Hatte bis jetzt nur ein neues Modul mit einer service.yaml und da lag diese im root config ordner - das ist jetzt anders.
Die derzeitige Struktur sieht so aus - ist das so in ordnung?

root
-packages 
--BUNDLENAME
---config
----services.yaml
---contao
----config
----dca
----templates
---public
---src
----Contao Manager
-----Plugin.php
----Controller
----Model
----Module
----Resources
----BundleName.php
--composer.json
composer.json

Ich hab mir ebenfalls die Contao Bundles angeschaut - dort liegen die Module noch im BUNDLE/contao/module.
Was spricht da dagegen - wird diese Option in Zukunft auch vorhanden sein bzw welchen Vorteil hat man, wenn man dies im src Ordner und der service.yaml macht?

wie sieht es mit Twig aus? Müssen alle html5 Templates sicher auf twig umgeschrieben werden?

[Spooky]

Ich hab mir ebenfalls die Contao Bundles angeschaut - dort liegen die Module noch im BUNDLE/contao/module.

Das sind Legacy Module, da darfst du dir nichts abschauen

Und ja, du solltest Twig nutzen.

[Nacht69]

Das sind Legacy Module, da darfst du dir nichts abschauen

Und ja, du solltest Twig nutzen.

Ah Danke! Bei welchem Bundle darf/soll ich abschauen?

[Spooky]

Die derzeitige Struktur sieht so aus - ist das so in ordnung?

root
-packages 
--BUNDLENAME
---config
----services.yaml
---contao
----config
----dca
----templates
---public
---src
----Contao Manager
-----Plugin.php
----Controller
----Model
----Module
----Resources
----BundleName.php
--composer.json
composer.json

• Üblich wäre den Ordner/Subnamespace "ContaoManager" zu nennen, nicht "Contao Manager". Letzteres funktioniert vermutlich auch gar nicht.
• src/Resources/ brauchst du nicht mehr in der neuen Symfony Bundle Struktur.
• Wofür genau hast du src/Module/? Wenn du damit Frontend Modul in Contao meinst - die wären konventionell unter src/Controller/FrontendModule/. Frontend Module sind aber obsolet, es wird in Zukunft nur mehr Inhaltselemente geben.

[Nacht69]

• Üblich wäre den Ordner/Subnamespace "ContaoManager" zu nennen, nicht "Contao Manager". Letzteres funktioniert vermutlich auch gar nicht.
• src/Resources/ brauchst du nicht mehr in der neuen Symfony Bundle Struktur.
• Wofür genau hast du src/Module/? Wenn du damit Frontend Modul in Contao meinst - die wären konventionell unter src/Controller/FrontendModule/. Frontend Module sind aber obsolet, es wird in Zukunft nur mehr Inhaltselemente geben.

Danke das hat mir schon sehr weitergeholfen!
-Contao Manager war ein Tippfehler sry.
- Ok dann kommt der gleich raus ...genau so wie der Module Ordner - Wie muss ich das dann verstehen? zB Ein klassisches Module wäre für mich zB ein Head Slider oder ein Footer - den ich dann direkt ins Layout einbinde. Wie würde das mit Inhaltselementen aussehen? (tl_content wie früher oder?)

[Spooky]

Wie würde das mit Inhaltselementen aussehen? (tl_content wie früher oder?)

Genau so. Ab Contao 5.6 kannst du Inhaltselemente auch im Theme ablegen und diese dann im Layout auswählen.