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

Der Rundgang durch die RAD-Werkzeuge: Setup > RAD

Ein Rundgang durch Setup > RAD - der Katalog der Erweiterungspunkte und seine Filter, die Übersicht, die Zustandsprüfung und wie jeder Assistent funktioniert, von den Feldern über die Vorschau bis zum Anlegen oder…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-3-extension-developer/tutorials/the-rad-tools-tour.md

On this page

This page is a translation. Read the English original

Der Rundgang durch die RAD-Werkzeuge: Setup > RAD

Tutorial 1. Setup > RAD (/setup/rad, Richtlinie setup/setup) ist der Werkzeugkasten der Administration für Erweiterungsentwickler. Er besteht aus drei Dingen: einem Katalog aller Stellen, an denen das System erweitert werden kann, einer Übersicht dessen, was diese Installation tatsächlich anbietet, und einer Reihe von Assistenten, die funktionierende Erweiterungen schreiben. Dieser Rundgang zeigt jedes davon; die Angaben stammen aus kernel/setup/expradcatalogue.php, expradsurvey.php, expradhealth.php und den Assistentenklassen daneben.

1. Der Katalog

Öffnen Sie /setup/rad. Die Seite trägt den Titel „Werkzeuge zur schnellen Anwendungs-Entwicklung“ und sagt, was sie ist: „Unten ist jeder Punkt aufgeführt, an dem dieses System erweitert werden kann: wofür er gedacht ist, wohin der Code gehört und was ihn registriert.“

Jeder Eintrag zeigt:

FeldBedeutung
Codewohin der Code in Ihrer Erweiterung gehört
Registriert durchdie Einstellung oder Konvention, die ihn anschließt
Vertragdie zu erweiternde Klasse oder die zu implementierende Schnittstelle
Kerneldie Kernel-Datei, in der der Mechanismus liegt
Werkzeug verfügbar / noch kein Werkzeugob ein Assistent ihn schreibt

Die Einträge stehen in sieben Gruppen: Inhalt; Templates und Design; Module und Views; Workflow, Ereignisse und Jobs; Speicherung und Infrastruktur; Pakete und Shop; Benutzer, Zugriff und Sprache. Drei Filter (aus expRADCatalogue::filters()):

FilterAdresse
Alles/setup/rad
Mit einem Werkzeug/setup/rad/(show)/tools
Nur Dokumentation/setup/rad/(show)/docs

Das Feld Suchen grenzt die Liste beim Tippen ein (ein Name, eine Einstellung, eine Klasse, eine Datei). Derselbe Katalog als Text ist Erweiterungspunkte.

2. Die Übersicht

Der Katalog ist von Hand geschrieben; die Übersicht der Erweiterungspunkte (/setup/radsurvey) wird bei jeder Anfrage von der Festplatte gelesen. Sie zählt, mit einem Link zu den Einträgen hinter jeder Zahl:

GruppeWas sie auflistet
Einstellungen, die eine Klasse benennenjeden INI-Wert, der eine Klasse nennt, über alle INI-Dateien hinweg
Orte, an denen der Kernel suchtVerzeichnisse, in denen nach Handlern, Datentypen, Ereignissen ... gesucht wird
Schnittstellen und abstrakte Klassendie Verträge
Module und ihre Views, Einschränkungen von Richtlinienjede View und jede Einschränkung
Was ein Template aufrufen kannalles, was ein Template aufrufen kann (Operatoren und Funktionen)
Ereignisse, auf die etwas hören kannalles, was ein Ereignis ankündigt
Bereits ersetzte Templatesjede Override-Regel
Vollständig ersetzte Kernel-Klassenwirksame Kernel-Overrides
Kommandos, Cronjob-Teile und Views als Klassendie ausführbaren Klassen, die eine Unterklasse ersetzen kann
RegistriesEinträge der in rad.ini deklarierten Registries

