Eigene Module und Ansichten
Diese Seite ist für Anwendungsentwickler, die Exponential um Bildschirme ergänzen. Ein Modul ist der erste Teil
einer Adresse (/expdemo/...), eine Ansicht der zweite (/expdemo/latest/...). Die module.php des Moduls
deklariert seine Ansichten und Richtlinien; jede Ansicht ist ein Skript (oder eine Klasse), das ein Ergebnis
zurückgibt.
Inhalt
- Ein Modul registrieren
- Parameter
- Formulare verarbeiten: Aktionen
- Das Ergebnis
- Weiterleitungen und Fehler
- Die klassenbasierte Ansicht
- Eine Ansicht des Kernels überschreiben
Ein Modul registrieren
# extension/expdemo/settings/module.ini.append.php
[ModuleSettings]
ExtensionRepositories[]=expdemo
ModuleList[]=expdemo
*/ ?>Module liegen in extension/expdemo/modules/<module>/. Die vollständige Liste der Schlüssel von module.php steht in
der Referenz zu module.php.
Parameter
$ViewList['item'] = array(
'script' => 'item.php',
'functions' => array( 'read' ),
'params' => array( 'ItemID' ), // /expdemo/item/42
'unordered_params' => array( 'offset' => 'Offset' ) // /expdemo/item/42/(offset)/20
);In der Ansicht enthalten $Params['ItemID'] und $Params['Offset'] die Werte, als Zeichenketten aus der Adresse:
Wandeln und prüfen Sie sie vor der Verwendung ((int), Positivlisten)
(Eingabeprüfung und Escaping der Ausgabe).
Formulare verarbeiten: Aktionen
Deklarieren Sie die Schaltflächen eines Formulars als Aktionen:
$ViewList['edit'] = array(
'script' => 'edit.php',
'functions' => array( 'edit' ),
'params' => array( 'ItemID' ),
'single_post_actions' => array( 'StoreButton' => 'Store', 'CancelButton' => 'Cancel' ),
'post_action_parameters' => array( 'Store' => array( 'Title' => 'ItemTitle' ) ) );$Module = $Params['Module'];
if ( $Module->isCurrentAction( 'Cancel' ) )
return $Module->redirectTo( '/expdemo/list' );
if ( $Module->isCurrentAction( 'Store' ) && $Module->hasActionParameter( 'Title' ) )
{
$title = trim( (string)$Module->actionParameter( 'Title' ) );
// validate, store, then redirect (POST - redirect - GET)
}Formulare müssen mit dem Formular-Token senden, das ezformtoken automatisch in Formulare mit method="post" einfügt
(Formulare, CSRF-Schutz und HTTP-Eingaben).
Das Ergebnis
$tpl = eZTemplate::factory();
$tpl->setVariable( 'item', $item );
$Result = array(
'content' => $tpl->fetch( 'design:expdemo/item.tpl' ),
'path' => array( array( 'text' => 'Items', 'url' => 'expdemo/list' ),
array( 'text' => $item->attribute( 'title' ), 'url' => false ) ) );content kommt in das Pagelayout, aus path werden Brotkrumennavigation und Titel. Weitere Schlüssel und die Wahl des
Pagelayouts: Ergebnisse von Ansichten, Templates und das Pagelayout.
Weiterleitungen und Fehler
| Bedarf | Aufruf |
|---|---|
| Zu einer Adresse weiterleiten | return $Module->redirectTo( '/expdemo/list' ); |
| Zu einer anderen Ansicht des Moduls weiterleiten | $Module->redirectToView( 'list', array() ); |
| Nicht gefunden | return $Module->handleError( eZError::KERNEL_NOT_FOUND, 'kernel' ); |
| Zugriff verweigert | return $Module->handleError( eZError::KERNEL_ACCESS_DENIED, 'kernel' ); |
Weiterleitungsziele, die aus der Anfrage stammen, müssen geprüft werden; die Hilfsfunktionen des Kernels für sichere Weiterleitungen folgen nur Adressen der Website (Sichere Weiterleitungen).
Die klassenbasierte Ansicht
Neuer Code schreibt die Ansicht als Klasse, die Exponential\Runnable\ModuleView erweitert; die Ansichtsdatei wird zu
einer Zeile, die sie aufruft. Die Klasse lässt sich testen und per Einstellung durch eine andere Implementierung
ersetzen (Eine Modulansicht).
Eine Ansicht des Kernels überschreiben
Eine Erweiterung kann die Templates oder die Ansichten eines Kernel-Moduls überschreiben (Override von Modulen durch Erweiterungen). Fügen Sie lieber ein eigenes Modul hinzu; ein Override muss jedem Kernel-Update folgen.
Verwandte Seiten
- Ihre erste Erweiterung
- Richtlinienfunktionen und Einschränkungen
- Muster Modul und Ansicht
- 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.