Ihre erste Erweiterung
Diese Seite richtet sich an Anwendungsentwickler, die schnell eine laufende Erweiterung möchten. Sie bauen expdemo,
eine Erweiterung mit einem Modul, einer Ansicht, die die neuesten Artikel auflistet, einer Richtlinienfunktion und einem
Template. Sie können sie von Setup > RAD schreiben lassen (RAD-Werkzeuge) oder wie unten selbst
eintippen; beides führt zum selben Ergebnis.
Inhalt
Die Dateien
extension/expdemo/
├── extension.xml
├── ezinfo.php
├── modules/expdemo/module.php
├── modules/expdemo/latest.php
├── design/standard/templates/expdemo/latest.tpl
└── settings/module.ini.append.phpsettings/module.ini.append.php teilt dem Kernel mit, dass die Erweiterung Module hat:
[ModuleSettings]
ExtensionRepositories[]=expdemo
ModuleList[]=expdemo
*/ ?>modules/expdemo/module.php deklariert das Modul, seine Ansicht und seine Richtlinienfunktion:
$Module = array( 'name' => 'Demo' );
$ViewList = array();
$ViewList['latest'] = array(
'script' => 'latest.php',
'functions' => array( 'read' ),
'default_navigation_part' => 'ezcontentnavigationpart',
'params' => array( 'Limit' ) );
$FunctionList = array();
$FunctionList['read'] = array();modules/expdemo/latest.php ist die Ansicht; sie ruft Inhalte ab und rendert ein Template:
/** @var array $Params set by eZModule */
$limit = isset( $Params['Limit'] ) ? max( 1, min( 50, (int)$Params['Limit'] ) ) : 10;
$nodes = eZContentObjectTreeNode::subTreeByNodeID(
array( 'ClassFilterType' => 'include',
'ClassFilterArray' => array( 'article' ),
'SortBy' => array( 'published', false ),
'Limit' => $limit ),
(int)eZINI::instance( 'content.ini' )->variable( 'NodeSettings', 'RootNode' ) );
$tpl = eZTemplate::factory();
$tpl->setVariable( 'nodes', $nodes ?: array() );
$Result = array();
$Result['content'] = $tpl->fetch( 'design:expdemo/latest.tpl' );
$Result['path'] = array( array( 'text' => 'Latest articles', 'url' => false ) );subTreeByNodeID() prüft content/read für den aktuellen Benutzer, sodass die Liste nur zeigt, was der Benutzer lesen
darf.
design/standard/templates/expdemo/latest.tpl:
<h1>{'Latest articles'|i18n( 'extension/expdemo' )}</h1>
<ul>
{foreach $nodes as $node}
<li><a href={$node.url_alias|ezurl}>{$node.name|wash}</a></li>
{/foreach}
</ul>ezinfo.php und extension.xml beschreiben die Erweiterung für die Seite „Über“
(Aufbau einer Erweiterung).
Aktivieren und registrieren
# settings/override/site.ini.append.php
[ExtensionSettings]
ActiveExtensions[]=expdemophp bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-tag=ini --allow-root-user
php bin/php/ezcache.php --clear-id=design_base,template-override --allow-root-userUnter Velocity: php bin/php/console exp:velocity deploy.
Eine Rolle vergeben
Fügen Sie unter Benutzer > Rollen der Rolle, die die Seite sehen soll, die Richtlinie expdemo / read hinzu
(Anonymous für eine öffentliche Seite). Ohne sie antwortet die Ansicht mit „Zugriff verweigert“: Die Richtlinie des
Moduls wird geprüft, bevor das Skript läuft.
Prüfen
Öffnen Sie /expdemo/latest/5 auf der Website. Erwartet: eine Überschrift und fünf Links. Dann /expdemo/latest/abc:
Die Umwandlung in int macht daraus 1, niemals einen Fehler. Abgemeldet ohne die Richtlinie: Zugriff verweigert.
Was Sie gelernt haben
| Bestandteil | Lektion |
|---|---|
module.ini.append.php | die Module einer Erweiterung werden über Einstellungen registriert |
module.php | Ansichten, Parameter und Richtlinienfunktionen werden deklariert, nicht programmiert |
| die Ansicht | $Params hinein, $Result heraus; das HTML machen Templates |
| die Richtlinie | der Zugriff wird vom Kernel vor Ihrem Code geprüft |
| das Template | |wash auf allem, was Sie ausgeben |
Als Nächstes: Eigene Module und Ansichten und die klassenbasierte Form von Ansichten (Befehle, Cronjob-Teile und Modulansichten als Klassen).
Verwandte Seiten
- Aufbau einer Erweiterung
- Referenz der Moduldefinition
- RAD-Werkzeuge
- 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.