Help310

Help310:Components Fields Fields Edit

From Joomla! Documentation

Revision as of 05:40, 5 May 2017 by FuzzyBot (talk | contribs) (Importing a new version from external source)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎français

How to Access

To add a new field for articles, users or contacts, navigate to the backend of the site and perform one of these actions:

Articles

  • Select Content  Fields from the drop-down menu of the Joomla! Administrator Panel.

or

  • Select Content  Articles from the drop-down menu of the Joomla! Administrator Panel.
  • Click the Fields link while viewing the Articles Manager in the leftsidebar.

Users

  • Select Users  Fields from the drop-down menu of the Joomla! Administrator Panel.

or

  • Select Users  Manage from the drop-down menu of the Joomla! Administrator Panel.
  • Click the Fields link while viewing the Users Manager in the leftsidebar.

Contacts

  • Select Components  Contacts from the drop-down menu of the Joomla! Administrator Panel.
  • Click the Fields link while viewing the Contacts Manager in the leftsidebar.

Description

This is the back-end screen where you can add and edit Fields. The same screen is used for adding a new Field and editing an existing Field. You can also select the Field Group for a Field and indicate whether or not it is Published and if it is assigned to one or more Article Category.

Screenshot

Help-3x-content-field-add-new-field-en.png

Details

General

This section allows you to enter parameters for this Field.

  • Title. The name or title of the custom field. Make it as descriptive as possible.

These entries are optional. Joomla! automatically creates default entries for these values.

Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Name. The Name will be used to identify the custom field. Leave this blank and Joomla will fill in a default value from the title.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Label. The label of the field to display. If blank auto-generated from title.
  • Description. A description of the custom field that will be displayed in the label tooltip.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Required. (Yes/No). Is this a mandatory field.

Depending on the Type:

Type: Calendar:

Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Default Date. The default date of the field. The value can be an ISO 8601 format (YYYY-MM-DD HH:MM:SS) or NOW, which displays the actual date.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Show Time. (Yes/No) If enabled, the calendar field expects a date and time and will also display the time. The formats are localised using the regular language strings.

Type: Checkboxes:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Checkbox Values. The values of the checkboxes. Enter the label and the value. Through the images at the end you can add, delete or move values Help30-colheader-Checkbox-Values-en.png

Type: Colour:

  • Default Value. The default value of the field.

Type: Editor:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Show Buttons. (Use settings from Plugin/Yes/No) Should the editor-xtd plugin buttons be shown.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Hide Buttons. Select some options.
Help30-colheader-Hide-Buttons-en.png
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Width. Defines the width (in pixels) of the WYSIWYG editor and defaults to 100%.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Height. Defines the height (in pixels) of the WYSIWYG editor and defaults to 250px.
  • Filter. (Use settings from Plugin/No/Raw/Safe HTML/Text/Alpha Numeric/Integer/Float/Telephone) Allow the system to save certain html tags or raw data.

Type: Integer:

  • Default Value. The default value of the field.
  • Multiple. (Use settings from Plugin/Yes/No) Allow multiple values to be selected.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • First. This value is the lowest on the list.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Last. This value is the highest on the list.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Step. Each option will be the previous option incremented by this integer, starting with the first value until the last value is reached.

Type: List:

  • Default Value. The default value of the field.
  • Multiple. (Use settings from Plugin/Yes/No) Allow multiple values to be selected.
  • List Values. The values of the list. Enter the label and the value. Through the images at the end you can add, delete or move values.
    Help30-colheader-Checkbox-Values-en.png

Type: List of Images:

  • Default Value. The default value of the field.
  • Directory. (Use settings from Plugin/...) The filesystem path to the directory containing the image files to be listed relative to the default image folder.
  • Multiple. (Use settings from Plugin/Yes/No) Allow multiple values to be selected.
  • Image Class. The class which is added to the image (src tag).

Type: Media:

  • Default Value. The default value of the field.
  • Directory. (Use settings from Plugin/...) The filesystem path to the directory containing the image files to be listed relative to the default image folder.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Preview. (Use settings from Plugin/Tooltip/Inline/No) Shows or hides the preview of the selected image.
  • Image Class. The class which is added to the image (src tag).

Type: Radio:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Radio Values. The values of the radio list. Enter the label and the value. Through the images at the end you can add, delete or move values Help30-colheader-Checkbox-Values-en.png

