[Summary view] [Print] [Text view]

   1  <!-- $Id: add-new-field.html,v 1.1.2.3 2008/10/22 21:09:12 karens Exp $ -->
   2  <p>At the bottom of the <strong>Manage fields</strong> page for a content type,
   3  you'll find this:</p>
   4  
   5  <img src="&path&add-new-field.png">
   6  
   7  <p>In order to add a new field to a content type, you need to provide the
   8  following information:</p>
   9  <dl>
  10    <dt>Label:</dt>
  11    <dd>
  12      A human-readable name for the field. It will be used in input forms and
  13      on displayed content.<br/>
  14      All characters are allowed, including spaces, accentuated or non-european
  15      characters.
  16    </dd>
  17  
  18    <dt>Field name:</dt>
  19    <dd>
  20      A machine-readable name for the field. It is used internally to identify
  21      the field and handle database storage. When doing custom theming, it is
  22      this identifier that you'll use to refer to that field.<br/>
  23      <strong>Important:</strong> The field name cannot be changed once the field has been
  24      created.<br/>
  25      Allowed characters: a-z (unaccentuated), 0-9 and the underscore (_).<br/>
  26      The length of the field name cannot exceed 32 characters (including the
  27      'field_' prefix that gets added automatically - that is, 26 free characters)<br/>
  28    </dd>
  29  
  30    <dt>Field type:</dt>
  31    <dd>
  32      The type of data to be stored in that field.<br/>
  33      <strong>Important:</strong> The field type cannot be changed once the field has been
  34      created.<br/>
  35      The available field types depend on the modules you have enabled on your site. CCK comes with 6
  36      basic field types :
  37      <ul>
  38        <li>Text</li>
  39        <li>Integer</li>
  40        <li>Float</li>
  41        <li>Decimal</li>
  42        <li>Node reference</li>
  43        <li>User reference</li>
  44      </ul>
  45      Additional modules can be downloaded to handle other field types such as
  46      dates, files, images... Look at the
  47      <a href="http://www.drupal.org/project/cck" target="_blank"> CCK project page</a>
  48      and the <a href="http://drupal.org/project/Modules/category/88" target="_blank">complete list of CCK-related modules</a>.
  49    </dd>
  50  
  51    <dt>Widget:</dt>
  52    <dd>
  53      The form element that will be used to input data for this field on
  54      content forms : text input, select list, etc...<br/>
  55      Each field type has its own list of available widgets. When selecting a
  56      field type, the list of widgets you can select is automatically updated.
  57    </dd>
  58  </dl>