Learning: Learning: How to create a design extension
Table of contents:
This is a Stub article. Help the eZ Publish community by expanding it!
Extension design priority
Each extensions priority is important to consider. To override a design extension like ezwebin you would want to first place your own custom design extension in priority above the ezwebin extension active settings.
Enabling a design extension per site access
A simple example of design extension priority in the site.ini, ExtensionSettings, ActiveAccess settings array of ezpublish settings
[ExtensionSettings] ActiveAccessExtensions[]=customdesign ActiveAccessExtensions[]=seperatecustomdesign
Enabling a design extension globally
A simple example of design extension priority in the site.ini, ExtensionSettings, ActiveExtensions settings array of ezpublish settings
[ExtensionSettings] ActiveExtensions[]=ezauthorize ActiveExtensions[]=bcwebsitestatistics ActiveExtensions[]=googlesitemaps ActiveExtensions[]=ezwebin ActiveExtensions[]=ezdhtml ActiveExtensions[]=ezodf ActiveExtensions[]=ezpaypal ActiveExtensions[]=wrap_operator ActiveExtensions[]=survey
Creating a custom design extension
A custom design extension is very simple in that one must simply configure to use a single custom design extension which you provide. Often users simply disable the ezwebin extension from the activation settings both globally and per siteaccess. Then enable your custom design extension at least in one active siteaccess settings or globally.
A simple example of design extension priority in the site.ini, ExtensionSettings, ActiveExtensions settings array of ezpublish settings
[ExtensionSettings] ActiveExtensions[]=yourcustomdesign # ActiveExtensions[]=ezwebin ActiveExtensions[]=ezdhtml ActiveExtensions[]=ezodf
Creating a custom design extension override of base design
Everyone wants to know how to override the default eZ Publish design eZ Webin. eZ Webin is a general design extension which ships in eZ Publish as the default user design extension. The answer starts with the settings. With the correct settings combination you can override the ezwebin design. Often users simply enable their override design extension in a single active siteaccess settings.
Global
Here an example in override/site.ini.append.php
[ExtensionSettings] ActiveExtensions[]=yourcustomdesign ActiveExtensions[]=ezwebin ActiveExtensions[]=ezdhtml ActiveExtensions[]=ezodf
Siteaccess
A simple example of design extension priority in the site.ini, ExtensionSettings, ActiveAccess settings array of ezpublish settings
[ExtensionSettings] ActiveAccessExtensions[]=customdesign ActiveAccessExtensions[]=seperatecustomdesign ActiveAccessExtensions[]=ezwebin
Reference
- Forum: Page Layout Extension
- Forum: Why the extension doesn't work?