Template:Dataformfield plugin info: Difference between revisions

From MoodleDocs
No edit summary
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 2: Line 2:


{{{description|TBC}}}
{{{description|TBC}}}
==Usage==
{{{usage|TBC}}}
==Settings==
==Settings==
{{{general settings|
{{{general settings|
===General settings===
===General settings===
*'''Name''' - Short name for the field. Since the field name is used in field patterns, long convoluted names may make the view template less readable.  
====Name====
*'''Description''' - Short description of the field purpose and characteristics to allow managers to see at a glance what each field is intended for. This description is displayed only in the field management list.  
Short name for the field. Since the field name is used in field patterns, long convoluted names may make the view template less readable.  
*'''Visibile''' – To whom the field (label and content in browse and editing modes) is visible when displaying entries (in views that contain the field pattern).
====Description====
**Managers only: Users with manageentries capability.
Short description of the field purpose and characteristics to allow managers to see at a glance what each field is intended for. This description is displayed only in the field management list.  
**Owner and managers: Users with manageentries capability and the entry author.
====Visibile====
**Everyone: All users.  
To whom the field (label and content in browse and editing modes) is visible when displaying entries (in views that contain the field pattern).
*'''Editable''' – Whether the field content can be updated by an entry author without manageentries capability.
*Managers only - Users with manageentries capability.
*'''Label''' - <nowiki>The field label allows for specifying a designated field label that can be added to the view by means of the [[fieldname@]] field pattern. This field pattern observes the field visibility and is hidden if the field is set to be hidden. The field label can also serve as a field display template and it interprets patterns of that field if included in the label. For example, with a number field called Number and the field label defined as 'You have earned [[Number]] credits.' and an entry where the number value is 47 the pattern [[Number@]] would be displayed as 'You have earned 47 credits.' </nowiki>
*Owner and managers - Users with manageentries capability and the entry author.
*Everyone - All users.  
====Editable====
Whether the field content can be updated by an entry author without manageentries capability.
====Template ====
<nowiki>The field template allows for creating a complex display of the field content by interpreting patterns of the field if included in the template. For example, with a number field called Number and the field template defined as 'You have earned [[Number]] credits.' and an entry where the number value is 47 the pattern [[Number@]] would be displayed as 'You have earned 47 credits.' The field template can also be used as a simple label for the field (rather than labels as static content in the view template) with the advantage that it observes the field visibility and is hidden if the field is set to be hidden. The field template can be added to the view by means of the [[fieldname@]] pattern.</nowiki>
}}}
}}}


Line 21: Line 24:
{{{common patterns|
{{{common patterns|
===Common field patterns===
===Common field patterns===
<nowiki>
====<nowiki>[[fieldname@]]</nowiki>====
[[field name@]]: Displays the field label/template.
Displays the field label/template.
</nowiki>


}}}
}}}
{{{other patterns|
{{{other patterns|
===Additional patterns===
This field does not provide additional patterns.
}}}
}}}
==Sort==
==Sort / Search==
{{{sort|
{{{sort search|
This field cannot be sorted.
The following field elements are available for defining sort and search criteria in [[Dataform Filters]]:
 
'''Sort'''
 
*'''Content''' – The textual content of the field.
 
'''Search'''
 
*'''Content''' – The textual content of the field.
}}}
}}}
==Search==
==Import / Export==
{{{search|
{{{import export|
This field cannot be searched.
===Settings===
*Name – The heading of the corresponding column in the csv import file. Defaults to the pattern name.
===Content===
Depending on the imported pattern.
}}}
}}}


<noinclude>
<noinclude>
Line 45: Line 56:
{{Dataformfield plugin info
{{Dataformfield plugin info
|description = Enter a short description of the field with an illustration if applicable.
|description = Enter a short description of the field with an illustration if applicable.
|usage = Enter usage description if the field provides specialized functionality in addition to or instead of the standard field functionality of displaying and updating content. For example, the dataformfield_entrystate field provides a specialized ajax functionality for changing state in browse mode. The content of this parameter resides under a level 2 Usage heading and sub-headings should start from level 3.
|general settings = Enter description of general settings if different from the base general settings. Defaults to base general settings.
|general settings = Enter description of general settings if different from the base general settings. Defaults to base general settings.
|other settings = Enter description of any other settings available in the field configuration form.
|other settings = Enter description of any other settings available in the field configuration form.
|common patterns = Enter description of common field patterns if different from the base common field patterns. Defaults to base common field patterns.
|common patterns = Enter description of common field patterns if different from the base common field patterns. Defaults to base common field patterns.
|additional patterns = Enter description of any additional patterns provided by the field if any.
|other patterns = Enter description of any additional patterns provided by the field if any. Example:
|sort = Enter list of sort elements.
===Field specific patterns===
|search = Enter list of search elements.
====pattren name====
Pattern description.
 
|sort search = Enter list of sort and search elements. Example
 
The following field elements are available for defining sort and search criteria in [[Dataform Filters]]:
 
'''Sort'''
*'''Element name'''
*'''Element name'''
'''Search'''
*'''Element name'''
*'''Element name'''
|import export =  
Enter description of import settings if different from the standard and import content.
}}
}}
</pre>
</pre>

Latest revision as of 16:26, 21 February 2014


TBC

Settings

General settings

Name

Short name for the field. Since the field name is used in field patterns, long convoluted names may make the view template less readable.

Description

Short description of the field purpose and characteristics to allow managers to see at a glance what each field is intended for. This description is displayed only in the field management list.

Visibile

To whom the field (label and content in browse and editing modes) is visible when displaying entries (in views that contain the field pattern).

  • Managers only - Users with manageentries capability.
  • Owner and managers - Users with manageentries capability and the entry author.
  • Everyone - All users.

Editable

Whether the field content can be updated by an entry author without manageentries capability.

Template

The field template allows for creating a complex display of the field content by interpreting patterns of the field if included in the template. For example, with a number field called Number and the field template defined as 'You have earned [[Number]] credits.' and an entry where the number value is 47 the pattern [[Number@]] would be displayed as 'You have earned 47 credits.' The field template can also be used as a simple label for the field (rather than labels as static content in the view template) with the advantage that it observes the field visibility and is hidden if the field is set to be hidden. The field template can be added to the view by means of the [[fieldname@]] pattern.


Patterns

Common field patterns

[[fieldname@]]

Displays the field label/template.



Sort / Search

The following field elements are available for defining sort and search criteria in Dataform Filters:

Sort

  • Content – The textual content of the field.

Search

  • Content – The textual content of the field.

Import / Export

Settings

  • Name – The heading of the corresponding column in the csv import file. Defaults to the pattern name.

Content

Depending on the imported pattern.



Copy and complete the following code to document a dataformfield plugin:

{{Dataformfield plugin info
|description = Enter a short description of the field with an illustration if applicable.
|general settings = Enter description of general settings if different from the base general settings. Defaults to base general settings.
|other settings = Enter description of any other settings available in the field configuration form.
|common patterns = Enter description of common field patterns if different from the base common field patterns. Defaults to base common field patterns.
|other patterns = Enter description of any additional patterns provided by the field if any. Example:
===Field specific patterns===
====pattren name====
Pattern description.

|sort search = Enter list of sort and search elements. Example

The following field elements are available for defining sort and search criteria in [[Dataform Filters]]:

'''Sort'''
*'''Element name'''
*'''Element name'''
'''Search'''
*'''Element name'''
*'''Element name'''
|import export = 
Enter description of import settings if different from the standard and import content.
}}