Vorlage:Classgenerator/parameter/doc
This is a documentation subpage for Vorlage:Classgenerator/parameter. It contains usage information, categories and other content that is not part of the original vorlage page. |
Description
Uses Lua: |
This is the list of parameters for the class. All data is represented here, be it data processed normally, data only to gatherd via form or data that is simply stored.
Data Storage
This template does not store any persistent data.
Parameters
This is the list of parameters for the class. All data is represented here, be it data processed normally, data only to gatherd via form or data that is simply stored.
Parameter | Beschreibung | Typ | Status | |
---|---|---|---|---|
Parameter | name | The name of the parameter. Use only upper and lowercase characters, numbers (not the first symbol), dash and underscore. | Einzeiliger Text | erforderlich |
Cardinality | cardinality | Is this a single or a multivalue field?
| Einzeiliger Text | erforderlich |
Store in cargo | cargo | Do you want to store this parameter in a cargo field? Works only, if you have a cargo table name specified in the GLOBAL section.
| Wahrheitswert | erforderlich |
Cargo hidden | cargo_hidden | If set, the field is not listed in either Special:ViewTable or Special:Drilldown, although it is still queriable. | Wahrheitswert | vorgeschlagen |
Cargo size | cargo_size | for fields of type Text, Wikitext or String, sets the size of this field, i.e. the number of characters; default is 300 | Zahlenwert | vorgeschlagen |
Cargo field type <small>[https://www.mediawiki.org/wiki/Extension:Cargo/Storing_data#Declaring_a_table [help]]</small> | cargo_type | Which type will this parameter be stored in. If you don whish to store this parameter, leave this empty. | Einzeiliger Text | erforderlich |
Description | description | A short description of this paramter. Serves mainly as a hint via tooltip to users of the form to help them fill the parameter. | Mehrzeiliger Text | erforderlich |
Label | label | The label for this parameter. Use short but descriptive text (~1-3 words). This will be placed next to the input field in the form. | Einzeiliger Text | erforderlich |
Store semantically | property | Do you want to store this parameter semantically? Works only, if you have switched semantic store on in the GLOBAL section.
| Wahrheitswert | erforderlich |
Property name | property_name | The name of your property this date is stored in - if you are using data store smw that is. NOTE: Do not use spaces, use underscrores (_) instead. | Einzeiliger Text | erforderlich |
Property type <small>[https://semantic-mediawiki.org/wiki/Help:List_of_datatypes [help]]</small> | property_type | The type of your property this date is stored in - if you are using data store smw that is. | Einzeiliger Text | erforderlich |
Severity | severity | Is this field mandatory, suggested or optional | Einzeiliger Text | erforderlich |
List of values | values | A list of values for this parameter. Depending on SEVERITY and EXISTING VALUES ONLY, the parameter maybe is restricted to this values. | Einzeiliger Text | vorgeschlagen |
Regular form parameter | sf | Should this field be present (not necessary visible, see #hidden) on the form (and therefore be available as parameter in the template)? | Wahrheitswert | erforderlich |
Template doc default | td_default | Information only present on the template documentation: to what default value will this be set? | Einzeiliger Text | vorgeschlagen |
Template doc parameter type <small>[https://www.mediawiki.org/wiki/Extension:TemplateData#Format [help]]</small> | td_type | What type should be used on the template documentation page? | Einzeiliger Text | erforderlich |
Add cargo linking | add_cargo_table_and_field | Should the 'cargo table=' and 'cargo field=' statements be added to this? Fails, if no table is secified in GENERAL-Section!
| Wahrheitswert | vorgeschlagen |
CSS class | class | The css class for the input field for this parameter | Einzeiliger Text | vorgeschlagen |
Default | default | Default value. Preset for this input field. | Einzeiliger Text | vorgeschlagen |
Hidden | hidden | Specifies that this field will be hidden in the form: used to preserve values in edited pages. | Wahrheitswert | vorgeschlagen |
Input type | input_type | Specifies the type of input this field will have in the form. | Einzeiliger Text | vorgeschlagen |
Placeholder | placeholder | Used for the text, textarea, combobox and tokens fields. Specifies help text that is displayed in the input until the user clicks on it. | Einzeiliger Text | vorgeschlagen |
Restricted | restricted | Specifies that this field will be editable only by this user group. Use 'DEFAULT' if you want this to be the globally defined restriction group. | Einzeiliger Text | vorgeschlagen |
Unique | unique | Specifies that the value entered for this field must be unique, i.e. must not be the same as any value for the SMW property (if SMW is being used) or Cargo field (if Cargo is being used) corresponding to this form field. | Wahrheitswert | vorgeschlagen |
Unique for category | unique_for_category | Specifies that the value entered for this field must not be the same as the name of any page in the given category. | Einzeiliger Text | vorgeschlagen |
Unique for concept | unique_for_concept | Specifies that the value entered for this field must not be the same as the name of any page in the given SMW concept. | Einzeiliger Text | vorgeschlagen |
Unique for namespace | unique_for_namespace | Specifies that the value entered for this field must not be the same as the name of any page in the given namespace. | Wahrheitswert | vorgeschlagen |
Uploadable | uploadable | Is this a text input field that refers to a file and do you want the user to be able to upload that file right here? | Wahrheitswert | vorgeschlagen |
Default filename | default_filename | Specifies the default filename for files uploaded with this field. | Einzeiliger Text | vorgeschlagen |
Image preview | image_preview | Specifies that a thumbnail of the uploaded image should be placed under the field in the form. | Wahrheitswert | vorgeschlagen |
textarea autogrow | autogrow | You can set a default for the autogrow attribute of your textarea fields | Wahrheitswert | vorgeschlagen |
Autozoom | autozoom | Turns autozoom feature on or off. | Einzeiliger Text | vorgeschlagen |
Base type | base_type | The base type for this regular expression field | Einzeiliger Text | vorgeschlagen |
Center | center | Allows to set the coordinates of the map's centre. When this parameter is not provided, the map will centre itself on the current location, or when not set, to coordinates 0,0. | Einzeiliger Text | vorgeschlagen |
textarea cols | cols | You can set a default for the columns attribute of your textarea fields | Zahlenwert | vorgeschlagen |
date format | date_format | The date format string. It is only used for date display in the input field. See https://www.mediawiki.org/wiki/Extension:Semantic_Forms_Inputs#Parameters for more information. | Einzeiliger Text | vorgeschlagen |
disabled dates | disable_dates | Comma-separated list of disabled dates/date ranges (dates in yyyy/mm/dd format, ranges in yyyy/mm/dd-yyyy/mm/dd format) | Einzeiliger Text | vorgeschlagen |
disabled days of week | disable_days_of_week | List of days that can not be selected (e.g. weekend: 6, 0) | Einzeiliger Text | vorgeschlagen |
Disable input field | disable_input_field | If the user shall be able to fill the input field directly or only via the menu. | Wahrheitswert | vorgeschlagen |
textarea editor | editor | You can set a default for the editor attribute of your textarea fields. As of now, semantic forms only supports wikieditor (or none). | Einzeiliger Text | vorgeschlagen |
Enable input field | enable_input_field | If the user shall be able to fill the input field directly or only via the menu. | Wahrheitswert | vorgeschlagen |
Existing values only | existing_values_only | Set a combo box or tokens to only allow the autocomplete values, and not any arbitrary values, thus having it function even more like a dropdown. | Wahrheitswert | vorgeschlagen |
first date | first_date | The first date that can be chosen (in yyyy/mm/dd format) | Einzeiliger Text | vorgeschlagen |
Geoservice | geoservice | Allows to set the geocoding service used to turn addresses into coordinates. | Einzeiliger Text | vorgeschlagen |
Height | height | Allows to set the height of the map, in pixels. | Zahlenwert | vorgeschlagen |
hide reset button | hide_reset_button | If a reset button shall be shown. This is the only way for the user to erase the input field if it is disabled for direct input. | Wahrheitswert | vorgeschlagen |
hide week numbers | hide_week_numbers | If week numbers shall be shown left of the week. | Wahrheitswert | vorgeschlagen |
highlighted dates | highlight_dates | Comma-separated list of disabled dates/date ranges that shall appear highlighted (dates in yyyy/mm/dd format, ranges in yyyy/mm/dd-yyyy/mm/dd format) | Einzeiliger Text | vorgeschlagen |
highlighted days of week | highlight_days_of_week | List of days that shall appear highlighted (e.g. weekend: 6, 0) | Einzeiliger Text | vorgeschlagen |
include timezone | include_timezone | Specifies that a time zone field should be included. | Wahrheitswert | vorgeschlagen |
last date | last_date | The last date that can be chosen (in yyyy/mm/dd format) | Einzeiliger Text | vorgeschlagen |
Mapping cargo field | mapping_cargo_field | Tries to map autocomplete values via cargo. Can only be used for fields that select pages. You have to specifiy CARGO_TABLE for this to work, as well! | Einzeiliger Text | vorgeschlagen |
Mapping cargo table | mapping_cargo_table | Tries to map autocomplete values via cargo. Can only be used for fields that select pages. You have to specifiy CARGO_FIELD for this to work, as well! | Einzeiliger Text | vorgeschlagen |
Mapping property | mapping_property | Tries to map autocomplete values via smw. Can only be used for fields that select pages. | Einzeiliger Text | vorgeschlagen |
Mapping template | mapping_template | Takes in the name of a 'mapping template' (a template that takes in a single, unnamed parameter, i.e. {{{1|}}}, and displays a 'mapped' string as a result), and uses that template to map every potential value, so that the values' 'aliases' appear on the screen, and not the values themselves. Takes only the name of the template w/o namespace. | Einzeiliger Text | vorgeschlagen |
Max values | max_values | Used for input type tokens; specifies the maximum number of values that can be entered in a field that holds multiple values. | Zahlenwert | vorgeschlagen |
Maxlength | maxlength | Used for text and textarea fields. Specifies the maximum allowed length of the input. | Zahlenwert | vorgeschlagen |
Message | message | Used as user feedback message in case the regex did not match with the input. | Einzeiliger Text | vorgeschlagen |
Regexp | regexp | If you set 'input type' to regexp, this specifies your regular expression the input has to match to be valid. This must be given including the slashes, e.g. '/^[0-9]+/'! Defaults to /.*/, i.e. any value. | Einzeiliger Text | erforderlich |
textarea rows | rows | You can set a default for the rows attribute of your textarea fields | Zahlenwert | vorgeschlagen |
show reset button | show_reset_button | If a reset button shall be shown. This is the only way for the user to erase the input field if it is disabled for direct input. | Wahrheitswert | vorgeschlagen |
Show on select | show_on_select | Can be used for inputs of type 'checkbox', 'checkboxes', 'radiobutton', 'dropdown' and 'listbox' to specify that one or more tags with a certain ID should only be displayed to the user if a certain value (or values) is selected within that input. Use entries in the form 'value=field'. Hint: If you want to calculate this dynamically later, set this field to 'false'! All fields will be prefixed by a globaly configured prefix string. See Module:SFfield/class for more information. | Mehrzeiliger Text | vorgeschlagen |
show week numbers | show_week_numbers | If week numbers shall be shown left of the week. | Wahrheitswert | vorgeschlagen |
Size | size | Used for text entries, combobox, tokens and listbox. For the first three it specifies the width, in characters; for a listbox it specifies the height. If not set, will be defaulted as set in FORM-Section. | Zahlenwert | vorgeschlagen |
Structure | structure | The structure of your menu. Please use mediawiki ul notation. * for first lavel, ** for second, ... One entry per line | Mehrzeiliger Text | erforderlich |
Values dependent on | values_dependent_on | Can be used for inputs of type 'combobox', 'text with autocomplete', 'textarea with autocomplete' and 'tokens'. Specifies that the current set of allowed values for this field are all the values taken by this same field from pages where 'field name' is equal to the value selected for 'field name' in the current form. | Einzeiliger Text | vorgeschlagen |
Values from category | values_from_category | Similar to values=, but gets its values from the names of all pages belonging to a specific category. | Einzeiliger Text | vorgeschlagen |
Values from concept | values_from_concept | Similar to values=, but gets its values from the names of all pages belonging to a specific SMW concept. | Einzeiliger Text | vorgeschlagen |
Values from namespace | values_from_namespace | Similar to values=, but gets its values from the names of all pages belonging to a specific namespace. | Einzeiliger Text | vorgeschlagen |
Week start | week_start | The first day of the week (0 - Sunday, 1 - Monday, ...) | Zahlenwert | vorgeschlagen |
Width | width | Allows to set the width of the map, in pixels. | Zahlenwert | vorgeschlagen |
Zoom | zoom | Allows to set the zoom level of the map. When not provided , the zoom will be set so you can see the entire planet. | Zahlenwert | vorgeschlagen |
Usage
{{Classgenerator
|name=
|cardinality=
|cargo=
|cargo_hidden=
|cargo_size=
|cargo_type=
|description=
|label=
|property=
|property_name=
|property_type=
|severity=
|values=
|sf=
|td_default=
|td_type=
|add_cargo_table_and_field=
|class=
|default=
|hidden=
|input_type=
|placeholder=
|restricted=
|unique=
|unique_for_category=
|unique_for_concept=
|unique_for_namespace=
|uploadable=
|default_filename=
|image_preview=
|autogrow=
|autozoom=
|base_type=
|center=
|cols=
|date_format=
|disable_dates=
|disable_days_of_week=
|disable_input_field=
|editor=
|enable_input_field=
|existing_values_only=
|first_date=
|geoservice=
|height=
|hide_reset_button=
|hide_week_numbers=
|highlight_dates=
|highlight_days_of_week=
|include_timezone=
|last_date=
|mapping_cargo_field=
|mapping_cargo_table=
|mapping_property=
|mapping_template=
|max_values=
|maxlength=
|message=
|regexp=
|rows=
|show_reset_button=
|show_on_select=
|show_week_numbers=
|size=
|structure=
|values_dependent_on=
|values_from_category=
|values_from_concept=
|values_from_namespace=
|week_start=
|width=
|zoom=
}}
See also
- {{Classgenerator}}