Von Hand: die kleinste Erweiterung in fünf Minuten
Tutorial 9. Dies ist die kleinste nützliche Erweiterung: Sie hat Metadaten, damit die Administration weiß, was sie ist,
und eine Einstellung, damit sie etwas Sichtbares ändert. Jedes spätere Tutorial baut auf demselben Ordner auf,
extension/mysite_hello. Die Dateien unten haben php -l und xmllint bestanden.
1. Der Ordner
mkdir -p extension/mysite_hello/settings
cd extension/mysite_hello
git init2. ezinfo.php
class mysite_helloInfo
{
public static function info()
{
return array(
'Name' => "My Site Hello",
'Version' => "0.1.0",
'Copyright' => "Copyright (C) 2026 Your Organization",
'License' => "GNU General Public License v2.0 (or any later version)",
'Info_url' => "https://github.com/your-organization/mysite_hello"
);
}
}Die Klasse heißt wie der Ordner plus Info; die Schlüssel stehen in Anführungszeichen; info() ist statisch
(ezinfo.php).
3. extension.xml
<software>
<metadata>
<name>My Site Hello</name>
<version>0.1.0</version>
<copyright>Copyright (C) 2026 Your Organization</copyright>
<license>GNU General Public License v2.0 (or any later version)</license>
<info_url>https://github.com/your-organization/mysite_hello</info_url>
</metadata>
</software>4. Eine Einstellung
settings/site.ini.append.php:
/* #?ini charset="utf-8"?
[SiteSettings]
SiteName=Hello from mysite_hello
*/ 5. Prüfen
php -l ezinfo.php
php -l settings/site.ini.append.php
xmllint --noout extension.xml
cd ../..Erwartet: zwei Zeilen No syntax errors detected und keine Ausgabe von xmllint.
6. Einschalten
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' mysite_hello global
php bin/php/ezcache.php --clear-tag=ini7. Ansehen
Setup > Extensions: eine Karte „My Site Hello“, Version 0.1.0, Ihre Lizenz und Website.
Die Einstellung:
./console exp:ini where site.ini/SiteSettings/SiteNameführt Ihre Datei auf. Ob sie greift, hängt von der Reihenfolge ab: Eine spätere Datei (der globale Override oder eine Erweiterung, die vor Ihrer aufgeführt ist) kann
SiteNameebenfalls setzen; die letzte Zeile der Ausgabe nennt den wirksamen Wert. Siehe Geltungsbereiche von Einstellungen und ihre Rangfolge.
8. Committen
git -C extension/mysite_hello add ezinfo.php extension.xml settings/site.ini.append.php
git -C extension/mysite_hello commit -m "Added: The mysite_hello extension with its metadata and a site name"Rückgängig machen
./console exp:ini rem 'site.ini/ExtensionSettings/ActiveExtensions[]' mysite_hello global
php bin/php/ezcache.php --clear-tag=iniDie nächsten Tutorials lassen die Erweiterung aktiv und fügen einen Template-Operator, eine Fetch-Funktion, ein Modul und
mehr hinzu. Die Zeile SiteName war nur für diese Übung gedacht: Entfernen Sie sie, bevor Sie weitermachen.
Verwandte Seiten
- Zurück: Mit RAD: Handler und Kernel-Overrides
- Weiter: Von Hand: ein Template-Operator
- Der Verzeichnisaufbau einer Erweiterung
- 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.