Learning: Learning: How to create a design extension

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