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

Erweiterungspunkte

Lesen Sie diese Seite, wenn Sie Exponential mit eigenem Code erweitern und wissen möchten, wo jede Art von Erweiterung andockt, welche INI-Zeile sie registriert und welches Werkzeug unter Setup > RAD Ihnen hilft, sie zu…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/bc/6.0/rad-extension-points.md

On this page

This page is a translation. Read the English original

Erweiterungspunkte

Lesen Sie diese Seite, wenn Sie Exponential mit eigenem Code erweitern und wissen möchten, wo jede Art von Erweiterung andockt, welche INI-Zeile sie registriert und welches Werkzeug unter Setup > RAD Ihnen hilft, sie zu bauen. Exponential wird auf eine Handvoll sich wiederholender Arten erweitert: eine Klasse in einem Verzeichnis, das der Kernel durchsucht, eine Klasse, die eine INI-Einstellung nennt, eine Datei an einer Stelle, die per Konvention gefunden wird, oder ein Template in einem Design. Welche davon zutrifft und welche INI-Zeile sie registriert, ließ sich bisher nur durch Lesen des Kernels herausfinden.

Kurz gesagt

Was sich geändert hatkernel/setup/expradcatalogue.php (expRADCatalogue::points()) führt jeden Erweiterungspunkt auf, und Setup > RAD wird daraus erzeugt: 70 Erweiterungspunkte, 65 davon mit einem Werkzeug.
Wer betroffen istNiemand muss etwas ändern. Erweiterungsentwickler erhalten eine Stelle zum Nachschlagen.
Wie Sie es prüfenÖffnen Sie Setup > RAD (/setup/rad) in der Administration.
Wie Sie es behebenNichts zu beheben. Ziehen Sie einen registrierten Mechanismus einem Override einer Kernel-Klasse vor (siehe override unten).

Jeder Eintrag wurde gegen den Quelltext geprüft; die Spalte Kernel nennt die Datei, in der der Mechanismus liegt.

Wie Dinge registriert werden

  • directory — Eine Klasse in einem Verzeichnis, das der Kernel durchsucht. Das Verzeichnis nennt eine Einstellung RepositoryDirectories, und die Klasse wird über ihren Dateinamen gefunden.
  • handler — Eine Klasse, die eine INI-Einstellung nennt und die über eZExtension::getHandlerClass geladen wird. Die Einstellung gibt einen Alias, der Alias gibt die Klasse.
  • autoload — Eine Klasse, die über den Autoload-Pfad der Erweiterungen erreicht wird, einmal in einer INI-Datei registriert und dann überall verfügbar.
  • file — Eine Datei an einer Stelle, an der der Kernel nach Namen sucht. Nichts registriert sie; dort zu liegen ist die Registrierung.
  • design — Ein Template in einem Design, gefunden über die Design-Kette statt dadurch, dass es irgendwo genannt wird.
  • ini — Nur Einstellungen. Es wird nichts außer INI geschrieben, und das Verhalten ändert sich.
  • override — Eine Kernel-Klasse, die über den Override-Autoload-Pfad durch eine eigene ersetzt wird. Der schwerste dieser Mechanismen und der letzte Ausweg: Nichts registriert den Ersatz namentlich, sodass zwei Erweiterungen, die dieselbe Klasse ersetzen, einen Kampf führen, von dem keine von beiden weiß.
  • registry — Ein Eintrag einer Registry, die rad.ini deklariert: Der Kernel oder eine Erweiterung sagt, welche INI-Blöcke oder welche Klassenliste die Einträge enthalten und was jeder sein muss, und die Übersicht der Erweiterungspunkte zählt und prüft jeden Eintrag, ohne dass der Kernel die Erweiterung nennt.
  • filter — Ein Listener eines Filter-Ereignisses in site.ini [Event] Listeners[]. Der Kernel übergibt einen Wert und macht mit dem weiter, was der Listener zurückgibt; ein Listener, der vergisst, ihn zurückzugeben, zerstört also den Wert.

Inhalte

Woraus Inhalte bestehen und wie sie bearbeitet und gespeichert werden.

Datentyp

Werkzeug: /setup/datatype

Eine Art von Wert, die ein Attribut einer Inhaltsklasse halten kann, mit eigener Bearbeitung, Validierung, Speicherung und Anzeige.

Codeextension/<name>/datatypes/<datatype>/<datatype>type.php
Registriert durchcontent.ini [DataTypeSettings] ExtensionDirectories[] und AvailableDataTypes[], dazu design.ini [ExtensionSettings] DesignExtensions[], sonst zeichnet er nichts
Vertragextends eZDataType
Mechanismusdirectory
Kernelkernel/classes/ezdatatype.php

Inhaltsklasse

Werkzeug: /setup/contentextension

Ein Inhaltstyp: seine Attribute, deren Datentypen und wie eine Instanz davon benannt wird.

Codeextension/<name>/share/package/<name>/ezcontentclass/
Registriert durchAls Paket installiert oder in der Administrationsoberfläche angelegt und exportiert.
VertrageZContentClass-Definition, als Klassenpaket
Mechanismusfile
Kernelkernel/classes/ezcontentclass.php

XML-Custom-Tag

Werkzeug: /setup/contentextension

Ein Tag, den Autoren in Rich Text verwenden können, mit eigenen Attributen und eigenem Template.

Codeextension/<name>/design/standard/templates/content/datatype/view/ezxmltags/<tag>.tpl
Registriert durchcontent.ini [CustomTagSettings] AvailableCustomTags[] und ein Abschnitt [<tag>]
VertragEin Template, dazu INI, die die Attribute beschreibt
Mechanismusdesign
Kernelsettings/content.ini

Eingabe-Handler für XML-Text

Werkzeug: /setup/handlerextension/xmlinput

Was das, was ein Autor eingegeben hat, in das XML verwandelt, das ein Rich-Text-Attribut speichert.

Codeextension/<name>/classes/<name>xmlinput.php
Registriert durchezxml.ini [InputSettings] HandlerClass
Vertragextends eZXMLInputHandler
Mechanismushandler
Kernelkernel/classes/datatypes/ezxmltext/ezxmltext.php

Ausgabe-Handler für XML-Text

Werkzeug: /setup/handlerextension/xmloutput

