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

Eine Extension kann ein Kernel-Modul ersetzen

Diese Seite ist für Entwickler, die ändern müssen, wie ein ganzes Modul arbeitet. Ein Modul ist eine Menge von Ansichten hinter einer URL (content/view, user/login, shop/basket). Bis Januar 2024 gewann das Modul des…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/features/6.0/extension-module-override.md

On this page

This page is a translation. Read the English original

Eine Extension kann ein Kernel-Modul ersetzen

Diese Seite ist für Entwickler, die ändern müssen, wie ein ganzes Modul arbeitet. Ein Modul ist eine Menge von Ansichten hinter einer URL (content/view, user/login, shop/basket). Bis Januar 2024 gewann das Modul des Kernels immer dann, wenn eine Extension ein Modul mit demselben Namen anbot; eine Extension konnte also Module hinzufügen, aber keines ersetzen. Jetzt werden die Modul-Repositorys so durchsucht, dass Extensions zuerst kommen: Legen Sie in Ihrer Extension ein Modul mit demselben Namen an, und es wird statt des Kernel-Moduls verwendet.

Wann Sie es verwenden

Ersetzen Sie ein ganzes Modul, wenn eine Ansicht mehr braucht, als eine Template-Überschreibung oder ein Ereignis leisten kann, zum Beispiel einen Anmeldeablauf mit einem zusätzlichen Schritt oder einen geänderten Warenkorb. Für kleine Änderungen sind die RAD-Erweiterungspunkte und Ansichtsklassen (Befehle, Cronjob-Teile und Modulansichten als Klassen) vorzuziehen.

So geht es

  1. Legen Sie das Modul in Ihrer Extension an, mit demselben Aufbau wie ein Kernel-Modul:

    extension/myext/modules/user/module.php
    extension/myext/modules/user/login.php
  2. Sorgen Sie dafür, dass die Extension aktiv ist (settings/override/site.ini.append.php, [ExtensionSettings] ActiveExtensions[]=myext) und sich selbst als Modul-Repository einträgt. Eine Extension tut das in ihrer eigenen settings/module.ini.append.php:

    [ModuleSettings]
    ExtensionRepositories[]=myext
  3. Leeren Sie die Caches:

    php bin/php/ezcache.php --clear-all --allow-root-user
  4. Öffnen Sie die URL (zum Beispiel /user/login). Die Ansicht der Extension läuft.

Grenze: Eine Ansicht, die Sie in Ihrer Kopie des Moduls nicht definieren, wird nicht geerbt. Das ganze Modul wird ersetzt, kopieren Sie also jede Ansicht, die Sie noch brauchen.

Einstellungen

DateiBlockSchlüsselStandardGeltungsbereich
settings/module.iniModuleSettingsModuleRepositories[]kernel, kernel/private/modulesInstallation
settings/module.iniModuleSettingsExtensionRepositories[]leer; jede aktive Extension trägt sich selbst einExtension

Wie es funktioniert

eZModule::activeModuleRepositories() (lib/ezutils/classes/ezmodule.php) baut die Liste der Modulverzeichnisse aus ModuleRepositories[] und danach aus ExtensionRepositories[] auf. Seit dem 24. Januar 2024 (c6b90d723d) kehrt es die zusammengesetzte Liste um, sodass die Extension-Repositorys zuerst durchsucht werden. Das erste Verzeichnis, das ein Modul mit dem angefragten Namen enthält, gewinnt.

Eine verwandte Korrektur für mehr Robustheit

Ein Ansichtsskript einer unvollständigen Extension (die Extension ownerchange war eine) kann etwas zurückgeben, das nicht das erwartete Array ist. Seit Oktober 2024 (884f21e963) setzt eZModule die Navigationsschlüssel (is_default_navigation_part, navigation_part) im Ergebnis nur, wenn es ein Array ist (im aktuellen Stand lautet die Prüfung !is_string). Eine Ansicht, die einen anderen Typ zurückgibt, endet nicht mehr in einem fatalen Fehler, während die Seite zusammengesetzt wird.

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