Projekt 8: Ihre erste Erweiterung
Mit Erweiterungen wird Exponential erweitert, ohne den Kernel zu ändern. In diesem Projekt bauen Sie die kleinste funktionierende Erweiterung, eine Seite, die Besucher mit Namen begrüßt, machen sie dann sicher und bewahren sie in Git auf. Die Schritte folgen Erweiterungen, Abschnitt 6.
Inhalt
Auf einen Blick
| Stufe | Fortgeschritten |
| Zeit | Etwa 4 Stunden |
| Pfade | Entwickler |
| Voraussetzungen | Grundkenntnisse in PHP; ein Terminal; Projekt 3; Git als Lernende nutzen |
Ziel
Eine Erweiterung mit Ihrem eigenen Namen (zum Beispiel studyhello), die /hello/world/<name> ausliefert, den Namen
maskiert innerhalb des Layouts Ihrer Website zeigt, unter Setup > Extensions mit ihrer Version aufgeführt ist, durch
eine Richtlinie geschützt ist und in einem eigenen Git-Repository liegt.
Bevor Sie beginnen
- Lesen Sie Erweiterungen, Abschnitte 1, 4 und 6.1, und Was eine Erweiterung ist.
- Wählen Sie einen Namen, der Ihnen gehört: kleingeschrieben, Buchstaben, Ziffern und Unterstriche. Die Anleitung
verwendet
myhello.
Aufgaben
Legen Sie die Ordner an:
extension/<name>/settings,modules/hellounddesign/standard/templates/hello.Schreiben Sie
ezinfo.phpundextension.xmlmit derselben Version (0.1.0), Ihrem Namen in der Copyright-Zeile und „GNU General Public License v2.0 (or any later version)“ als Lizenz.Schreiben Sie die Einstellungen:
settings/module.ini.append.phpmitExtensionRepositories[]=<name>unter[ModuleSettings]undsettings/design.ini.append.phpmitDesignExtensions[]=<name>unter[ExtensionSettings].Schreiben Sie das Modul und die View:
modules/hello/module.phpmit einer Viewworld, die den ParameterNameentgegennimmt, undmodules/hello/world.php, das den Namen an das Template übergibt und$Resultzurückgibt.Schreiben Sie das Template
design/standard/templates/hello/world.tpl, das den Namen mit{$name|wash}ausgibt.Prüfen Sie das PHP:
php -lfür jede PHP-Datei. Erwartet:No syntax errors detected in <file>.Schalten Sie sie ein und aktualisieren Sie:
php bin/php/console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' <name> global --allow-root-user php bin/php/ezpgenerateautoloads.php -e php bin/php/ezcache.php --clear-all --allow-root-userÖffnen Sie
/hello/world/Adaauf Ihrer Website. Erwartet: Hello, Ada innerhalb des Layouts Ihrer Website, und Setup > Extensions führt Ihre Erweiterung mit der Version 0.1.0 auf.Versuchen Sie, sie zu brechen. Öffnen Sie
/hello/world/<b>Ada</b>(bei Bedarf URL-kodiert). Der Name muss als Text angezeigt werden, nicht als fettes Markup. Erklären Sie, warum.Schützen Sie die View. Eine View ohne Eintrag
'functions'hat keine Zugriffskontrolle: Jeder, der die Website erreichen kann, kann sie öffnen. Deklarieren Sie eine Funktion ($FunctionList['read'] = array();inmodule.php,'functions' => array( 'read' )an der View) und vergeben Sie sie unter Benutzer > Rollen und Richtlinien an eine Rolle. Prüfen Sie als anonymer Besucher und als Benutzer mit der Rolle (Erweiterungen).Committen Sie die Erweiterung in ihr eigenes Git-Repository, mit einer Commit-Betreffzeile wie
Added: The hello world view.
Abgabe
- Das Repository (oder ein Archiv davon) mit jeder Datei der Erweiterung.
- Screenshots: die Begrüßungsseite; Setup > Extensions mit Ihrer Erweiterung; die verweigerte Seite für einen Besucher ohne die Richtlinie.
- Die Ausgabe von
php -lfür jede PHP-Datei. - Ein kurzer Bericht: was jede Datei tut und warum die Richtlinie wichtig ist.
Bewertungsraster
Bewerten Sie die vier gemeinsamen Kriterien aus Die eigene Arbeit bewerten und diese Prüfungen (8):
- Der Name der Erweiterung ist der eigene der lernenden Person, kleingeschrieben.
ezinfo.phpundextension.xmltragen dieselbe Version und die Lizenz.- Jede PHP-Datei besteht
php -l. - Die Erweiterung wurde mit einem Override der Einstellungen eingeschaltet, nicht durch Bearbeiten von
settings/site.ini. - Die Begrüßung funktioniert, und der Name ist maskiert.
- Die View ist durch eine Funktion und eine Richtlinie geschützt, gezeigt für beide Fälle.
- Die Erweiterung liegt in einem eigenen Git-Repository mit lesbaren Commit-Betreffzeilen.
- Keine Kernel-Datei wurde geändert.
Zusatzziele
- Erzeugen Sie mit dem RAD-Assistenten (
/setup/moduleextension) ein Modul und vergleichen Sie seine Dateien mit Ihren (Erweiterungen). Hinweis: Die Assistenten listen jede Datei vor dem Schreiben auf und überschreiben niemals eine vorhandene Erweiterung. - Fügen Sie eine eigene Einstellung in
settings/<name>.inihinzu und lesen Sie sie miteZINI::instance( '<name>.ini' )(Erweiterungen). - Fügen Sie eine Übersetzung der Begrüßung hinzu (Erweiterungen, Abschnitt 6.4).
- Veröffentlichen Sie sie auf GitHub als Ihr eigenes Projekt (Erweiterungen zurückgeben). Ihre eigene Erweiterung fällt nicht unter die CLA (Die CLA für Lernende).
Verwandte Seiten
- Lernprojekte: Überblick
- Erweiterungen
- Lernpfad: Entwickler
- 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.