Was gespeicherten Rich Text in das verwandelt, was ein Besucher sieht.

Codeextension/<name>/classes/<name>xmloutput.php
Registriert durchezxml.ini [OutputSettings] HandlerClass
Vertragextends eZXMLOutputHandler
Mechanismushandler
Kernelkernel/classes/datatypes/ezxmltext/ezxmltext.php

Verhalten der Informationssammlung

Werkzeug: /setup/settingsextension

Was geschieht, wenn ein Besucher ein aus Inhalten gebautes Formular ausfüllt: wie die Einsendung heißt, ob sie aufbewahrt wird, ob sie per E-Mail verschickt wird und was dem Besucher danach gezeigt wird. Pro Inhaltsklasse zugeordnet, sodass sich eine Umfrage und ein Kontaktformular, die gleich gebaut sind, unterschiedlich verhalten.

Codesettings/override/collect.ini.append.php und Templates unter content/collectedinfo/
Registriert durchcollect.ini [InfoSettings] TypeList[<class>], [EmailSettings] SendEmailList[<class>], [CollectionSettings] CollectAnonymousDataList[<class>], [DisplaySettings] DisplayList[<class>]
VertragKeine Klasse zu schreiben: eine Einstellung pro Inhaltsklasse und ein Template pro Typ
Mechanismusini
Kernelkernel/classes/ezinformationcollection.php

Regeln für das Leeren des View-Caches

Werkzeug: /setup/settingsextension

Welche anderen Seiten neu gebaut werden müssen, wenn ein Objekt veröffentlicht wird. Der Standard leert das Objekt, seine Elternknoten und das, was sich darauf bezieht; eine Gruppe, die nach der Kennung einer Inhaltsklasse benannt ist, sagt, was sonst noch - eine Liste, die sich ändern muss, wenn ein Kommentar veröffentlicht wird, ein Objekt an einer ganz anderen Stelle.

Codesettings/override/viewcache.ini.append.php
Registriert durchviewcache.ini [ViewCacheSettings] SmartCacheClear=enabled, dann eine Gruppe [<class_identifier>] mit ClearCacheMethod[], DependentClassIdentifier[] und AdditionalObjectIDs[]
VertragKeine Klasse zu schreiben: eine Gruppe pro Kennung einer Inhaltsklasse
Mechanismusini
Kernelkernel/classes/ezcontentcachemanager.php

Filter für das asynchrone Veröffentlichen

Werkzeug: /setup/handlerextension/publishfilter

Entscheidet, ob eine Version in der Anfrage veröffentlicht oder an die Warteschlange übergeben wird. Das Veröffentlichen eines großen Objekts blockiert den, der die Schaltfläche gedrückt hat; eine Warteschlange, die alles nimmt, lässt kleine Änderungen kaputt wirken. Hier wird diese Grenze gezogen.

Codeextension/<name>/classes/<name>publishfilter.php
Registriert durchcontent.ini [PublishingSettings] AsynchronousPublishingFilters[]
VertragImplementiert ezpAsynchronousPublishingFilterInterface: eine Methode accept()
Mechanismushandler
Kernelkernel/private/interfaces/asynchronouspublishingfilter.php

Templates und Design

Was ein Template aufrufen kann und was ein Design ersetzen kann.

Template-Operator

Werkzeug: /setup/templateoperator

Etwas, durch das ein Template einen Wert leiten kann: {$value|my_operator()}. Eine Klasse kann auf viele Namen antworten, und was sie dem Compiler verspricht, entscheidet, ob sie einmal beim Kompilieren oder für immer bei jeder Anfrage läuft.

Codeextension/<name>/autoloads/<name>operators.php
Registriert durchsite.ini [TemplateSettings] ExtensionAutoloadPath[], über $eZTemplateOperatorArray in autoloads/eztemplateautoload.php - keine INI, die die Klasse nennt
VertragoperatorList(), namedParameterList(), operatorTemplateHints() und modify()
Mechanismusautoload
Kernellib/eztemplate/classes/eztemplate.php

Template-Fetch-Funktion

Werkzeug: /setup/templateoperator

Etwas, das ein Template bei einem Modul erfragen kann: fetch( 'module', 'thing', hash( ... ) ).

Codeextension/<name>/modules/<module>/function_definition.php
Registriert durchIm Modulverzeichnis zu liegen ist die Registrierung.
VertragEine $FunctionList, die pro Funktion eine Klasse und eine Methode nennt
Mechanismusfile
Kernellib/ezutils/classes/ezfunctionhandler.php

Attribut-Operator

Werkzeug: /setup/handlerextension/attributeoperator

Ein Operator, der für ein Inhaltsattribut eines bestimmten Datentyps gilt.

Codeextension/<name>/classes/<name>attributeoperator.php
Registriert durchtemplate.ini [AttributeOperator] OutputFormatter[<format>]
VertragImplementiert ezpAttributeOperatorFormatterInterface
Mechanismushandler
Kernelkernel/private/eztemplate/ezpattributeoperatorformatterinterface.php

Template-Funktion

Werkzeug: /setup/templateoperator

Etwas, das ein Template aufruft, statt einen Wert hindurchzuleiten: {my_function arg=1}, wahlweise mit einem Rumpf, den sie keinmal, einmal oder viele Male zeichnen kann. So sind {section} und {foreach} gebaut.

Codeextension/<name>/autoloads/<name>functions.php
Registriert durchsite.ini [TemplateSettings] ExtensionAutoloadPath[], über $eZTemplateFunctionArray in autoloads/eztemplateautoload.php
VertragfunctionList(), attributeList(), hasChildren() und process()
Mechanismusautoload
Kernellib/eztemplate/classes/eztemplatesectionfunction.php

Fetch-Alias

Werkzeug: /setup/templateoperator

Ein Name für einen Fetch, der an anderer Stelle vollständig ausgeschrieben ist, damit Templates kurz bleiben können.

Codeextension/<name>/settings/fetchalias.ini.append.php
Registriert durchfetchalias.ini, ein Abschnitt pro Alias
VertragNur Einstellungen
Mechanismusini
Kernelsettings/fetchalias.ini

Design-Erweiterung

Werkzeug: /setup/designextension

