DevOps:Doc/FlexForm/2.1/input/file - Revision history

Ebc16062-dd09-4928-8cf3-821f492b0c44 at 08:59, 27 March 2026

2026-03-27T08:59:21Z

← Older revision		Revision as of 10:59, 27 March 2026
Line 44:		Line 44:
	=== action="convertfrom:????" ===		=== action="convertfrom:????" ===
	====Pandoc====		====Pandoc====
	The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.		The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have [https://pandoc.org/ Pandoc] installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.

	Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.		Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.
Line 61:		Line 61:
	</syntaxhighlight>		</syntaxhighlight>

	* FlexForm convert example : <syntaxhighlight lang="php">		* FlexForm convert example (using [https://pandoc.org/lua-filters.html Pandoc Lua filter]) : <syntaxhighlight lang="php">
	<input type="file" id="docxUpload" name="docx" target="File:[filename].docx" pagecontent="" required="required" action="convertfrom:docx\|uploadoriginalas:[target]\|convertto:mediawiki\|additional-arguments:lua-filter=[path]fix-headings.lua" />		<input type="file" id="docxUpload" name="docx" target="File:[filename].docx" pagecontent="" required="required" action="convertfrom:docx\|uploadoriginalas:[target]\|convertto:mediawiki\|additional-arguments:lua-filter=[path]fix-headings.lua" />
	</syntaxhighlight>		</syntaxhighlight>

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: /* Pandoc */

2026-03-25T14:35:34Z

Pandoc

← Older revision		Revision as of 16:35, 25 March 2026
Line 47:		Line 47:

	Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.		Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.

			'''Since version 2.8.0'''

			* There is now also a '''convertto''' option. You now also need to define in local settings what '''convertfrom''' is allowed and what '''convertto''' is allowed. See [[DevOps:Doc/FlexForm/2.0/Installation of FlexForm\|DevOps:Doc/FlexForm/2.0/Installation of FlexForm.]] There two new options for Pandoc conversion : '''uploadoriginalas''' and '''additional-arguments.'''
			* '''uploadoriginalas''' : added by using a pipe e.g. '''\|uploadoriginalas:''' This will allow the original document to also be uploaded into the wiki, besides it also having a converted version. After the ":" you type the name for the to be uploaded file. You can use [filename] to have it uploaded by its original filename. You can also use [target], it will then upload it using the same name as the converted document.
			* '''additional-argumen'''t : Lets you use additional Pandoc argument when converting. See the Pandoc documentation. You also have to define what additional arguments are allowed in the local settings. '''[path]''' inside additional-argument will be replace with the Wiki installation path.
			* Local Settings example :<syntaxhighlight lang="php5">
			$wgFlexFormConfig['pandoc-convert-to'][] = 'mediawiki';
			$wgFlexFormConfig['pandoc-convert-to'][] = 'html';
			$wgFlexFormConfig['pandoc-convert-from'][] = 'docx';
			$wgFlexFormConfig['pandoc-convert-from'][] = 'ppt';
			$wgFlexFormConfig['pandoc-allow-additional-arguments'][] = 'lua-filter';
			</syntaxhighlight>

			* FlexForm convert example : <syntaxhighlight lang="php">
			<input type="file" id="docxUpload" name="docx" target="File:[filename].docx" pagecontent="" required="required" action="convertfrom:docx\|uploadoriginalas:[target]\|convertto:mediawiki\|additional-arguments:lua-filter=[path]fix-headings.lua" />
			</syntaxhighlight>



	====Excel ( since version 2.2.9 )====		====Excel ( since version 2.2.9 )====

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: Undo revision 3915 by Pagesync (talk)

2026-02-23T14:21:38Z

Undo revision 3915 by Pagesync (talk)

← Older revision		Revision as of 16:21, 23 February 2026
Line 45:		Line 45:
	====Pandoc====		====Pandoc====
	The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.		The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.

			Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.

	====Excel ( since version 2.2.9 )====		====Excel ( since version 2.2.9 )====
	You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).		You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).

Pagesync: Imported by PageSync

2026-02-18T08:22:17Z

Imported by PageSync

← Older revision		Revision as of 10:22, 18 February 2026
Line 45:		Line 45:
	====Pandoc====		====Pandoc====
	The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.		The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.

	Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.

	====Excel ( since version 2.2.9 )====		====Excel ( since version 2.2.9 )====
	You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).		You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295: /* Pandoc */

2026-02-13T08:30:57Z

Pandoc

