Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Eigene Module und Ansichten

Die Bildschirme einer Anwendung als Modulansichten bauen - ein Modul registrieren, geordnete und ungeordnete Parameter, POST-Aktionen verarbeiten, ein Ergebnis zurückgeben, weiterleiten, Fehler und die klassenbasierte…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/creators/app-creators/custom-modules-and-views.md

On this page

This page is a translation. Read the English original

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

  1. Ein Modul registrieren
  2. Parameter
  3. Formulare verarbeiten: Aktionen
  4. Das Ergebnis
  5. Weiterleitungen und Fehler
  6. Die klassenbasierte Ansicht
  7. Eine Ansicht des Kernels überschreiben

Ein Modul registrieren

# extension/expdemo/settings/module.ini.append.php
<?php /* #?ini charset="utf-8"?
[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

BedarfAufruf
Zu einer Adresse weiterleitenreturn $Module->redirectTo( '/expdemo/list' );
Zu einer anderen Ansicht des Moduls weiterleiten$Module->redirectToView( 'list', array() );
Nicht gefundenreturn $Module->handleError( eZError::KERNEL_NOT_FOUND, 'kernel' );
Zugriff verweigertreturn $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

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x