Verwenden Sie sie, um die Frage „Gibt es dafür schon einen Anknüpfungspunkt?“ zu beantworten, bevor Sie einen schreiben. Ein Abschnitt lässt sich verlinken: /setup/radsurvey/(show)/<section>. Die erzeugte Referenz ist Die Erweiterungsoberfläche.

3. Die Zustandsprüfung

Die RAD-Seite führt außerdem expRADHealth::findings() aus: Einstellungen, die eine Klasse nennen, die sich nicht laden lässt, ein durchsuchtes Verzeichnis, das nicht vorhanden ist, eine Design-Extension ohne Design, eine View ohne Skript, ein angebotener, aber nicht gefundener Datentyp und mehr, jeweils mit dem Weg zur Behebung. Lesen Sie sie, nachdem Sie eine Erweiterung installiert oder geschrieben haben.

4. Wie jeder Assistent funktioniert

Alle Assistenten folgen demselben Ablauf (kernel/setup/expextensionwizard.php):

  1. Die Extension: Name der Extension, Klassenname, Titel, Zusammenfassung, Autor, Composer-Vendor, Version, Lizenz.
  2. Was hineinkommt: die zu schreibenden Teile (für einen Datentyp: Bearbeiten, Klasseneinstellungen, Standardwert, Objekte benennen, Durchsuchbar, Sortierbar, Text ein und aus, Informationssammler, Dateien, Pakete, Unterschiede zwischen Versionen, Beim Veröffentlichen und mehr; jeder Teil ist eine Gruppe von Methoden, die nur zusammen sinnvoll sind).
  3. Was geschrieben wird: die Methoden oder Templates, jeweils mit einem Hinweis, wofür der Kernel sie aufruft.
  4. Einschalten: die genauen Zeilen, die Sie in settings/override/site.ini.append.php eintragen, und Dann (die Autoloads neu erzeugen, die Caches leeren).
  5. Jede Datei, bevor sie geschrieben wird: der vollständige Inhalt jeder Datei, mit Zeilen- und Byteanzahl. Vorschau aktualisieren nach einer Änderung.
  6. In extension/ anlegen schreibt die Dateien, oder Als ZIP herunterladen gibt Ihnen dieselben Dateien als Archiv. Wenn der Webserver nicht in extension/ schreiben kann, sagt die Seite das und bietet nur das Archiv an.

Schutzmechanismen, auf die Sie sich verlassen können (RAD-Werkzeuge: Sicherheit): Nichts wird außerhalb von extension/<name> geschrieben, eine vorhandene Erweiterung wird nie überschrieben, eingegebene Werte können nicht aus Kommentaren oder INI-Zeilen ausbrechen, erzeugte Templates maskieren die Ausgabe, und erzeugte Views prüfen die Eingabe.

5. Die Assistenten

AssistentAdresseTutorial
Assistent für Template-Extensions/setup/templateoperatorEin Template-Operator in fünf Minuten
Datentyp-Assistent/setup/datatypeEin Datentyp
Modul-Assistent / Modul über vorhandenen Tabellen/setup/modulewizard, /setup/moduleextensionEin Modul mit Views
Assistent für Workflow-Ereignisse/setup/workfloweventEin Workflow-Ereignis
Assistent für Design-Extensions/setup/designextensionEine Design-Erweiterung
Assistent für Einstellungs-Extensions/setup/settingsextensionEine Erweiterung nur mit Einstellungen
Assistent für Content-Extensions/setup/contentextensioneine Inhaltsklasse als Installationsskript
Handler-Assistent/setup/handlerextension/<kind>Handler und Kernel-Overrides
Assistent für Kernel-Overrides/setup/kerneloverrideHandler und Kernel-Overrides

6. Nach jedem Assistenten

./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' <name> global
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all
php bin/php/checkclasses.php --quiet-ok

Lesen Sie dann die erzeugte README.md: Jeder Assistent schreibt eine, die beschreibt, was er geschrieben hat und wie es weitergeht, dazu doc/examples.php mit sofort ausführbaren Beispielen für die meisten Arten.

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