Die Templates, Stylesheets und Bilder, mit denen eine Website gezeichnet wird.

Codeextension/<name>/design/<name>/
Registriert durchdesign.ini [ExtensionSettings] DesignExtensions[]
VertragTemplates, gefunden über die Design-Kette
Mechanismusdesign
Kernelkernel/common/eztemplatedesignresource.php

Satz von Template-Overrides

Werkzeug: /setup/designextension

Ein Template, das an Stelle eines anderen verwendet wird, für die Inhalte, auf die es passt, und für nichts sonst.

Codeextension/<name>/design/<design>/override/templates/
Registriert durchoverride.ini, ein Abschnitt pro Override
VertragZeilen Source, MatchFile, Subdir und Match
Mechanismusdesign
Kernelkernel/common/eztemplatedesignresource.php

Icon-Theme in einer Erweiterung

Werkzeug: /setup/settingsextension

Ein Satz von Icons, den eine Erweiterung mitbringt und der vor den ausgelieferten durchsucht wird. Die ganze Kette hat einen Rückfall: das aktuelle Theme, dann alle zusätzlichen Themes, dann das Standard-Theme; und innerhalb jedes Themes Verzeichnisse von Erweiterungen vor share/icons. Ein fehlendes Icon nimmt den Standard des Themes, statt ein kaputtes Bild zu zeichnen.

Codeextension/<name>/icons/<theme>/
Registriert durchicon.ini [ExtensionSettings] IconExtensions[] und [IconSettings] Theme oder AdditionalThemeList[]
VertragBilddateien, benannt nach dem, was sie darstellen. Als statische Dateien ausgeliefert, daher läuft pro Bild kein PHP
Mechanismusini
Kernelkernel/common/ezwordtoimageoperator.php

Module und Views

Adressen, unter denen die Website antwortet, und wer sie erreichen darf.

Modul über vorhandenen Tabellen

Werkzeug: /setup/moduleextension

Eine Administration und eine Template-API für Tabellen, die es bereits gibt, hier oder in einer anderen Datenbank.

Codeextension/<name>/modules/<module>/ und classes/
Registriert durchmodule.ini [ModuleSettings] ExtensionRepositories[] und ModuleList[]
VertrageZPersistentObject oder eine Klasse mit denselben Methoden
Mechanismusdirectory
Kernelkernel/classes/ezpersistentobject.php

Modul

Werkzeug: /setup/modulewizard

Eine neue Adresse, unter der die Website antwortet, mit eigenen Views und eigenen Richtlinien.

Codeextension/<name>/modules/<module>/module.php
Registriert durchmodule.ini [ModuleSettings] ExtensionRepositories[] und ModuleList[]
Vertrag$Module, $ViewList und $FunctionList
Mechanismusdirectory
Kernellib/ezutils/classes/ezmodule.php

View für ein vorhandenes Modul

Werkzeug: /setup/modulewizard

Eine weitere Sache, um die ein vorhandenes Modul gebeten werden kann.

Codeextension/<name>/modules/<module>/<view>.php
Registriert durchDie eigene module.php des Moduls, von der Erweiterung erweitert
VertragEin Skript, das $Result setzt
Mechanismusfile
Kernellib/ezutils/classes/ezmodule.php

Richtlinienfunktion und Einschränkung

Werkzeug: /setup/modulewizard

Etwas, das einer Rolle gewährt werden kann, und wodurch es eingeschränkt werden kann.

Codeextension/<name>/modules/<module>/function_definition.php
Registriert durchDie $FunctionList des Moduls
VertragNamen und eine Beschreibung der Einschränkungen pro Funktion
Mechanismusfile
Kernelkernel/classes/ezrole.php

Einschränkung für Inhaltsrichtlinien

Werkzeug: /setup/settingsextension (wählen Sie das Ereignis module/functionlist: Es schreibt den Listener und einen funktionierenden Handler)

Eine eigene Einschränkung für eine Inhaltsfunktion wie content/read, neben Class, Section und Subtree: Eine Erweiterung fügt sie der Funktion hinzu, und ihr Handler entscheidet für Objekte, Knoten und Versionen und liefert die SQL-Bedingung für Fetches von Listen und Bäumen. Ohne Handler verweigert die Einschränkung überall. Siehe Einschränkungen für Inhaltsrichtlinien von Erweiterungen.

Codeextension/<name>/classes/<class>.php, z. B. class myExtLimitationHandler implements ezpContentLimitationHandler; der Assistent für Einstellungserweiterungen schreibt einen funktionierenden (MaxDepth) mit einem Listener von module/functionlist
Registriert durchsite.ini [RoleSettings] LimitationHandlers[<limitation>]=<class>; die Einschränkung wird einer Funktion über den Filter module/functionlist ([Event] Listeners[]) hinzugefügt
Vertragimplements ezpContentLimitationHandler (checkAccess() für Objekte, Knoten und Versionen, permissionSQL() für Fetches); ezpContentLimitationSolrHandler fügt solrFilter() für Suchen hinzu, die selbst nach den Richtlinien filtern (eZ Find)
Mechanismushandler
Kernelkernel/private/classes/ezpcontentlimitation.php

REST-Provider

Werkzeug: /setup/handlerextension/restprovider

Ein Satz von Adressen, die außerhalb des Template-Systems antworten, damit etwas anderes sie aufrufen kann.

Codeextension/<name>/classes/rest/<name>provider.php
Registriert durchrest.ini, über die Registry der REST-Provider
VertragImplementiert ezpRestProviderInterface
Mechanismushandler
Kernelkernel/private/rest/classes/rest_provider.php

REST-Routenfilter

Werkzeug: /setup/handlerextension/restroutefilter

Etwas, das eine REST-Anfrage untersucht oder ändert, bevor sie geroutet wird.

Codeextension/<name>/classes/rest/<name>routefilter.php
Registriert durchrest.ini [RouteSettings] RouteSettingImpl
VertragErweitert ezpRestRouteFilterInterface
Mechanismushandler
Kernelkernel/private/rest/classes/interfaces/route_filter.php

Serverseitige Ajax-Funktion

Werkzeug: /setup/handlerextension/ajaxfunction

Etwas, das der Browser aufrufen kann und von dem er JSON zurückbekommt, ohne eine Seite.

