DevOps:Doc/FlexForm/2.5/Form options - Revision history

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: /* add-as-job */

2025-08-27T08:56:35Z

add-as-job

← Older revision		Revision as of 10:56, 27 August 2025
Line 226:		Line 226:
	<hr>		<hr>
	==== '''add-as-job''' ====		==== '''add-as-job''' ====
	As of version 2.5.5 you can tell FlexForm to add any '''_edit''' actions to MediaWiki jobs. This is especially handy if you have one form doing over 30+ edits to one or several pages. All activity concerning jobs created and ran will be logged to the FlexForm logbook. For information on checking these logs : [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogFile $wgDebugLogFile]] and [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogGroups $wgDebugLogGroups]] and [[https://www.mediawiki.org/wiki/Manual:How_to_debug Manual:How to debug]].		As of version 2.6.0 you can tell FlexForm to add any '''_edit''' actions to MediaWiki jobs. This is especially handy if you have one form doing over 30+ edits to one or several pages. All activity concerning jobs created and ran will be logged to the FlexForm logbook. For information on checking these logs : [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogFile $wgDebugLogFile]] and [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogGroups $wgDebugLogGroups]] and [[https://www.mediawiki.org/wiki/Manual:How_to_debug Manual:How to debug]].

	<hr>		<hr>

	===Examples===		===Examples===
	Example 1 : formtarget		Example 1 : formtarget

3f181944-9694-4c7c-83d3-a6193204adb3: added restrictions parameter

2025-08-26T08:16:20Z

added restrictions parameter

← Older revision		Revision as of 10:16, 26 August 2025
Line 64:		Line 64:

	<hr>		<hr>

			==== restrictions ====

			====== Render form for anonymous user ======
			By default, a FlexForm form is never rendered for an anonymous user. You can change this by adding a restrictions="lifted" to a Form tag. This can be useful for e.g. a contact form or questionnaire. Be sure to setup the build-in reCaptcha options in Flexform when allowing anonymous form submit!

			When creating a user input in a Form, FlexForm will by default always filter the input for html, JavaScript or malicious code. You can however specify per input what is allowed and what is not. More information here : [[DevOps:Doc/FlexForm/2.0/input/search\|Default input HTML attribute]]

			Especially when you have a "closed" wiki, where people need to register and will get their rights through user groups, it is a good option just not to show a Form to someone from a user group that is not allowed to use it.<hr>

	==== no_submit_on_return ====		==== no_submit_on_return ====

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295 at 06:47, 26 August 2025

2025-08-26T06:47:38Z

← Older revision		Revision as of 08:47, 26 August 2025
Line 217:		Line 217:
	<hr>		<hr>
	==== '''add-as-job''' ====		==== '''add-as-job''' ====
	As of version 2.5.5 you can tell FlexForm to add any '''_edit''' actions to MediaWiki jobs. This is especially handy if you have one form doing over 30+ edits to one or several pages. All activity concerning jobs created and ran will be logged to the FlexForm logbook. For information on checking these logs : https://www.mediawiki.org/wiki/Manual:$wgDebugLogFile and https://www.mediawiki.org/wiki/Manual:$wgDebugLogGroups and https://www.mediawiki.org/wiki/Manual:How_to_debug.		As of version 2.5.5 you can tell FlexForm to add any '''_edit''' actions to MediaWiki jobs. This is especially handy if you have one form doing over 30+ edits to one or several pages. All activity concerning jobs created and ran will be logged to the FlexForm logbook. For information on checking these logs : [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogFile $wgDebugLogFile]] and [[https://www.mediawiki.org/wiki/Manual:$wgDebugLogGroups $wgDebugLogGroups]] and [[https://www.mediawiki.org/wiki/Manual:How_to_debug Manual:How to debug]].

	<hr>		<hr>

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295 at 06:45, 26 August 2025

2025-08-26T06:45:21Z

← Older revision		Revision as of 08:45, 26 August 2025
Line 9:		Line 9:
	===Parameters===		===Parameters===

	==== ~~'''~~action~~'''~~ ====		==== action ====

	====== ''Action telling Flexform what this form is for'' ======		====== Action telling Flexform what this form is for ======
	There are three options :		There are three options :
	* '''addToWiki''' : If no action is set, this is the default action. It will expect _create or _edit input telling it what to do with the form		* '''addToWiki''' : If no action is set, this is the default action. It will expect _create or _edit input telling it what to do with the form
Line 17:		Line 17:
	* '''email''': Same as addToWiki, except now FlexForm will also look for the email options inside a form		* '''email''': Same as addToWiki, except now FlexForm will also look for the email options inside a form

	==== ~~'''~~formtarget~~'''~~ ====		==== formtarget ====

	====== ''Change the html post action to a custom one'' ======		====== Change the html post action to a custom one ======
	In some rare cases you might want to create a FlexForm, but not have FlexForm handle the post data. In that case use formtarget="your url here" to tell html form where to go when someone submits the data.		In some rare cases you might want to create a FlexForm, but not have FlexForm handle the post data. In that case use formtarget="your url here" to tell html form where to go when someone submits the data.

Line 27:		Line 27:
	<hr>		<hr>

	==== ~~'''~~messageonsuccess~~'''~~ ====		==== messageonsuccess ====

	====== ''Show a custom message when form is successfully posted'' ======		====== Show a custom message when form is successfully posted ======
	It's sometimes handy to show a custom message when a form has been successfully posted, especially when after a post you return to the same form page.		It's sometimes handy to show a custom message when a form has been successfully posted, especially when after a post you return to the same form page.

Line 37:		Line 37:
	<hr>		<hr>

	==== ~~'''~~attachmessageto~~'''~~ ====		==== attachmessageto ====

	====== ''Where to show the message'' ======		====== Where to show the message ======
	By default, except for Ajax form submit, the default ''MediaWiki Message notifier'' is used to show your '''messageonsuccess''' or any of the other messages FlexForm might give (e.g. an error). Sometimes it can be handy to control where the notification pops-up, instead of the default right-top. You can use '''attachmessageto''' to attach the notification to an id of a certain HTML element. The notification will happen there. E.g. <code><nowiki><form attachmessageto="#my-unique-id"></nowiki></code>		By default, except for Ajax form submit, the default ''MediaWiki Message notifier'' is used to show your '''messageonsuccess''' or any of the other messages FlexForm might give (e.g. an error). Sometimes it can be handy to control where the notification pops-up, instead of the default right-top. You can use '''attachmessageto''' to attach the notification to an id of a certain HTML element. The notification will happen there. E.g. <code><nowiki><form attachmessageto="#my-unique-id"></nowiki></code>
	<hr>		<hr>

	==== ~~'''~~mwreturn~~'''~~ ====		==== mwreturn ====

	====== ''Redirect to this page after submitting the form'' ======		====== Redirect to this page after submitting the form ======
	When a form is submitted FlexForm will return to the page the Form was submitted from. You can change it to go to another page ( like a thank-you page for example ) by setting mwreturn. mwreturn="Thank-you-page". Provide a URL (the [https://www.mediawiki.org/wiki/Help:Magic_words#URL_data <code>localurl</code> and <code>fullurl</code> magic words] may come in handy).		When a form is submitted FlexForm will return to the page the Form was submitted from. You can change it to go to another page ( like a thank-you page for example ) by setting mwreturn. mwreturn="Thank-you-page". Provide a URL (the [https://www.mediawiki.org/wiki/Help:Magic_words#URL_data <code>localurl</code> and <code>fullurl</code> magic words] may come in handy).

	<hr>		<hr>

	==== ~~'''~~permissions~~'''~~ ====		==== permissions ====

	====== ''Overrule user permission on page edit or page create'' ======		====== Overrule user permission on page edit or page create ======
	'''Since version 2.1.12'''		'''Since version 2.1.12'''

Line 65:		Line 65:
	<hr>		<hr>

	==== ~~'''~~no_submit_on_return~~'''~~ ====		==== no_submit_on_return ====

	====== ''Disable enter key for submitting a form'' ======		====== Disable enter key for submitting a form ======
	A HTML form usually gets submitted on pressing enter when there's like one text field. To disable that use the no_submit_on_return option.		A HTML form usually gets submitted on pressing enter when there's like one text field. To disable that use the no_submit_on_return option.
	This will add some JavaScript to the form disabling form submission on typing an enter.		This will add some JavaScript to the form disabling form submission on typing an enter.
Line 74:		Line 74:
	<hr>		<hr>

	==== ~~'''~~recaptcha-v3-action~~'''~~ ====		==== recaptcha-v3-action ====
	===== ~~'''~~recaptcha-action ( since v.2.2.11 ) =====		===== recaptcha-action ( since v.2.2.11 ) =====

	====== Use reCaptcha Version 3 on a flexform ======		====== Use reCaptcha Version 3 on a flexform ======

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295 at 06:43, 26 August 2025

2025-08-26T06:43:40Z

← Older revision		Revision as of 08:43, 26 August 2025
Line 214:		Line 214:
	==== '''no_disable_on_submit''' ====		==== '''no_disable_on_submit''' ====
	When a form is submitted, the submit button will be set to disabled and a spinner is shown. To disable this behavior, you can add the '''no_disable_on_submit''' argument.		When a form is submitted, the submit button will be set to disabled and a spinner is shown. To disable this behavior, you can add the '''no_disable_on_submit''' argument.

			<hr>
			==== '''add-as-job''' ====
			As of version 2.5.5 you can tell FlexForm to add any '''_edit''' actions to MediaWiki jobs. This is especially handy if you have one form doing over 30+ edits to one or several pages. All activity concerning jobs created and ran will be logged to the FlexForm logbook. For information on checking these logs : https://www.mediawiki.org/wiki/Manual:$wgDebugLogFile and https://www.mediawiki.org/wiki/Manual:$wgDebugLogGroups and https://www.mediawiki.org/wiki/Manual:How_to_debug.

	<hr>		<hr>

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: User:Fd4138e7-8b46-4c8f-99bf-d4b738ebc295

2025-08-21T13:14:02Z

Charlot Cobben

ws-class-props
← Older revision		Revision as of 15:14, 21 August 2025
Line 2:		Line 2:
	\|Subject version=2.5		\|Subject version=2.5
	\|Doc subject=DevOps:Doc/FlexForm		\|Doc subject=DevOps:Doc/FlexForm
			\|Doc synopsis=Arguments a FlexForm takes
			\|Doc parent=
			\|Doc sort order=50
			\|Doc target group=User
	}}		}}

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: User:Fd4138e7-8b46-4c8f-99bf-d4b738ebc295

2025-08-21T13:13:34Z

Charlot Cobben

ws-base-props
← Older revision		Revision as of 15:13, 21 August 2025
Line 1:		Line 1:
	{{Base properties		{{Base properties
	\|Title=~~Form_options~~		\|Title=Form options
	\|Class=Doc		\|Class=Doc
	}}		}}

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295 at 13:12, 21 August 2025

2025-08-21T13:12:39Z

Show changes

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: User:Fd4138e7-8b46-4c8f-99bf-d4b738ebc295

2025-08-21T13:12:23Z

Charlot Cobben

New page