Name
file
Type
input
Synopsis
Using file uploads
Description
Use a form to upload one or multiple files.
Parameters
input type="file"
target* : Name of the File page to be created
id* : This must be always unique and can only exist ones on a page
action* : defaults to upload. Read more below on using this to convert docx documents to pages in the wiki.
name* : As with any input field, a name is mandatory
pagecontent: Text content to be added on the File Page
comment: Text to show in recent changes or contributions list
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.
error_id : Id of a DOM Element where error notices will be shown
verbose_id : Id of a DOM element where information about the file is shown
use_label : Doesn't require a value. When an input field has a label attached to it, then the label will become the upload button and the input field will be hidden
dropzone : Doesn't require a value. Will turn the verbose div into an additional file drop zone. If you also use_label, then the label will become the dropzone.
parsecontent: Will force FlexForm to insert values from other form fields inside the pagecontent field. Use square brackets, like [fieldname], where values should be inserted.
template : If you want to store a template call inside the content of the File page, you can template=<name of your template> in combination with parsecontent. [flexform-template] inside your content field will be replaced by {{<name of your template and [/flexform-template] will be replaced by }}. See example 3 on the examples page.
*= a required variable
The target is basically the name you want to use to store the file or files. It recognizes [mwrandom], [filename] and other form fields, by using their name with square brackets around them (see example). pagecontent can also hold form variables.
action="convertfrom:????"
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. converfrom allows all Pandoc to MediaWiki text conversions. docx would be a good example : action="convertfrom:docx".
HTMLtoImage
You can also use the field input to upload an image created from part of the page shown where the form is rendered.
Basically, you tell FlexForm you want to render a part of your screen as an image and upload it to the wiki.
The syntax is the same as above, but it only needs : target, name and pagecontent. The other arguments are ignored. Additionally it needs an argument called presentor="canvas" and it needs the ID of the element you want to convert to an image: canvas_source_id.
By default the image will always be a .jpg file. We plan to support png if this is requested.
For example you have a DIV element with id="content-to-convert". Within this DIV you have content you want to convert to an image an upload to the Wiki.
A FlexForm to utilize this would look something like this :
<div id="content-to-convert" style="width:500px">
<h1>Test Screenshot</h1>
<p>Lots of other content here</p>
</div>
<form>
<input type="file" presentor="canvas" id="canvasUpload" target="testCanvasFile.jpg" pagecontent="testing" canvas_source_id="content-to-convert" />
<input type="submit" value="upload" />
</form>
You cannot use both file uploads in one form.
Note
An input type="file" always needs a unique ID!
A form that needs to upload files needs this argument : enctype="multipart/form-data". The argument needs to be added to the Form tag, not the input tag. See also : https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/enctype
Links
https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/enctype
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file