Codeextension/<name>/classes/ezjscserverfunctions<name>.php
Registriert durchezjscore.ini [ezjscServer] FunctionList[]
VertragStatische Methoden, die eine Argumentliste nehmen
Mechanismushandler
Kernelextension/ezjscore

In rad.ini deklarierte Registry

Werkzeug: /setup/radsurvey/(show)/registries

Eine Liste von Implementierungen, die eine Erweiterung aus ihren eigenen Einstellungen oder aus ihrem eigenen Code liest, etwa KI-Provider und -Werkzeuge, MCP-Werkzeuge oder Typen von Warteschlangen-Jobs. In rad.ini deklariert, wird sie von der Übersicht der Erweiterungspunkte gezählt und geprüft wie die eigenen Registries des Kernels: Jeder Eintrag wird aufgeführt, und einer, dessen Klasse, Methode, Template oder Block fehlt, wird als defekt angezeigt. Wie Sie eine deklarieren: Die Erweiterungsoberfläche.

Codeextension/<name>/settings/rad.ini.append.php
Registriert durchrad.ini [RegistrySettings] Registries[]=<key> und [Registry_<key>] mit Title, Ini, Section und Entries[<variable>]=<check>, oder List=<class>::<constant or method>
VertragJeder Eintrag besteht seine Prüfung: eine Klasse oder Schnittstelle, callable, listener, template, section:<prefix>, in:<class>::<list>, one-of:<words> oder name
Mechanismusregistry
Kernelkernel/setup/expradsurvey.php

Workflow, Ereignisse und Jobs

Was geschieht, wenn etwas veröffentlicht wird, und was von selbst läuft.

Workflow-Ereignistyp

Werkzeug: /setup/workflowevent

Ein Schritt, den ein Workflow ausführen kann, wenn etwas veröffentlicht, verschoben oder entfernt wird.

Codeextension/<name>/eventtypes/event/<event>/<event>type.php
Registriert durchworkflow.ini [EventSettings] ExtensionDirectories[] und AvailableEventTypes[]
Vertragextends eZWorkflowEventType
Mechanismusdirectory
Kernelkernel/classes/ezworkfloweventtype.php

Trigger

Werkzeug: /setup/settingsextension

Die Stelle in einer Operation, an der ein Workflow die Gelegenheit zu laufen erhält.

Codeextension/<name>/settings/workflow.ini.append.php
Registriert durchworkflow.ini und die Definition der Operation, die den Trigger deklariert
VertragEinstellungen und ein Rumpf der Operation mit einem Trigger darin
Mechanismusini
Kernelkernel/classes/eztrigger.php

Typ von Benachrichtigungsereignissen

Werkzeug: /setup/handlerextension/notificationtype

Eine Art von Sache, über die Personen benachrichtigt werden können.

Codeextension/<name>/notification/event/<type>/<type>type.php
Registriert durchnotification.ini [NotificationEventTypeSettings] RepositoryDirectories[] und AvailableNotificationEventTypes[]
Vertragextends eZNotificationEventType
Mechanismusdirectory
Kernelkernel/classes/notification/eznotificationeventtype.php

Benachrichtigungs-Handler

Werkzeug: /setup/handlerextension/notificationhandler

Was entscheidet, wer benachrichtigt wird und wie.

Codeextension/<name>/notification/handler/<handler>/<handler>handler.php
Registriert durchnotification.ini [NotificationEventHandlerSettings] ExtensionDirectories[] und AvailableNotificationEventTypes[] (der Kernel liest auch die Variable Types im Abschnitt des Handlers)
Vertragextends eZNotificationEventHandler
Mechanismusdirectory
Kernelkernel/classes/notification/eznotificationeventhandler.php

Cronjob-Skript und -Teil

Werkzeug: /setup/cronjobs

Etwas, das von selbst nach einem Zeitplan läuft, außerhalb jeder Anfrage.

Codeextension/<name>/cronjobs/<script>.php
Registriert durchcronjob.ini [CronjobSettings] ExtensionDirectories[] und Scripts[] oder ein eigener Teil
VertragEin von runcronjobs.php ausgeführtes Skript, mit $cli und $sys verfügbar
Mechanismusdirectory
Kernelruncronjobs.php

Ausgelassener Cronjob-Teil

Werkzeug: keines (der Assistent für Einstellungserweiterungen schreibt [Event] Listeners[], das die Kommandozeile nicht liest)

Etwas, das entscheidet, ob ein Cronjob-Teil überhaupt läuft, zum Beispiel ein Stoppschalter, während ein Release bereitgestellt wird. runcronjobs.php fragt den Filter cronjob/part/run mit dem Teil, dem Siteaccess und den Skripten, bevor das erste Skript startet; nur true führt den Teil aus. Anleitung: Einen Cronjob-Teil auslassen.

Codeextension/<name>/classes/<name>listener.php
Registriert durchsite.ini [RunnableSettings] Listeners[]=cronjob/part/run@<callback>
VertragEin Callable, das ( $run, $part, $siteaccess, $scripts, $single ) nimmt und true zurückgibt, um den Teil auszuführen
Mechanismusini
Kernelkernel/private/classes/commands/runcronjobs.php

Listener für Kernel-Ereignisse

Werkzeug: /setup/settingsextension

Etwas, das aufgerufen wird, wenn der Kernel eine benannte Stelle erreicht, etwa wenn eine Anfrage eintrifft.

Codeextension/<name>/classes/<name>listener.php
Registriert durchsite.ini [Event] Listeners[]=<event>@<callback>
VertragEin Callable, das nimmt, was immer das Ereignis übergibt
Mechanismusini
Kernelkernel/private/classes/ezpevent.php

Listener für Filter-Ereignisse

Werkzeug: /setup/radsurvey/(show)/events

Ein Listener eines Filter-Ereignisses, dessen Rückgabewert ersetzt, was der Kernel übergeben hat: zum Beispiel httpcache/store/headers, die Header, die ein HTTP-Cache mit einer Seite aufbewahrt. Ein Benachrichtigungsereignis wie package/install/drafts, nachdem ein Paket als Entwürfe installiert wurde, ignoriert, was seine Listener zurückgeben.

