extension.xml: die paketierte Beschreibung #

Diese Seite ist für Designer, die ein Theme für ein Release vorbereiten. extension.xml ist die zweite Metadatendatei einer Erweiterung. Die Seite Über liest sie zuerst, wenn sie einen Block <metadata> hat; ein falscher Wert hier gewinnt also über einen richtigen in ezinfo.php.

Ein vollständiges Beispiel #

Dies ist die Datei von cjw_themes_jumper 0.1.6, wie veröffentlicht:

<?xml version="1.0" encoding="utf-8" ?>
<software>
    <metadata>
        <name>CJW Themes Jumper</name>
        <version>0.1.6</version>
        <copyright>Copyright (C) 2007 - 2026 CJW Network, JAC Systeme GmbH and 7x</copyright>
        <license>GNU General Public License v2.0 (or any later version)</license>
        <info_url>https://github.com/se7enxweb/cjw_themes_jumper</info_url>
    </metadata>
</software>

Schritt für Schritt #

1. Legen Sie extension/mytheme/extension.xml mit dem Wurzelelement <software> und einem Block <metadata> an.

2. Füllen Sie die Elemente:

   Element	Wert	Muss gleich sein mit
   <name>	Lesbarer Name	Name in ezinfo.php
   <version>	Release-Version ohne v	Version in ezinfo.php, dem Tag, version in composer.json, falls Sie eines führen
   <copyright>	Jahre und Rechteinhaber	Copyright in ezinfo.php
   <license>	Der volle Name der Lizenz	License in ezinfo.php und der Datei LICENSE
   <info_url>	Projektseite	Info_url in ezinfo.php

3. Braucht das Theme eine andere Erweiterung, fügen Sie einen Block <dependencies> hinzu (Abhängigkeiten in extension.xml deklarieren).

4. Prüfen Sie, dass das XML wohlgeformt ist:

   xmllint --noout extension/mytheme/extension.xml

   Erwartet: keine Ausgabe. Jede Ausgabe nennt die fehlerhafte Zeile.

5. Laden Sie Setup > Über und Setup > Extensions neu: Die Zeile zeigt die Werte dieser Datei.

Werte, die Sie nie schreiben #

• //autogentag// oder dev-master als Version: Das waren vor langer Zeit Platzhalter von Build-Skripten, und sie sagen einem Leser nichts.
• Einen Lizenznamen, der von der Datei LICENSE abweicht.
• Eine Website, die nicht Ihre ist, zum Beispiel die Website des Produkts für ein Theme, das das Produkt nicht pflegt.

Verwandte Seiten #

• ezinfo.php: was die Seite Über liest
• Alle Versionsfelder synchron halten
• Spezifikation: Metadaten von Erweiterungen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.