Erweiterung in Contao 4.3.5 und höher

[Nils Heinold]

Ich möchte gerne eine für mich persönlich wichtige Erweiterung auf Contao 4.3.5 und weiter tauglich machen.

Ich finde aber wenig weiterhelfende Informationen und bitte daher hier um ein paar Informationen.

1. Wo liegt jetzt eigentlich eine neue Erweiterung, im Verzeichnis „vendor“ oder unter „vendor/contao“
2. Wo registriere ich meine Erweiterung und ihre PHP- Klassen mit, bzw. ohne den contao-manager, in der neuen Symfony- Umgebung (AppKernel.php, autoload_classmap.php, …), um sie zum laufen zu bringen.

Weitere Fragen ergeben sich dann zwangsläufig weiter,.

Vielen Dank im Voraus.

Nils

[Schlauchbeutelmaschine]

Hi,

ich würde gerne diese Frage nochmal nach oben holen.

Punkt 1 ist klar, einfach unter vendor ein eigenes Verzeichnis erstellen und dort die Erweiterung in der üblichen Struktur einfügen.

Bei Punkt 2 bin ich nicht sicher wie ich vorgehe.
Ich habe die aktuelle 4.3.7 managed Version und eine eigene fertige Contao 4 Erweiterung.
Wie kann ich diese am einfachsten installieren wenn sie nur lokal vorhanden ist?

Wäre nett wenn jemand helfen könnte. :-)

Grüße Sabri

[BugBuster]

Äh nein, unter vendor machst du nichts, das macht der Composer. Er lädt die Dateien von GitHub über Packagist.org runter und beachtet die composer.json von der Erweiterung, was zu tun ist.
Sprich, ob die einfach unter vendor/ bleiben oder noch zusätzlich nach system/modules/... kopiert werden sollen.
Außerdem generiert Composer auch jedesmal die autoloader Dateien neu, damit auch alle Klassen gefunden werden.

Falls du schon mal eine Erweiterung für Contao 3 + Composer fertig hattest, ändert sich dabei fast nichts.
Für die Standard Edition muss eine weitere Datei angelegt werden, für die Managed Edition noch eine weitere + eine Eintrag in der composer.json.

Du könntest sogar die Contao 3 Erweiterung manuell nach systems/modules kopieren und es sollte in den meisten Fällen laufen so sagt man.


Die Dokumentation ist derzeit noch dürftig, wird aber demnächst kommen so hört man.
Meine Contao 4 ME Erweiterungen habe ich per "ich schaue mal wie die anderen das machen" gebaut.

[BugBuster]

Nachtrag: Ich habe meine so gebaut wie FAQ/News etc. von Contao zu Zeiten von Contao 4.1, da waren die noch kaum angepasst aber schon lauffähig für die heutige Standard Edition.
Soll heißen, die original Dateien und Pfade unterhalb des Resources/Contao/ Verzeichnisses. Das Handbuch dazu ist wohl grad verschwunden auf Contao.org. Aber wie gesagt da ist was in Arbeit.

Wenn du mal schauen willst, meine XING Erweiterung ist recht überschaubar.
https://github.com/BugBuster1701/contao-xing-bundle

[Spooky]

Für die Standard Edition muss eine weitere Datei angelegt werden, für die Managed Edition noch eine weitere + eine Eintrag in der composer.json.

Eigentlich muss gar nichts angelegt werden, weder für die standard-edition, noch für die managed-edition. Was genau meinst du da?

[BugBuster]

Na die Datei ich in in AppKernel registrieren muss. Meine Erweiterungen für Contao 4 werden nicht nach systems/modules kopiert.
Wenn man nur das will, dann geht das natürlich auch ohne. (ungetestet)

[Spooky]

Achso, du meintest für Bundles. War mir nicht sicher worauf dieser Thread nun genau hinaus will.

[BugBuster]

Ja, dazu muss man sich erst mal entscheiden, wie man in Contao 4 anfängt. Contao-Bundle oder "Old School Hack"

[Spooky]

Contao 3 Erweiterungen die mit Contao 4 kompatibel sind, sind kein Hack, sondern zu 100% in Contao 4 unterstützt .

[Spooky]

Wie man lokal ein vendor bundle entwickelt hat xtra hier kurz umrissen: https://community.contao.org/de/show...l=1#post422990

[BugBuster]

Wer in Richtung Bundles gehen will: https://docs.contao.org/books/extend...naged-edition/
oder nur mal lesen will was sich so ändert (API Changes / Deprecated features) ist dort im Abschnitt "Background Information" zu finden.

[Schlauchbeutelmaschine]

Hi Leute,

vielen Dank für die Antworten!

Ich hatte das Modul auf Basis eines Contao Bundles aufgebaut, werde aber nochmal prüfen ob alles passt.

Nur zum Verständnis, bei einem lokalen bundle, ohne Git und ohne Packagist muss ich die composer.json des Bundels so konfigurieren wie im 2. Beispiel von xtra?
Also das repository als eigenes Verzeichnis im pfad des root? Und dann einfach "composer install" ausführen?
Oder muss ich dann noch die composer.json des Systems anpassen?

Grüße Sabri

[Spooky]

Was meinst du mit "im Pfad des root"? Du musst in der composer.json deiner Contao Installation die Information hinzufügen, wo dein Code (lokal) liegt.

[Schlauchbeutelmaschine]

Damit meine ich das der Ordner zum Bundle auf der gleichen Ebene wie der "app" Ordner liegt.
Füge ich in die composer.json vom System den ganzen Inhalt der composer.json des Bundles?

Danke schonmal!

[Spooky]

Ich verstehe deine Struktur nicht ganz, beschreibe da mal genauer.

[Schlauchbeutelmaschine]

Mein Aufbau entspricht dem Modul von Bugbuster und es liegt aktuell auf der gleichen Ebene wie der App Ordner.
Es ist dann genauso wie in dem Beispiel von xtra abgelegt:

"repositories": [
        {
            "type": "path",
            "url": "_external/meinmodul"
        }
],

[Spooky]

Verstehe es immer noch nicht ganz. Du hast mehrere Möglichkeiten:

1. Ein AppBundle machen, das mehr oder weniger nur für diese Installation gilt.
2. Ein Vendor Bundle machen.
3. Eine klassische Contao 3 Extension.

Im Fall von 1. brauchst du keine Änderung in der composer.json, zumindest nicht in der standard-edition. Hier legst du dein Bundle einfach im src/ Ordner ab.

Im zweiten Fall brauchst du die Vorgehensweise wie von extra beschrieben. Allerdings liegt dein Code dann irgendwo außerhalb der Contao Installation und wird nur von Composer dann hinein gesymlinked.

Im dritten Fall gibst du die Extension in den /system/modules Ordner, entweder per Symlink oder direkt (kann man auch wie bei 2. machen).

[Schlauchbeutelmaschine]

Danke für die Erklärungen, ich nutze ja die Managed-Edition von daher wäre die Frage ob es dort gleich ist?

[Spooky]

Ist das eine Extension, die du planst in mehreren Contao Installationen einzusetzen, oder ist das nur für genau eine Contao Installation?

[Schlauchbeutelmaschine]

Ist nur für eine Installation gedacht.

[Spooky]

Dann mach es einfach so wie hier beschrieben: https://docs.contao.org/books/extend...g-an-appbundle (falls du mit der Managed Edition arbeitest).

[Schlauchbeutelmaschine]

Das hatte ich auch schon gesehen, allerdings gibt es den src Ordner nicht mehr in der ME oder?

[Spooky]

Du kannst ihn aber selbst anlegen