Erweiterungen in einem Bundle hinzufügen und entfernen #

Diese Seite richtet sich an Bündler, die den Satz an Erweiterungen ändern, mit dem Exponential ausgeliefert wird. Das grundlegende Vorgehen steht unter Die Standardauswahl an Erweiterungen; diese Seite ergänzt, woran ein Bundle denken muss.

Inhalt #

1. Eine Erweiterung hinzufügen
2. Aktivieren
3. Eine weglassen
4. Ladereihenfolge
5. Eine Erweiterung als Paket aus einer Installation holen
6. Checkliste für jede Erweiterung, die Sie hinzufügen

Eine Erweiterung hinzufügen #

composer require se7enxweb/ezflow
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all

Quelle: Eine Erweiterung hinzufügen. Verwenden Sie das Paket und die Version, die Ihr Bundle wirklich braucht; das Beispiel ist das jener Seite.

Aktivieren #

Eine Erweiterung lässt sich an zwei Stellen aktivieren:

[ExtensionSettings]
ActiveExtensions[]=ezflow

settings/override/ wird vom Installer geschrieben und enthält danach die Zugangsdaten der Datenbank; ein Bundle, das Einstellungen mitbringt, muss sie als Teil des Seitenpakets liefern oder nach der Installation anwenden, nicht ein befülltes settings/override/ ausliefern (Sicherheitsvorgaben eines Bundles).

Eine weglassen #

1. Entfernen Sie sie aus ActiveExtensions und leeren Sie die Caches.
2. Führen Sie composer remove se7enxweb/<name> aus.

"Wenn Sie mit Git-Checkouts der Erweiterungen statt mit Composer installiert haben, führen Sie composer update nicht aus: Es ersetzt die Checkouts" (Eine weglassen).

Bevor Sie eine erforderliche Erweiterung weglassen, prüfen Sie, dass nichts anderes sie braucht: extension.xml nennt Abhängigkeiten in <requires> (Metadaten von Erweiterungen), und Seitenpakete aktivieren sie womöglich. Halten Sie den Grund in Ihren Release-Hinweisen fest; die Empfänger werden fragen.

Ladereihenfolge #

Die Reihenfolge von ActiveExtensions entscheidet, wessen Einstellungen und Templates gewinnen. Setup > Extensions zeigt standardmäßig die Ladereihenfolge und übernimmt Änderungen nach einer Prüfung (Liste der Erweiterungen, Die Seite Extensions). Platzieren Sie Ihr Theme und Ihre Override-Erweiterungen dort, wo sie gewinnen sollen, und testen Sie die Reihenfolge, die Sie ausliefern.

Eine Erweiterung als Paket aus einer Installation holen #

Unter Setup > Extensions lässt sich eine Erweiterung als tar.gz, .zip, tar.bz2 oder .ezpkg herunterladen, und ezpm.php add kann eine einpacken. Der Export "ist jetzt standardmäßig ausgeschaltet": Die Erweiterung muss in package.ini [ExtensionExportSettings] AllowedExtensions[] aufgeführt sein (oder *), und die Rolle braucht die Richtlinie package/export_extension. "Eine Erweiterung, die einen geheimen Wert oder Schlüsselmaterial enthält, wird nicht eingepackt" (Liste der Erweiterungen, Die Prüfung auf Geheimnisse). Bauen Sie ein Bundle lieber aus Ihren Repositorys, statt aus einer laufenden Website zu exportieren.

Checkliste für jede Erweiterung, die Sie hinzufügen #

• To do: Ihre Lizenz ist bekannt und erlaubt die Weitergabe neben GPL-Code (Komponenten Dritter).
• To do: Sie nennt Version, License, Copyright und Info_url in ezinfo.php und extension.xml, damit die Seite Info > Über sie korrekt anzeigt (Die Seiten Über und Copyright).
• To do: Sie läuft auf jeder PHP-Version, die Ihr Bundle unterstützt.
• To do: Sie ist festgelegt (Tag, Lock-Datei).
• To do: Sie wissen, wer sie pflegt und wohin ihre Fehlermeldungen gehen (Grenzen des Supports).
• To do: Sie enthält keine Geheimnisse, Schlüssel oder Kundendaten.

Verwandte Seiten #

• Exponential 6 als Basis
• Erweiterungs-Bundles
• Kapitel 10.13 Verwaltung von Erweiterungen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.