Grundlagen der Seitenpakete
Dieser Teil der Hilfe zu Seitenpaketen erklärt, wie ein Paket aufgebaut ist und wie Exponential es liest. Er ist für Administratoren, die
Websites installieren und wissen wollen, was geschieht, und für Entwickler, die Pakete ändern oder schreiben. Jede Aussage auf diesen
Seiten wurde gegen den Kernel-Code von 6.0.15 (kernel/classes/ezpackage.php und die Klassen darum herum), settings/package.ini, die
Paketquellen und den laufenden Paketserver geprüft.
Wenn Sie nur eine Website installieren wollen, brauchen Sie nichts davon: Der Setup-Assistent, der Kickstarter und exp:install erledigen
das für Sie (siehe Eine Installationsmethode wählen). Lesen Sie weiter, wenn eine
Installation scheitert, wenn Sie ändern wollen, was eine neue Website enthält, oder wenn Sie ein Paket bauen.
Inhalt
- Die Seiten dieses Teils
- Reihenfolge zum Lesen
- Die Grundlagen in zehn Zeilen
- Wo der Code liegt
- Verwandte Seiten
Die Seiten dieses Teils
| Seite | Was sie beantwortet |
|---|---|
| Was ein Seiteninstallationspaket ist | Was ein Seitenpaket ist, was es mitbringt und wie es sich von den Paketen unterscheidet, die es verlangt |
| Die Datei .ezpkg | Das Archiv: sein Aufbau, die Prüfungen beim Hochladen und Importieren und wie Sie eines von Hand öffnen |
| Referenz zu package.xml | Jedes Element und Attribut von package.xml, wie eZPackage es liest und schreibt |
| Pakettypen | site, sitestyle, contentclass, contentobject, extension: TypeList und die Typen, die der Index tatsächlich nutzt |
| Installationselemente und Handler | Elemente in <install>, HandlerAlias und was jeder Pakethandler tut |
| Abhängigkeiten und die Installationsreihenfolge | <requires>, min-version und die Reihenfolge, in der Dinge abgerufen und installiert werden |
| Installationsskripte in einem Seitenpaket | <settings><settings-file> und die Funktionen, die der Installer aufruft |
| Wie der Setup-Assistent Pakete nutzt | Die Schritte für Seitentypen, Sprachoptionen der Pakete und das Anlegen der Websites |
| Wie der Kickstarter und die Konsole Pakete nutzen | kickstart.ini [site_types] Site_package und exp:install --package |
| Das lokale Paket-Repository | var/storage/packages/, die Herstellerordner, local, .cache und eine Offline-index.xml |
| Klassische und JSON-Pakete | Die zwei Speicherformate eines Pakets |
| Importieren oder installieren | install_type und was Importieren, Installieren, Deinstallieren und Entfernen bedeuten |
Reihenfolge zum Lesen
- Neu bei Paketen: Beginnen Sie mit Was ein Seiteninstallationspaket ist, dann Die Datei .ezpkg und Importieren oder installieren.
- Eine Installation ist beim Abrufen von Paketen gescheitert: Wie der Setup-Assistent Pakete nutzt, dann Wenn der Paketserver nicht erreichbar ist.
- Sie schreiben oder ändern ein Paket: Referenz zu package.xml, Installationselemente und Handler, Abhängigkeiten und die Installationsreihenfolge und Installationsskripte in einem Seitenpaket, dann die Anforderungen an die Dokumentation.
Die Grundlagen in zehn Zeilen
- Ein Paket ist ein Verzeichnis mit einer Definitionsdatei (
package.xmloderpackage.jsonim JSON-Format) und den Dateien, die sie nennt. - Als eine Datei ausgeliefert, ist ein Paket ein mit gzip komprimiertes tar-Archiv mit der Endung
.ezpkg. - Jedes Paket hat einen Typ (
<type value="..."/>); ein Seitenpaket hat den Typsite. - Ein Seitenpaket verlangt andere Pakete (
<require type="ezpackage" name="..." min-version="..."/>): Inhaltsklassen, Inhalte, Erweiterungen, Seitenstile. - Ein Seitenpaket kann Installationsskripte mitbringen (
<settings><settings-file filename="..."/>), die Siteaccesses, Einstellungen, Rollen und Voreinstellungen einrichten. - Die Pakete, die es verlangt, bringen Installationselemente mit (
<install><item type="..."/>), jedes von einem Pakethandler behandelt, der insettings/package.ini [PackageSettings] HandlerAlias[]genannt ist. - Importieren legt ein Paket ins lokale Repository,
var/storage/packages/<vendor>/<name>/; auf der Website ändert sich nichts. - Installieren führt die Installationselemente aus. Pakete mit
install_type="import"(jedes Seitenpaket des Index von 6.0.15) haben selbst nichts zu installieren. - Der Setup-Assistent, der Kickstarter und
exp:installführen alle dieselben Schritte auskernel/setup/steps/ezstep_data.phpaus: Sie finden das Seitenpaket, importieren es und seine Anforderungen, installieren die Anforderungen und rufen die Installationsskripte auf. - Pakete kommen vom Paketserver, dessen Adresse
settings/package.ini [RepositorySettings] RemotePackagesIndexURList; siehe Der Paketserver.
Wo der Code liegt
| Was | Wo |
|---|---|
| Das Paketmodell: lesen, schreiben, importieren, installieren, deinstallieren | kernel/classes/ezpackage.php (eZPackage) |
| Prüfungen des Archivs, bevor irgendetwas geschrieben wird | kernel/classes/ezpackageuploadinspector.php |
Versionsvergleich (min-version) | kernel/classes/ezpackageversion.php |
| Handler für Installationselemente | kernel/classes/packagehandlers/*/ |
| Assistenten zum Erstellen von Paketen | kernel/classes/packagecreators/*/ |
| Schritt-Installer der Administration | kernel/classes/packageinstallers/*/ |
| Die Paketansichten der Administration | kernel/package/ (Einstiegspunkte), kernel/private/classes/views/package/ |
| Die Setup-Schritte, die Pakete nutzen | kernel/setup/steps/ezstep_site_types.php, ezstep_package_language_options.php, ezstep_create_sites.php |
| Der Paketmanager für die Kommandozeile | ezpm.php im Wurzelverzeichnis der Installation, Code in kernel/private/classes/commands/ezpm.php |
| Einstellungen | settings/package.ini |
Verwandte Seiten
- Seitenpakete: hier beginnen
- Glossar
- Ihr Seitenpaket beitragen: 7x und die Exponential Foundation ermutigen Sie ausdrücklich, Ihre eigenen Seitenpakete beim gemeinsamen Paketserver einzureichen.
- Anleitung zu Paketen: Setup > Pakete in der Administration
- Was ein Exponential-Paket ist: die Sicht des Designers
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.