Modifying The layout-group Resource

The first step is to modify the publication's layout-group resource by adding a group definition like this:

<group name="x140x300x300x140-config" root="true">
  <ui:label>Four Column Config</ui:label>
  <ct:options>
    <ct:field name="inherits_from" type="basic" mime-type="text/plain">
    <ui:label>Inherits From</ui:label>
    <ui:description>Custom configuration section name or id</ui:description>
    </ct:field>
  </ct:options>
  <ui:decorator name="wfItemsResolver"/>
  <area name="meta"/>
  <area name="header">
    <ref-group name="x460x460"/>
    <ref-group name="x700x220"/>
    <ref-group name="x300x300x300"/>
    <ref-group name="x220x220x220x220"/>
    <ref-group name="tabbingGroup"/>
  </area>
  <area name="left">
    <ref-group name="tabbingGroup"/>
  </area>
  <area name="main1">
    <ref-group name="tabbingGroup"/>
  </area>
  <area name="main2">
    <ref-group name="tabbingGroup"/>
  </area>
  <area name="right">
    <ref-group name="tabbingGroup"/>
  </area>
  <area name="footer">
    <ref-group name="x460x460"/>
    <ref-group name="x700x220"/>
    <ref-group name="x300x300x300"/>
    <ref-group name="x220x220x220x220"/>
    <ref-group name="tabbingGroup"/>
  </area>
</group>

Note the following:

  • A grid group name ( x140x300x300x140-config in this case) has a fixed format. It is formed by concatenating the column widths (in order from left to right). Each column width must be preceded by an x character, and the column width sequence must be followed by the string -config.

  • A grid group must be a root group (that is, the group element must have a root attribute and it must be set totrue). This is necessary to ensure that the group is displayed as a page option in Content Studio.

  • The group definition uses a request pool decorator named wfItemsResolver. This decorator ensures that items for a specific area are found using the inheritance mechanism specific to EWF.

  • There is a field named inherits_from defined in group options. This field allows the user to override the configuration section from which the current configuration section inherits.

  • All the other group names in this example have been taken from standard layout-group resource distributed with the Widget Framework.