[Summary view] [Print] [Text view]

   1  <!-- $Id: add-existing-field.html,v 1.1.2.4 2008/10/22 21:09:12 karens Exp $ -->
   2  <p>Using a field across several content type can be handy if a piece of data
   3  is relevant for several content types. A typical use case is a 'Phone number'
   4  field, used in both 'Restaurant' and 'Hotel' content types, even if hotels
   5  and restaurants are different enough to deserve their own specific set of
   6  fields and thus their own dedicated content types.</p>
   7  
   8  <p>When a field has been added to more than one content type, we also say it is
   9  "shared", and that it as "several instances".</p>
  10  
  11  <p>At the bottom of the <strong>Manage fields</strong> page for a content type,
  12  you'll find this:</p>
  13  
  14  <img src="&path&add-existing-field.png">
  15  
  16  <p>In order to add a new instance of an existing field to a content type, you
  17  need to provide the following information:</p>
  18  <dl>
  19    <dt><strong>Label:</strong></dt>
  20    <dd>
  21      A human-readable name for the field. It will be used in input forms and
  22      on displayed content.<br/>
  23      All characters are allowed, including spaces, accentuated or non-european
  24      characters.<br/>
  25    </dd>
  26  
  27    <dt><strong>Field:</strong></dt>
  28    <dd>
  29      The field to be shared.<br/>
  30      A field cannot appear more than once in each content type. Thus, only
  31      fields that are not already present in the current content type will be
  32      proposed as "shareable". If none, the <strong>Add existing field</strong>
  33      option is not available on the <strong>Manage fields</strong> page for
  34      this content type.<br/>
  35      Selecting a field automatically populates the <strong>Label</strong> and
  36      <strong>Widget</strong> values with the ones used by the previous field
  37      instance, but you can change them if needed before submitting the form.
  38    </dd>
  39  
  40    <dt><strong>Widget:</strong></dt>
  41    <dd>
  42      The form element that will be used to input data for this field on
  43      content forms : text input, select list, etc...<br/>
  44      Each field type has its own list of available widgets. When selecting a
  45      field to share, the list of widgets you can select is automatically updated.
  46    </dd>
  47  </dl>