Codeextension/<name>/classes/<name>listener.php
Registriert durchsite.ini [Event] Listeners[]=<filter>@<callback>
VertragEin Callable, das den Wert zurückgibt, den es erhalten hat, geändert oder nicht
Mechanismusfilter
Kernelkernel/private/classes/ezpevent.php

Speicherung und Infrastruktur

Wo Dinge aufbewahrt werden und wie sie dorthin gelangen.

Datenbank-Handler

Werkzeug: /setup/handlerextension/dbhandler

Eine Art von Datenbank, auf der das ganze System laufen kann.

Codeextension/<name>/classes/<name>db.php
Registriert durchsite.ini [DatabaseSettings] ImplementationAlias[<alias>]
Vertragextends eZDBInterface
Mechanismushandler
Kernellib/ezdb/classes/ezdb.php

Cluster-Datei-Handler

Werkzeug: /setup/handlerextension/cluster

Wo Dateien liegen, wenn mehr als ein Server dieselbe Website ausliefert. Alles, was der Kernel unter var/ liest oder schreibt, geht hier hindurch; er ist daher der am weitesten reichende der Speicherpunkte und derjenige, bei dem es sich am meisten lohnt, von eZFSFileHandler statt von der bloßen Schnittstelle abzuleiten.

Codeextension/<name>/classes/<name>filehandler.php
Registriert durchfile.ini [ClusteringSettings] FileHandler
VertragImplementiert eZClusterFileHandlerInterface oder erweitert eZFSFileHandler, das dies bereits tut
Mechanismushandler
Kernelkernel/classes/ezclusterfilehandler.php

DFS-Backend

Werkzeug: /setup/handlerextension/dfsbackend

Wohin der DFS-Cluster-Handler die Bytes legt: eine eingehängte Freigabe, ein Objektspeicher, irgendwo Erreichbares. Der Index dessen, was existiert, bleibt in der Datenbank; dies bewegt nur Dateiinhalte.

Codeextension/<name>/classes/<name>dfsbackend.php
Registriert durchfile.ini [eZDFSClusteringSettings] DFSBackend
VertragImplementiert eZDFSFileHandlerDFSBackendInterface
Mechanismushandler
Kernelkernel/private/classes/clusterfilehandlers/dfsbackends/ezdfsfilehandlerdfsbackendinterface.php

DFS-Datenbank-Backend

Werkzeug: /setup/handlerextension/dfsdbbackend

Die andere Hälfte von DFS: der Index, welche Dateien existieren, wie groß sie sind und welche gerade erzeugt werden. Er verhindert, dass zwei Server gleichzeitig denselben Cache-Eintrag bauen, und ist daher die schwerer zu ersetzende Hälfte.

Codeextension/<name>/classes/<name>dfsdbbackend.php
Registriert durchfile.ini [eZDFSClusteringSettings] DBBackend
VertragFolgt der Form von eZDFSFileHandlerMySQLiBackend
Mechanismushandler
Kernelkernel/private/classes/clusterfilehandlers/dfsbackends/mysqli.php

Handler für Binärdateien

Werkzeug: /setup/handlerextension/binaryfile

Wie eine hochgeladene Datei gespeichert und wieder herausgegeben wird.

Codeextension/<name>/classes/<name>binaryfilehandler.php
Registriert durchfile.ini [BinaryFileSettings] Handler
VertragImplementiert die Schnittstelle der Handler für Binärdateien
Mechanismushandler
Kernelkernel/classes/ezbinaryfilehandler.php

Suchmaschine

Werkzeug: /setup/handlerextension/search

Was Inhalte beim Veröffentlichen indiziert und was antwortet, wenn jemand sucht.

Codeextension/<name>/classes/<name>searchengine.php
Registriert durchsite.ini [SearchSettings] SearchEngine
Vertragimplements ezpSearchEngine
Mechanismushandler
Kernelkernel/private/interfaces/ezpsearchengine.php

Session-Handler

Werkzeug: /setup/handlerextension/session

Wo Sitzungen aufbewahrt und wie sie aufgeräumt werden.

Codeextension/<name>/classes/<name>sessionhandler.php
Registriert durchsite.ini [Session] Handler
Vertragextends ezpSessionHandler
Mechanismushandler
Kernellib/ezsession/classes/ezsession.php

Mail-Transport

Werkzeug: /setup/handlerextension/mail

Wie Mails das System verlassen.

Codeextension/<name>/classes/<name>transport.php
Registriert durchsite.ini [MailSettings] TransportAlias[<alias>]
Vertragextends eZMailTransport
Mechanismushandler
Kernellib/ezutils/classes/ezmailtransport.php

Handler für den statischen Cache

Werkzeug: /setup/handlerextension/staticcache

Was Seiten auf die Festplatte schreibt, damit der Webserver sie ohne PHP ausliefern kann.

Codeextension/<name>/classes/<name>staticcache.php
Registriert durchsite.ini [ContentSettings] StaticCacheHandler
VertragImplementiert ezpStaticCache
Mechanismushandler
Kernelkernel/setup/expstaticcacherunner.php

Bild-Handler und Aliase

Werkzeug: /setup/settingsextension

Wie ein Bild skaliert wird und welche Größen es gibt.

Codeextension/<name>/settings/image.ini.append.php
Registriert durchimage.ini [AliasSettings] AliasList[] und ein Abschnitt pro Alias
VertragEinstellungen und optional eine Klasse eZImageHandler
Mechanismusini
Kernellib/ezimage/classes/ezimagemanager.php

Kompilierte Einstellungen und View-Cache in Redis

Werkzeug: /setup/handlerextension/inicache

Zwei Stellen, an denen der Kernel seine Caches an Redis oder Valkey übergibt, wenn etwas dafür antwortet: der kompilierte INI-Cache und der Cache der Inhaltsansichten. Keine davon ist eine INI-Einstellung - der Kernel fragt, ob eine Klasse existiert, und verwendet sie, wenn ja; eine Installation ohne die Erweiterung verhält sich also genau wie bisher.

CodeEine Klasse namens sevenxValkeyINICache oder sevenxValkeyCacheBlock, irgendwo, wo der Autoloader sie sieht
Registriert durchNichts registriert sie: class_exists() entscheidet
Vertraginstance(), dann get() und put() für den Block-Cache; instance() und die Schnittstelle der kompilierten Datei für den INI-Cache
Mechanismushandler
Kernellib/ezutils/classes/ezini.php

