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 to true). 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.