User:Dan Bolser/Extension:Semantic Forms/Manual/The forminput parser function
The forminput parser function lets the user add or edit a given page with a form. When called, it creates a small HTML form that is submitted to Special:AddData. The parser function has the following basic usage:
{{ #forminput : form= | size | value | button text= | query string }}
All five arguments are optional.
- form
- The name of the form to be used to add or edit the given page. The form name should be given without the 'Form:' namespace prefix. i.e. 'Book' and not 'Form:Book'. (E.g., {{ #forminput : form=Book }}
- size
- The size of the text input field in the HTML form (default is 25).
- value
- The default value of the input field (default is blank).
- button text
- The text that will appear on the "submit" button (default is ...).
- query string
- The query string defines a set of values that get passed to the form (via Special:AddData).
autocomplete on category
The query string explained
[edit]The query string allows you to preload a form with a set of values. It should look like a typical URL query string; an example would be 'namespace=User&User[Is_employee]=yes'.
Query string parameters:
- namespace
- Used for adding or editing pages in a specific namespace. e.g. 'namespace=User' will create the given page in the 'User' namespace.
- super page
- Used for adding or editing pages in a specific subpage. e.g. 'super page=Manual' will create a page like 'Manual/page name'.
- template-name[field-name]
- Used for passing a specific value to a specific field in the form. e.g. 'Book[pages]=99'.
- preload
- (Advanced option!) This will preload the form with the contents of the given page. e.g. 'preload=stock page'. For more information, see Preloading data.
The query string can use magic words and other dynamic values, such as {{PAGENAME}}. This is a very powerful feature. For some examples, see: http://smw.referata.com/wiki/Special:BrowseData/Tips