Help:Page forms: Difference between revisions

| <!--T:336--> the [https://developer.mozilla.org/docs/Web/HTML/Global_attributes/autocapitalize autocapitalize]</> parameter in the corresponding HTML tag to whatever value is set for this parameter; examples include <code>on</code>, <code>off</code>, <code>sentences</code></>, etc.

:* <code>wikieditor</code> - <!--T:16--> uses the {{ll|Extension:WikiEditor|WikiEditor}}</> extension, which must be installed. <!--T:17--> Unfortunately, only one input within the form can have WikiEditor associated with it, due to a limitation in the WikiEditor extension. <!--T:18--> If you want to add any additional {{ll|Extension:WikiEditor/Toolbar_customization|custom toolbars}}</> to WikiEditor, you will need to add them in the JavaScript to <code>('#free_text').wikiEditor</code></>, just as they exist for < name=3><code>('#wpTextbox1').wikiEditor</code></>.

::<!--T:330--> Note that there was a change to the WikiEditor code in the version that corresponds to MediaWiki version 1.34 that broke this functionality. <!--T:331--> It was restored in the 1.36 version of WikiEditor, with a corresponding change in version 5.1 of Page Forms. <!--T:332--> If you are using a version somewhere in the middle for WikiEditor, and you don't want to upgrade MediaWiki, you can manually apply the necessary change to the code, which can be found [< name="url">https://github.com/Nikerabbit/mediawiki-extensions-WikiEditor/commit/9a1188d0850418d8ae64bd06b7f39d9a8cbf127f</> here]. <!--T:333--> You should also upgrade to version 5.1 or later of Page Forms if you are using an older versions; or you can apply the Page Forms patch [< name="url">https://github.com/Nikerabbit/mediawiki-extensions-PageForms/commit/41e69bbe6928ac2a85aae6a23c7be009511fcbcb</> here].

:* <code>tinymce</code> - <!--T:19--> uses the {{ll|Extension:TinyMCE|TinyMCE}}</> extension, which must be installed. <!--T:334--> This does not work with multiple-instance templates.

:* <code>visualeditor</code> - <!--T:20--> uses the {{ll|Extension:VisualEditor|VisualEditor}}</> extension, which must be installed. Another extension, {{ll|Extension:VEForAll|VEForAll}}</>, must also be installed. <!--T:24--> If you would like the toolbar to show up at the top of the edit field rather than at the bottom (default) you will also have to add  <code>|class=toolbarOnTop</code></>

| <!--T:21--> If VisualEditor is being used, specifies a maximum height (in pixels) for the textarea, since VE uses autogrow. <!--T:329--> The default value for this is set by the variable <code>$wgPageFormsVisualEditorMaxHeight</code></>, which by default is {{formatnum:400}}</>.

It is implemented using the {{ll|OOUI}}</> library.

<!--T:40--> This input is implemented using the  [< name=url>https://select2.github.io/</> Select2] JavaScript library.

<!--T:49--> To do that for a single input, add a <code>class</code></> parameter to the field tag, like "<code>|class=''ClassName''</code></>", then add something like the following to < name=3>MediaWiki:Common.css</>:

If you want this to apply to all "tokens" inputs in the wiki, add something like this to MediaWiki:Common.css</> instead:

<!--T:59--> This number is dictated by the variable <code>$wgPageFormsCheckboxesSelectAllMinimum</code></>, which by default is < name=3>{{formatnum:10}}</>, though it can be changed in LocalSettings.php</>.

<!--T:63--> The "listbox" input corresponds to the HTML &lt;select&gt;</> tag, with the "multiple" attribute added.

<!--T:71--> If the tree input is showing radiobuttons instead of checkboxes, you just need to add the parameter "|list</>" to the field tag in the form definition, to establish that this is a list.

You can see a sample form that uses this input type [< name=url>http://discoursedb.org/wiki/Form:Category_input_test</> here].

If the field specifies multiple categories, and the template uses #arraymap</> to do it, the call to #arraymap</> should look something like:

...in other words, you need to specify the final "delimiter" parameter for #arraymap</>, and make it a space, blank or something similar, to avoid printing commas between the category tags.

| <!--T:89--> specifies a "label" for this checkbox, which would go into a {{tag|label|open}}</> tag.

The "datetime</>" input is similar to the "date</>" input, but includes additional entries for hours, minutes, seconds and AM/PM.

"year</>" is a simple text input that is used to get a year-only value for a date field.

<!--T:95--> "datepicker</>" lets the user pick a date with the help of a JavaScript-based popup calendar.

| <!--T:317--> sets a custom date format, used only for the input field. <!--T:318--> An example would be <code>DD-MM-YYYY</code></>.

<!--T:322--> If your wiki is in English and you would like weeks in the calendar input to start on Monday instead of Sunday (which is the default), you can do that by setting your wiki's language to be "en-gb</>" instead of "en</>".

<!--T:97--> "datetimepicker</>" is a JavaScript-based input type very similar to "datepicker</>", but it includes popups for selecting both the date and time.

<!--T:99--> Its set of parameters includes all of those "datepicker</>" as well as the following:

The "rating</>" input type displays a set of stars to let the user enter a rating.

The "googlemaps</>", "leaflet</>" and "< name=3>openlayers</>" input types let you display a map to get a coordinate value, using the < name=4>Google Maps</>, < name=5>Leaflet</> or < name=6>OpenLayers</> services, respectively.

If you are using the "googlemaps" input, you may need to get a [< name=url>https://developers.google.com/maps/</> Google Maps API key], then set it in LocalSettings.php</> via the <code>$wgPageFormsGoogleMapsKey</code></> setting, for the input to display.

{{Note|1=<!--T:323--> Both height</> and width</> are needed together to set the dimension.}}

<!--T:145--> You can do that using the "feeds to map=" parameter - look for "feeds to map" [[Extension:Page_Forms/Defining_forms#.27field.27_tag</>|here]].

<!--T:148--> However, you can have the "openlayers" format use local JavaScript code instead, by just installing the [[Special:MyLanguage/Extension:OpenLayers</>|OpenLayers]] extension.

<!--T:110--> They are the only part of the Page Forms code that sends data externally, other than [[Special:MyLanguage/Extension:Page_Forms/Input_types#Autocompleting_on_outside_values</>|autocompleting on outside values]], though that one requires additional configuration to run.

<!--T:111--> If you have a private wiki and are very concerned about no data getting out, you may want to add the following to LocalSettings.php</>:

<!--T:113--> The "regexp</>" input type is not a true input type, but rather the ability to display another input (most often "text") with additional, regular-expression-based validation.

<!--T:114--> See [[Special:MyLanguage/Extension:Page Forms/Input types/Regexp</>|here]] for a  more detailed explanation of this input type and its parameters.