| 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> |
|---|