← Older revision		Revision as of 10:30, 13 February 2026
Line 45:		Line 45:
	====Pandoc====		====Pandoc====
	The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.		The '''action''' argument defaults to ''upload''. If you use '''action="convertfrom:????"''' and you have Pandoc installed on your system, FlexForm will convert a document and create it as a page in the Wiki. '''target''' will then be used as a Page Title. Depending on your version of Pandoc, the results might differ. '''convertfrom''' allows all Pandoc to MediaWiki text conversions. '''docx''' would be a good example : action="convertfrom:docx". Any images uploaded during the convert can have their content of their filepages be filled using '''pagecontent'''. Since version 2.2.9 you can also add an argument '''slot="<name of slot>"''' to have the converted Document be save to a specific slot on the target page, instead of the main slot. Keep in mind, MediaWiki slots need to be defined in your LocalSettings.

			Since '''version 2.7.0''' you have two new arguments when using Pandoc conversion : '''pandoc_prefix''' and '''pandoc_suffix'''. As your converted (word) document will become a Wiki page, you might want to add some text before or after the converted content ( e.g. a template ). '''pandoc_prefix''' will add content at the top of the converted page and '''pandoc_suffix''' will add it to the end of the converted document.

	====Excel ( since version 2.2.9 )====		====Excel ( since version 2.2.9 )====
	You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).		You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).

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

2025-08-26T07:57:05Z

Charlot Cobben

ws-class-props
← Older revision		Revision as of 09:57, 26 August 2025
Line 1:		Line 1:
	{{Csp class properties		{{Csp class properties
	\|Subject version=2.1		\|Subject version=2.1,2.5
	\|Doc subject=DevOps:Doc/FlexForm		\|Doc subject=DevOps:Doc/FlexForm
	\|Doc parent=DevOps:Doc/FlexForm/1.0/input		\|Doc parent=DevOps:Doc/FlexForm/1.0/input

Maintenance script: Imported by PageSync

2025-07-15T08:35:40Z

Imported by PageSync

ws-class-props
← Older revision		Revision as of 10:35, 15 July 2025
Line 1:		Line 1:
	{{~~Doc~~ properties		{{Csp class properties
	\|Subject version=2.1		\|Subject version=2.1
	\|Doc subject=DevOps:Doc/FlexForm		\|Doc subject=DevOps:Doc/FlexForm

3f181944-9694-4c7c-83d3-a6193204adb3: Reverted edits by 3f181944-9694-4c7c-83d3-a6193204adb3 (talk) to last revision by Fd4138e7-8b46-4c8f-99bf-d4b738ebc295

2025-06-16T08:46:25Z

Reverted edits by 3f181944-9694-4c7c-83d3-a6193204adb3 (talk) to last revision by Charlot Cobben

← Older revision		Revision as of 10:46, 16 June 2025
Line 23:		Line 23:

	'''force ''': Force images to a certain format (png, jpg or gif). When using this option, any file uploaded that is not supported will be uploaded as is.		'''force ''': Force images to a certain format (png, jpg or gif). When using this option, any file uploaded that is not supported will be uploaded as is.

	~~'''accept''': Only accept files of a certain format.~~

	'''error_id ''': Id of a DOM Element where error notices will be shown		'''error_id ''': Id of a DOM Element where error notices will be shown

3f181944-9694-4c7c-83d3-a6193204adb3: Added accept attribute which is already supported by file input

2025-06-16T08:31:16Z

Added accept attribute which is already supported by file input

← Older revision		Revision as of 10:31, 16 June 2025
Line 23:		Line 23:

	'''force ''': Force images to a certain format (png, jpg or gif). When using this option, any file uploaded that is not supported will be uploaded as is.		'''force ''': Force images to a certain format (png, jpg or gif). When using this option, any file uploaded that is not supported will be uploaded as is.

			'''accept''': Only accept files of a certain format.

	'''error_id ''': Id of a DOM Element where error notices will be shown		'''error_id ''': Id of a DOM Element where error notices will be shown

Fd4138e7-8b46-4c8f-99bf-d4b738ebc295 at 09:31, 27 March 2025

2025-03-27T09:31:42Z

← Older revision		Revision as of 11:31, 27 March 2025
Line 48:		Line 48:
	You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).		You can also use '''action="convertfrom:xls"''' or '''action="convertfrom:xlsx"'''. This allows for converting an Excel xls or xlsx file to JSON. Images are not supported. The argument '''slot''' is supported. ''This conversion is not done using Pandoc and thus will work without having Pandoc installed''. (just make sure you run composer update after you update FlexForm).

	As off v2.4.0 the Excel convert action has two extra parameters that allow you to choose a Excel Sheet name, if the Excel document has multiple sheets. '''sheet_by_id''' and '''sheet_by_name'''. If you do not use them, it will work as '''sheet_by_id="0"''' (making it backwards compatible). If you use both arguments, then '''sheet_by_name''' will get the priority.		As off v2.4.0 the Excel convert action has two extra parameters that allow you to choose an Excel Sheet name, if the Excel document has multiple sheets. '''sheet_by_id''' and '''sheet_by_name'''. If you do not use them, it will work as '''sheet_by_id="0"''' (making it backwards compatible). If you use both arguments, then '''sheet_by_name''' will get the priority.

	An excel document like this :		An excel document like this :