sevenx_themes_admin_classic — 7x Admin Classic Session Switch (Stable; Open Source; eZ Publish Legacy Extension)
sevenx_themes_admin_classic provides session-driven switching between admin3-first template resolution and admin3+admin_classic fallback resolution for legacy admin workflows requiring classic SSR template behavior.
- Project Notice
- Project Status
- What Is sevenx_themes_admin_classic?
- Requirements
- Installation
- Configuration
- kracker.org Deployment Note (Critical)
- Troubleshooting
- Issue Tracker
- License
This project is an independent extension maintained by 7x for Exponential Platform Legacy and eZ Publish Legacy deployments.
sevenx_themes_admin_classic is actively maintained and intended for production use where admin3 must remain the primary design while selective classic fallback behavior is required.
The extension adds:
- A toolbar switch button in admin UI
- A module endpoint to toggle design mode in session
- A kernel override to apply session-driven DesignSettings values at runtime
Current runtime behavior:
- Classic enabled: AdditionalSiteDesignList =
admin3, admin_classic, admin - Classic disabled: AdditionalSiteDesignList =
admin3, admin
SiteDesign remains admin3.
- Exponential Platform Legacy / eZ Publish Legacy
- Kernel overrides enabled in
config.php - Extension activated in
settings/override/site.ini.append.php
- Activate extension:
[ExtensionSettings]
ActiveExtensions[]=sevenx_themes_admin_classic- Ensure kernel override support is enabled:
define( 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE', true );- Regenerate autoloads:
php ./bin/php/ezpgenerateautoloads.php --kernel-override- Customize admin siteaccess content view preferences (required for subitems controls):
Edit your admin siteaccess file, for example:
settings/siteaccess/korg_edit/site.ini.append.php
Set:
[ContentSettings]
CachedViewPreferences[full]=admin_navigation_content=1;admin_navigation_subitems=1;admin_subitems_limit=200;admin_children_viewmode=list;admin_list_limit=1
TranslationList=- Register the toolbar tool in your active admin siteaccess (required for button visibility):
Edit for your active admin siteaccess, for example:
settings/siteaccess/korg_edit/toolbar.ini.append.php
Ensure these entries exist:
[Tool]
AvailableToolArray[]=admin_switch_design
[Toolbar_admin_developer]
Tool[]=admin_clear_cache
Tool[]=admin_switch_design
Tool[]=admin_quick_settings- Ensure role policy allows module access:
For standard admin role setups using "all modules / all functions / no limitations", no extra policy is needed.
If you use explicit module policies, grant:
Module: switchadmindesign
Function: switchOptional (not recommended as default): omit policy checks entirely via extension site.ini.
extension/sevenx_themes_admin_classic/settings/site.ini.append.php
[RoleSettings]
PolicyOmitList[]=switchadmindesign- Clear caches:
php ./bin/php/ezcache.php --clear-allConfigure extension settings file:
extension/sevenx_themes_admin_classic/settings/sevenxthemesadminclassic.ini.append.php
Important:
- Keep the extension file value as a generic example/default.
- Put deployment-specific values only in
settings/override/sevenxthemesadminclassic.ini.append.php.
Required setting:
[SevenXThemesAdminClassicSettings]
SharedAdminSiteaccessName=<your_admin_siteaccess_name>
SwitchAdminDesignSessionVariableName=SevenXThemesAdminClassicDesignEnabledFor this deployment, the required value is:
SharedAdminSiteaccessName=korg_editSet this value in:
settings/override/sevenxthemesadminclassic.ini.append.php
If this value does not match the real admin siteaccess name, switch button text may change while template resolution behavior does not.
Checklist:
- Confirm
SharedAdminSiteaccessNameexactly matches active admin siteaccess. - Confirm extension is active in
settings/override/site.ini.append.php. - Confirm kernel override autoloads were regenerated.
- Confirm caches were cleared.
- Confirm you are testing within the configured admin siteaccess.
Run:
php ./bin/php/ezcache.php --clear-all --allow-root-userSubmit issues and improvements at:
https://github.com/se7enxweb/sevenx_themes_admin_classic/issues
GNU General Public License v2.0 (or any later version).
Copyright (C) 1998 - 2026 7x.