Skip to the content
Documentation

Extension load ordering

No ratings yet

The order of the active extensions decides which extension's settings, templates and design files win when two provide the same thing: an extension loaded earlier wins over a later one.

How the order is made

  • The order of the ActiveExtensions[] lines in settings/override/site.ini.append.php, followed by the ActiveAccessExtensions[] lines of the siteaccess.
  • With [ExtensionSettings] ExtensionOrdering=enabled, the setting shipped in Exponential 6, the dependencies each extension declares in its extension.xml decide first: an extension is loaded after the ones it depends on, wherever it stands in the list.

See and change it

Setup > Extensions in the administration shows the list in loading order, and each card shows where the extension really loads. Change the order in the same list; the page writes it only after a review, keeps the comments in the settings file, makes a backup first and clears the caches that depend on the order.

On the command line, see the list and which file sets it:

./console exp:ini list site.ini/ExtensionSettings
./console exp:ini where site.ini/ExtensionSettings/ActiveExtensions

To change it by hand, edit the order of the ActiveExtensions[] lines in settings/override/site.ini.append.php, then clear the INI and template override caches (php bin/php/ezcache.php --clear-tag=ini and --clear-id=template-override). If you moved a theme extension, check a page of the site afterwards.

More: The Extensions page. Previous step: Activating the extension.

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.