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

Ihre erste Erweiterung

In fünfzehn Minuten eine funktionierende Erweiterung bauen - von Hand oder mit dem RAD-Modul-Assistenten - mit einem Modul, einer Ansicht, einer Richtlinienfunktion, einem Template und Einstellungen, sie dann…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/creators/app-creators/your-first-extension.md

On this page

This page is a translation. Read the English original

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

  1. Die Dateien
  2. Aktivieren und registrieren
  3. Eine Rolle vergeben
  4. Prüfen
  5. Was Sie gelernt haben

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.php

settings/module.ini.append.php teilt dem Kernel mit, dass die Erweiterung Module hat:

<?php /* #?ini charset="utf-8"?
[ModuleSettings]
ExtensionRepositories[]=expdemo
ModuleList[]=expdemo
*/ ?>

modules/expdemo/module.php deklariert das Modul, seine Ansicht und seine Richtlinienfunktion:

<?php
$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:

<?php
/** @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[]=expdemo
php 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-user

Unter 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

BestandteilLektion
module.ini.append.phpdie Module einer Erweiterung werden über Einstellungen registriert
module.phpAnsichten, Parameter und Richtlinienfunktionen werden deklariert, nicht programmiert
die Ansicht$Params hinein, $Result heraus; das HTML machen Templates
die Richtlinieder 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

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