Difference between revisions of "Custom Fields"
| Line 23: | Line 23: | ||
:The following field types are available: | :The following field types are available: | ||
| − | {| | + | {|border=3 |
|- | |- | ||
!Field | !Field | ||
Revision as of 05:19, 1 October 2008
Custom fields include new field definitions that can be created on the fly as a tool to allow customization of certain site functions to cater to specific client needs. These fields can be created by administrators and are then available for content managers.
Areas of the site the support custom fields
- Users
- (via the user tab in “settings”).
- User custom fields created will be available to apply to all users in the system.
- Pages
- (via “page template management”).
- Page custom field settings will be available to all pages that use the template(s) in which the custom fields are created.
Custom Field Attributes
Each custom field created asks for the following attributes:
- Field Name
- this is the suffix that will be used when calling on the field (ex: set to “myField” if you want to access it via “custom_field_myField”). This must follow traditional PHP variable name requirements (must begin with a letter, contain only letters, numbers, underscores).
- Location
- this dictates where in the administration form the field will display relative to permanent fields. Enter the target field name and the word “before” or “after” to dictate where it will appear relative to the target field name. For instance, to place the new custom field after the title field in page management enter “after title”, or to have the field appear before the first name field in user management enter “before firstName”. This entry will have no effect on template managed forms as the fields display and their order will be dictated by the template manager.
- Title
- this dictates the description of the field in the administration form. When is entered here is exactly what the content manager will see adjacent to the field itself, describing the field. HTML is supported in this field.
- Default
- sets the default value of the field.
- Settings
- controls the field type and attributes.
- The following field types are available:
| Field | Attributes | Example* |
|---|---|---|
| text | attributes | Text:size=20 maxlength=50 |
| Radio | Attributes:value | Radio:onClick=”function();”:1
Radio::2 |
| Button | Attributes:value | Button:onClick=”function();” style=”styledata”:Click me
Button::Click here |
| Submit | Attributes:value | Submit:onClick=”checkForm();”:submit
Submit::Go! Page (modified text field) Used to allow selection of a page from the page library, includes pop up link to select a page. attributes Page:size=20 maxlength=50 Image (modified text field) Used to allow selection of an image. Includes link to image library for selection and presentation of selected image below field. attributes Image:size=20 maxlength=50 Password Attributes Password:size=20 maxlength=50 File Presented file field. If type is “image” than also presents the image itself below the field. Attributes:type(image,other) File:size=20 maxlength=50:other Hidden Value Hidden:my hidden value Checkbox Attributes:value Checkbox:onClick=”myfunction();”:1 Checkbox::0 Textarea Attributes Textarea:cols=50 rows=4 Select Options are delimited by colon “:”. Value / Text pairs are delimited by pipe “|” where value is before the pipe, text after. If no pipe is presented BOTH the value and text will be the entered value. Attributes:val1[|text1[:val2[|text2]]]… Select:size=4:value1|text1:value2|text2 Select:multiple:valueA:valueB:valueC Select::1|one:2|two:3|three:4|four SepDate Creates drop downs for month / day / year ~none~ sepdate SepDateTime Creates drop downs for month / day / year hour : minute ~none~ sepdate |