Panel der Debug-Leiste

Ein Tab der Exp-Debug-Leiste aus einer Erweiterung, nach Memory, mit einem optionalen Chip in der Zusammenfassung und Daten im JSON der Seite: was die Erweiterung über die Seite weiß, etwa das Layout, aus dem sie gebaut wurde. Das Panel entscheidet, wer es sehen darf, da die Leiste auch anonymen Besuchern nach IP angezeigt wird.

Codeextension/<name>/classes/<name>debugbarpanel.php
Registriert durchdebugbar.ini [DebugBarSettings] Panels[]=<id> und [Panel_<id>] Class=<class>
Vertragimplements expDebugBarPanelInterface: visible(), title(), chip(), html() und data()
Mechanismusini
Kernellib/ezutils/classes/expdebugbarreport.php

Pakete und Shop

Dinge zwischen Installationen bewegen und sie verkaufen.

Paket-Handler

Werkzeug: /setup/handlerextension/packagehandler

Eine Art von Sache, die in ein Paket gelegt und wieder herausgenommen werden kann.

Codeextension/<name>/packagehandlers/<handler>/<handler>packagehandler.php
Registriert durchpackage.ini [PackageSettings] HandlerAlias[<alias>]
Vertragextends eZPackageHandler
Mechanismushandler
Kernelkernel/classes/ezpackagehandler.php

Handler für die Paketerstellung

Werkzeug: /setup/handlerextension/packagecreation

Die Schritte, die die Administrationsoberfläche durchläuft, wenn ein Paket erstellt wird.

Codeextension/<name>/packagehandlers/<handler>/<handler>creationhandler.php
Registriert durchpackage.ini [CreationSettings] HandlerAlias[<alias>]
Vertragextends eZPackageCreationHandler
Mechanismushandler
Kernelkernel/classes/ezpackagecreationhandler.php

Handler für die Paketinstallation

Werkzeug: /setup/handlerextension/packageinstall

Was geschieht, wenn ein Paket installiert oder wieder entfernt wird.

Codeextension/<name>/packagehandlers/<handler>/<handler>installhandler.php
Registriert durchpackage.ini [InstallerSettings] HandlerAlias[<alias>]
Vertragextends eZPackageInstallationHandler
Mechanismushandler
Kernelkernel/classes/ezpackageinstallationhandler.php

Zahlungs-Gateway

Werkzeug: /setup/handlerextension/paymentgateway

Bringt einen Warenkorb an einen Ort, an dem Geld bezahlt werden kann, und bringt die Antwort zurück. Der Shop berechnet Preise, Steuern und Lieferung eines Warenkorbs und hört beim Einnehmen von Geld auf: Dies ist das Stück, das nicht mitgeliefert wird. Es wird für eine Bestellung zweimal aufgerufen - einmal, um den Käufer wegzuschicken, einmal, wenn er zurückkehrt -, und die beiden Besuche werden durch die Zahlungszeile verbunden, die es dazwischen speichert.

Der Kernel sucht ein Gateway unter <GatewaysDirectories>/<gateway>/classes/<gateway>gateway.php, für jeden Namen in AvailableGateways[]; die Klassendatei liegt also in einem Verzeichnis mit dem Namen ihres Alias. Vor 6.0.15 schrieb das Werkzeug paymentgateways/<alias>gateway.php, wo niemand sucht, und registrierte die Klasse unter <alias>gateway statt unter ihrem eigenen Namen: Ein mit einer früheren Version erzeugtes Gateway muss an den Pfad oben verschoben werden, und das zweite Argument seines registerGateway()-Aufrufs muss der Klassenname werden.

Codeextension/<name>/paymentgateways/<alias>/classes/<alias>gateway.php
Registriert durchpaymentgateways.ini [GatewaysSettings] AvailableGateways[] und GatewaysDirectories[], dazu eZPaymentGatewayType::registerGateway() am Ende der Klassendatei, dazu ein Workflow mit einem Ereignis Payment Gateway, gebunden an shop_confirmorder
Vertragextends eZRedirectGateway oder eZPaymentGateway für eines, das die Zahlung annimmt, ohne die Website zu verlassen
Mechanismusdirectory
Kernelkernel/shop/classes/ezredirectgateway.php

Zahlungs-Gateway, transparent

Werkzeug: /setup/handlerextension/paymentgatewaydirect

Nimmt die Zahlung an, ohne dass der Käufer die Website je verlässt: Die Karte wird im Browser gegen ein Token getauscht, und die Belastung erfolgt von Server zu Server, während er wartet. Heute die übliche Form und eine andere Aufgabe als die Weiterleitungsart - ein Aufruf entscheidet über die Bestellung, es gibt also keinen zweiten Besuch, in dem eine falsche Antwort korrigiert werden könnte, und ein Timeout ist ein wirklich mehrdeutiger Zustand, nach dem gefragt statt geraten werden muss.

Codeextension/<name>/paymentgateways/<alias>/classes/<alias>gateway.php
Registriert durchpaymentgateways.ini [GatewaysSettings] AvailableGateways[] und GatewaysDirectories[], dazu eZPaymentGatewayType::registerGateway() am Ende der Klassendatei, dazu ein Workflow mit einem Ereignis Payment Gateway, gebunden an shop_confirmorder
Vertragextends eZPaymentGateway
Mechanismusdirectory
Kernelkernel/shop/classes/ezpaymentgateway.php

Mehrwertsteuer-Handler

Werkzeug: /setup/handlerextension/vat

Welcher Steuersatz für was gilt, für wen.

Codeextension/<name>/classes/<name>vathandler.php
Registriert durchshop.ini [VATSettings] Handler und RepositoryDirectories[]
VertragImplementiert die Schnittstelle der Mehrwertsteuer-Handler
Mechanismusdirectory
Kernelkernel/classes/ezvatmanager.php

Versand-Handler

Werkzeug: /setup/handlerextension/shipping

Was die Lieferung kostet und welche Optionen es gibt.

