ezinfo.php: was die Seite Über liest #

Jede Theme-Erweiterung sagt dem System in zwei kleinen Dateien, wer sie ist: ezinfo.php und extension.xml. Diese Seite behandelt die erste. Wenn Sie fertig sind, haben Sie eine ezinfo.php, die Name, Version, Lizenz und Website Ihres Themes unter Setup > Über (/ezinfo/about) und unter Setup > Extensions anzeigt.

Bevor Sie beginnen #

• Sie haben einen Ordner für die Theme-Erweiterung, zum Beispiel extension/mytheme/ (Die Ordnerstruktur einer Theme-Erweiterung).
• Sie kennen die Version, die Sie gleich veröffentlichen (Eine Versionsnummer wählen).

Schritt für Schritt #

1. Legen Sie extension/mytheme/ezinfo.php an. Der Klassenname ist der Ordnername gefolgt von Info, und info() ist static:

   <?php
   class mythemeInfo
   {
       public static function info()
       {
           return array(
               'Name'      => "My Theme",
               'Version'   => "1.0.0",
               'Copyright' => "Copyright (C) 2026 Your Name",
               'License'   => "GNU General Public License v2.0 (or any later version)",
               'Info_url'  => "https://github.com/<you>/mytheme",
           );
       }
   }

2. Füllen Sie jeden Schlüssel:

   Schlüssel	Was Sie schreiben	Beispiel eines echten Themes
   Name	Der lesbare Name des Themes	CJW Themes Jumper
   Version	Die Release-Version ohne v (Tag v0.1.6 ergibt 0.1.6)	0.1.6
   Copyright	Die Jahre und jeder Rechteinhaber, dessen Arbeit im Theme steckt	2007 - 2026 CJW Network, JAC Systeme GmbH and 7x
   License	Genau das, was Ihre Datei LICENSE sagt	GNU General Public License v2.0 (or any later version)
   Info_url	Die Projektseite des Themes, meist sein Repository	https://github.com/se7enxweb/cjw_themes_jumper
   Author (optional)	Wer es geschrieben hat	7x

   Die Beispiele sind aus extension/cjw_themes_jumper/ezinfo.php kopiert, wie es mit Release 0.1.6 ausgeliefert wird.

3. Schreiben Sie dieselbe Version, Lizenz und Website in extension.xml. Die Seite Über liest extension.xml zuerst, wenn sie einen Block <metadata> hat, also müssen die beiden Dateien übereinstimmen (Alle Versionsfelder synchron halten).

4. Prüfen Sie die Datei:

   php -l extension/mytheme/ezinfo.php

   Erwartet: No syntax errors detected in extension/mytheme/ezinfo.php.

5. Öffnen Sie Setup > Über in der Administration. Die Zeile Ihres Themes zeigt den Namen, die Version, die Lizenz und die Website, die Sie geschrieben haben. Ein Strich bedeutet, dass der Wert fehlt.

Regeln, die sich bewähren #

• Setzen Sie jeden Schlüssel in Anführungszeichen ('Version', nicht Version) und lassen Sie info() static.
• Schreiben Sie nie einen Platzhalter wie //autogentag// oder dev-master als Version. Die Seite Über und die Upgrade-Prüfung können einen Platzhalter nicht von einem echten Release unterscheiden.
• Erhöhen Sie die Version in dem Commit, auf den der Release-Tag zeigt, nie nach dem Tag (Die Version vor dem Tag erhöhen).
• Die Lizenzzeile muss zur Datei LICENSE passen. Steht das Theme unter der GPL, schreiben Sie den vollen Namen der Lizenz wie oben.

Verwandte Seiten #

• extension.xml: die paketierte Beschreibung
• Alle Versionsfelder synchron halten
• Copyright- und Autorenzeilen
• Spezifikation: Metadaten von Erweiterungen
• Theme-Erweiterungen: hier beginnen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.