Type: SQL:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Query. The SQL query which will provide the data for the dropdown list. The query must return two columns; one called 'value' which will hold the values of the list items; the other called 'text' containing the text in the dropdown list.
  • Multiple. (Use settings from Plugin/Yes/No) Allow multiple values to be selected.

Type: Text:

  • Default Value. The default value of the field.
  • Filter. (Use settings from Plugin/No/Raw/Safe HTML/Text/Alpha Numeric/Integer/Float/Telephone) Allow the system to save certain html tags or raw data.
  • Maximum Length. The maximum number of characters that can be entered.

Type: Text Area:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Rows. The height of the visible text area in lines. If omitted the height is determined by the browser. The value does not limit the number of lines that may be entered.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Columns. The width of the visible text area in characters. If omitted the width is determined by the browser. The value does not limit the number of characters that may be entered.
  • Maximum Length. The maximum number of characters that can be entered.
  • Filter. (Use settings from Plugin/No/Raw/Safe HTML/Text/Alpha Numeric/Integer/Float/Telephone) Allow the system to save certain html tags or raw data.

Type: URL:

  • Default Value. The default value of the field.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Schemes. The allowed schemes.
Help30-colheader-Schemes-en.png
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Relative. (Use settings from Plugin/Yes/No) Are relative URLs allowed.

Type: User:

Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Default User. The default user.

Type: User Groups:

Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Default User Groups. A comma separated list of user group IDs.
  • Multiple. (Use settings from Plugin/Yes/No) Allow multiple values to be selected.

Options

Help30-Content-Article-Manager-Field-publishing-options-subscreen-en.png

Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Placeholder. Placeholder text which will appear inside the field as a hint to the user for the required input.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Render Class. The class attributes of the field when the field is rendered. If multiple classes are needed, list them with spaces.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Label Class. The class of the label in the form. If multiple classes are needed, list them with spaces.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Show Label. (Show/Hide). Show or Hide the label when the field renders.


  • Show On. (Site/Administrator/Both). On which part of the site should the field be shown. Note: Only the type User does not have Show on.
Delete-icon.png
This Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: No links here.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by FuzzyBot (talk · contrib) · Last edited on Fri, 05 May 2017 05:40:04 +0000


  • Automatic Display. (After Title/Before Display/After Display/No). Joomla offers some content events which are tiggered during the content creation process. This is the place to define how the custom fields should be integrated into content.

Only the type User does not have Show on.

Publishing

Help30-Content-Article-Manager-Field-publishing-publisching-subscreen-en.png

  • Created Date. Date the item was created.
  • Created By. Name of the Joomla User who created the item. This will default to the currently logged-in user. If you want to change this to a different user, click the 'Select User' button Help30-select-user-en.png.
  • Modified Date. (Informative only) Date of last modification.
  • Modified By. (Informative only) Username who performed the last modification.
  • ID. This is a unique identification number for this item assigned automatically by Joomla. It is used to identify the item internally, and you cannot change this number.

Permissions

Joomla lets you set permissions for fields at four levels, as follows.

  1. Globally, using Global Configuration.
  2. For all articles, using Article Manager→Options.
  3. For all articles in a category, using Category Manager.
  4. For an individual article, using Article Edit.

This is where you can enter permissions for this one field. The screen shows as follows.

Help30-screenshot-article-field-permissions-subscreen-en.png

To change the permissions for this field, do the following.

  1. Select the Group by clicking its title.
  2. Find the desired Action. Possible Actions are:
    Delete. Users can delete this field.
    Edit. Users can edit this field.
    Edit State. User can change the published state and related information for this field.
    Edit Custom Field Value. Users can edit the Custom field value.
  3. Select the desired permission for the action you wish to change. Possible settings are:
    Inherited. Inherited for users in this Group from the Global Configuration, Article Manager Options, or Category permissions.
    Allowed. Allowed for users in this Group. Note that, if this action is Denied at one of the higher levels, the Allowed permission here will not take effect. A Denied setting cannot be overridden.
    Denied. Denied for users in this Group.
  4. Click Save. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.

Toolbar

At the top, you will see the toolbar:

Help30-Save-SaveClose-SaveNew-Cancel-Help-toolbar-en.png The functions are:

  • Save. Saves the field group and stays in the current screen.
  • Save & Close. Saves the field group and closes the current screen.
  • Save & New. Saves the field group and keeps the editing screen open and ready to create another field group.
  • Cancel. Closes the current screen and returns to the previous screen without saving any modifications you may have made.
  • Help. Opens this help screen.

Quick Tips

Related Information