Codeextension/<name>/classes/<name>shippinghandler.php
Registriert durchshop.ini [ShippingSettings] Handler und RepositoryDirectories[]
VertragImplementiert die Schnittstelle der Versand-Handler
Mechanismusdirectory
Kernelkernel/classes/ezshippingmanager.php

Handler für Warenkorbinformationen

Werkzeug: /setup/handlerextension/basketinfo

Was eine Zeile des Warenkorbs über sich selbst sagt: Name, Preis und was sie ist.

Codeextension/<name>/classes/<name>basketinfohandler.php
Registriert durchshop.ini [BasketInfoSettings] Handler und RepositoryDirectories[]
VertragImplementiert die Schnittstelle der Handler für Warenkorbinformationen
Mechanismusdirectory
Kernelkernel/classes/basketinfohandlers/ezdefaultbasketinfohandler.php

Handler für Wechselkurse

Werkzeug: /setup/handlerextension/exchangerate

Woher der Kurs zwischen zwei Währungen kommt.

Codeextension/<name>/classes/<name>exchangeratehandler.php
Registriert durchshop.ini [ExchangeRatesSettings] Handler und RepositoryDirectories[]
VertragImplementiert die Schnittstelle der Handler für Wechselkurse
Mechanismusdirectory
Kernelkernel/shop/classes/exchangeratehandlers/ezexchangeratesupdatehandler.php

Benutzer, Zugriff und Sprache

Wer hineinkommt, was er tun darf und in welcher Sprache.

Filter für URL-Aliase

Werkzeug: /setup/handlerextension/urlfilter

Läuft über jede URL, die dieses System erzeugt, bevor sie gespeichert wird, und darf sie umschreiben. Das, was hier einem Ausgabefilter über Adressen am nächsten kommt: Jeder Alias, für jedes Objekt, in jeder Sprache, geht beim Erzeugen hindurch.

Codeextension/<name>/classes/<name>urlfilter.php
Registriert durchsite.ini [URLTranslator] FilterClasses[]
Vertragextends eZURLAliasFilter und implementiert process( $text, &$languageObject, &$caller )
Mechanismushandler
Kernelkernel/classes/ezurlaliasfilter.php

Filter für Mobilgeräte

Werkzeug: /setup/handlerextension/mobilefilter

Entscheidet, ob eine Anfrage von einem Telefon kam und was damit geschehen soll. Der ausgelieferte gleicht User-Agent-Zeichenketten mit Mustern ab, was schlecht altert; ein eigener Filter kann einen Header verwenden, den ein Proxy setzt, oder einen Hinweis, den der Browser gibt.

Codeextension/<name>/classes/<name>mobilefilter.php
Registriert durchsite.ini [SiteAccessSettings] MobileDeviceFilterClass
VertragImplementiert ezpMobileDeviceDetectFilterInterface: process, isMobileDevice, getUserAgentAlias, redirect
Mechanismushandler
Kernelkernel/private/classes/ezpmobiledevicedetectfilterinterface.php

REST-Filter vor dem Routing

Werkzeug: /setup/handlerextension/restprerouting

Die früheste Stelle, an der eine REST-Anfrage zu sehen ist. Noch ist nichts zugeordnet und kein Controller gewählt, daher kann eine Anfrage umgeschrieben oder abgewiesen werden, bevor sich irgendetwas verpflichtet hat, sie zu beantworten - und vor der Authentifizierung, also bei einem Aufrufer, den niemand identifiziert hat.

Codeextension/<name>/classes/<name>preroutingfilter.php
Registriert durchrest.ini [PreRoutingFilters] Filters[]
VertragImplementiert ezpRestPreRoutingFilterInterface
Mechanismushandler
Kernelkernel/private/rest/classes/interfaces/prerouting_filter.php

REST-Anfragefilter

Werkzeug: /setup/handlerextension/restrequestfilter

Läuft, sobald das Anfrageobjekt gebaut und die Route bekannt ist, und weiß daher, welcher Controller gleich antworten wird. Hier wird ein Header gelesen, ein Parameter normalisiert oder eine Anfrage aus Gründen abgelehnt, die davon abhängen, was sie angefragt hat.

Codeextension/<name>/classes/<name>requestfilter.php
Registriert durchrest.ini [RequestFilters] Filters[]
VertragImplementiert ezpRestRequestFilterInterface
Mechanismushandler
Kernelkernel/private/rest/classes/interfaces/request_filter.php

REST-Ergebnisfilter

Werkzeug: /setup/handlerextension/restresultfilter

Läuft, nachdem der Controller seine Antwort ermittelt hat und bevor sie zu JSON oder XML wird. Das Ergebnis ist hier noch gewöhnliches PHP, daher kann es einmal für jedes Format ergänzt oder umgeformt werden statt in jedem Renderer.

Codeextension/<name>/classes/<name>resultfilter.php
Registriert durchrest.ini [ResultFilters] Filters[]
VertragImplementiert ezpRestResultFilterInterface
Mechanismushandler
Kernelkernel/private/rest/classes/interfaces/result_filter.php

REST-Antwortfilter

Werkzeug: /setup/handlerextension/restresponsefilter

Der Ausgabefilter der REST-Schicht: das Letzte, was geschieht, bevor eine Antwort hinausgeht. Ein Header bei jeder Antwort, ein umhüllter Body, ein geänderter Inhaltstyp, ohne einen Controller anzufassen.

Codeextension/<name>/classes/<name>responsefilter.php
Registriert durchrest.ini [ResponseFilters] Filters[]
VertragImplementiert ezpRestResponseFilterInterface
Mechanismushandler
Kernelkernel/private/rest/classes/interfaces/response_filter.php

REST-Präfixfilter

Werkzeug: /setup/handlerextension/restprefix

Was entscheidet, wo die API liegt und welche Version davon eine Anfrage angefragt hat. Der ausgelieferte liest einen regulären Ausdruck; ihn zu ersetzen ist der Weg, die API von /api/ wegzubewegen oder ihre Version anderswoher als aus dem Pfad zu nehmen.

Codeextension/<name>/classes/<name>prefixfilter.php
Registriert durchrest.ini [System] PrefixFilterClass
VertragErweitert ezpRestPrefixFilterInterface: parseVersionValue() und filter()
Mechanismushandler
Kernelkernel/private/rest/classes/prefix_filter.php

