[Summary view] [Print] [Text view]

   1  <!-- $Id: add-new-group.html,v 1.1.2.5 2008/10/22 21:09:12 karens Exp $ -->
   2  <p>Field groups are used to visually gather several fields that are associated
   3  by some sort of logic, for instance several text fields that hold the different
   4  parts of an 'Address'. On input forms and displayed content, the corresponding
   5  fields are enclosed inside an HTML fieldset.</p>
   6  
   7  <img style="vertical-align:top" src="&path&group-node-edit-form.png">
   8  <img style="vertical-align:top" src="&path&group-node-display.png">
   9  
  10  <p>At the bottom of the <strong>Manage fields</strong> page for a content type,
  11  you'll find this:</p>
  12  
  13  <img src="&path&add-new-group.png">
  14  
  15  <p>In order to add a new group to a content type, you need to provide the
  16  following information:</p>
  17  <dl>
  18    <dt><strong>Label:</strong></dt>
  19    <dd>
  20      A human-readable name for the group. It will be used in input forms and
  21      on displayed content.<br/>
  22      All characters are allowed, including spaces, accentuated or non-european
  23      characters.<br/>
  24    </dd>
  25  
  26    <dt>Group name:</dt>
  27    <dd>
  28      A machine-readable name for the group. It is used internally to identify
  29      the group. When doing custom theming, it is this identifier that you'll use
  30      to refer to that group.<br/>
  31      <strong>Important:</strong> The group name cannot be changed once the group has been
  32      created.<br/>
  33      Allowed characters: a-z (unaccentuated), 0-9 and the underscore (_).<br/>
  34      The length of the group name cannot exceed 32 characters (including the
  35      'group_' prefix that gets added automatically - that is, 26 free characters)<br/>
  36    </dd>
  37  </dl>
  38  
  39  <p>Once a group has been created, you can define what fields it will enclose by
  40  <a href="topic:content/rearrange">rearranging fields and groups</a>.</p>