Login-Handler für Benutzer

Werkzeug: /setup/handlerextension/login

Wogegen ein Benutzer geprüft wird, wenn er sich anmeldet - ein Verzeichnis, ein anderes System, irgendetwas.

Codeextension/<name>/user/<handler>/<handler>user.php
Registriert durchsite.ini [UserSettings] LoginHandler[] und ExtensionDirectory[]
Vertragextends eZUser und implementiert loginUser()
Mechanismusdirectory
Kernelkernel/classes/datatypes/ezuser

Zusätzliche Wurzelverzeichnisse für Erweiterungen

Werkzeug: /setup/settingsextension

Wo Erweiterungen liegen dürfen, über extension/ hinaus. Ein zweites Wurzelverzeichnis - extension_src/ ist der übliche Name - trennt, was ein Projekt geschrieben hat, von dem, was es von anderswo übernommen hat, sodass die Zuständigkeit an der Verzeichnisstruktur ablesbar ist statt an einer Liste, die jemand pflegt. Eine Erweiterung gleichen Namens in einem späteren Wurzelverzeichnis verdeckt die vorherige; so wird ein Paket eines Anbieters geforkt, ohne es zu bearbeiten.

Codesettings/override/site.ini.append.php und das Wurzelverzeichnis selbst
Registriert durchsite.ini [ExtensionSettings] AdditionalExtensionDirectories[]
VertragNur Einstellungen. Jeder Verwender geht über eZExtension::extensionPath() und expandedPathList(), daher muss sich nichts ändern, um ein neues Wurzelverzeichnis zu sehen
Mechanismusini
Kernellib/ezutils/classes/ezextension.php

Filter für Wurzelverzeichnisse von Erweiterungen

Werkzeug: /setup/kerneloverride

Das letzte Wort darüber, welche Wurzelverzeichnisse durchsucht werden, im Code statt in Einstellungen. Ihn neu zu definieren ist der Weg, ein Wurzelverzeichnis zur Laufzeit zu ermitteln - aus einer Umgebungsvariablen, daraus, welche Maschine dies ist, aus dem, was ein Deployment auf die Festplatte gelegt hat -, statt es in eine INI-Datei zu schreiben, die pro Installation unterschiedlich sein muss.

CodeEin Kernel-Override von lib/ezutils/classes/ezextension.php
Registriert durchNichts registriert ihn: Der Kernel ruft eZExtension::filterExtensionRootDirectories() auf und verwendet, was zurückkommt
Vertragstatic filterExtensionRootDirectories( array $roots ) : array
Mechanismusoverride
Kernellib/ezutils/classes/ezextension.php

Site-Erweiterung

Werkzeug: /setup/settingsextension

Eine Erweiterung, die eine ganze Website trägt: ihr Design, ihre Siteaccesses, ihre gruppierten Overrides der Einstellungen, ihre Module und ihren Code. Was das möglich und nicht nur ordentlich macht, ist, dass eine Erweiterung jetzt ein eigenes settings/siteaccess/<name>/ enthalten kann, sodass der Siteaccess mit dem reist, was ihn definiert, statt in settings/ auf einer Maschine zu liegen.

Codeextension/<name>/{design,settings/siteaccess/<sa>,modules,classes,autoloads}/
Registriert durchsite.ini [ExtensionSettings] ActiveExtensions[] und ActiveAccessExtensions[], dazu AdditionalExtensionDirectories[], wenn sie außerhalb von extension/ liegt
VertragKeine Klasse: ein Verzeichnis, aufgebaut so, wie der Kernel sucht
Mechanismusdirectory
Kerneldoc/eng-us/bc/6.0/AdditionalExtensionDirectories.md

Einstellungen aus Code schreiben

Werkzeug: /setup/settingsextension

Eine INI-Datei aus PHP statt von Hand ändern: was der Einstellungseditor in der Administration tut und was ein Installationsprogramm oder ein Upgrade-Skript braucht. Seit 6.0 behält ein Schreiben mit direktem Zugriff die Kommentare und die Reihenfolge der bearbeiteten Datei, statt sie als bloße Schlüssel und Werte neu zu schreiben, sodass eine erzeugte Änderung danach von dem gelesen werden kann, der sie pflegen muss.

CodeJedes Skript oder jede Modul-View
Registriert durchNichts zu registrieren: eZINI mit directAccess true, dann setVariable() und save()
VertragsetVariable( $section, $name, $value ), dann save(); die Datei behält ihre Kommentare
Mechanismusfile
Kernellib/ezutils/classes/ezini.php

Erweiterung mit Siteaccess-Einstellungen

Werkzeug: /setup/settingsextension

Einstellungen, die nur für einen Siteaccess gelten und mit der Erweiterung aufbewahrt werden statt in settings/.

Codeextension/<name>/settings/siteaccess/<siteaccess>/
Registriert durchsite.ini [ExtensionSettings] ActiveAccessExtensions[]
VertragNur Einstellungen
Mechanismusini
Kernellib/ezutils/classes/ezini.php

Übersetzung

Werkzeug: /setup/contentextension

Die Wörter, die die Oberfläche verwendet, in einer anderen Sprache.

Codeextension/<name>/translations/<locale>/translation.ts
Registriert durchi18n.ini und dass die Locale verfügbar ist
VertragEine ts-Datei mit Kontexten und Meldungen
Mechanismusfile
Kernellib/ezi18n/classes/eztranslationcache.php

Handler für RSS-Importe

Werkzeug: /rss/list

Was ein importiertes Element eines Feeds wird, nachdem es abgerufen wurde.

Codeextension/<name>/rss/ezrssimporthandler.php
Registriert durchsite.ini [RSSSettings] ActiveExtensions[]
VertragImplementiert die Schnittstelle der Handler für RSS-Importe
Mechanismusdirectory
Kernelkernel/classes/ezrssimport.php

Damit es stimmt

Der Katalog ist Daten, keine Prosa: expRADCatalogue::points(). Ein dort hinzugefügter Punkt erscheint auf der Seite RAD, ohne dass die Seite bearbeitet wird. Dieses Dokument wird aus demselben Katalog erzeugt; unterscheiden sich die beiden, ist Setup > RAD aktuell.

Verwandte Seiten

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