]> 2026-04-30T18:22:23+02:00 create 50000 en Doc 205 Using a form to create new pages or overwrite existing User create (2.0,2.1,2.5) 2.0 2.1 2.5 create 2022-12-22T19:44:15Z 2459936.3223958 create 2025-08-25T12:02:59Z 2460913.0020718 Doc/FlexForm/2.0/create 337 https://www.mediawiki.org/wiki/Help:Substitution https://www.mediawiki.org/wiki/Multi-Content_Revisions Name _create Type _create Synopsis Using a form to create new pages or overwrite existing pages Description _create can be defined as part of a form to have new page(s) created on form submit or overwrite (an) existing page(s). Parameters _create mwtemplate = Name of a template to use as content for the new page. If you have a form with only one input element you can also use mwtemplate="wsnone". This will take the content of the form input element and make it the source content of the new page (without putting it inside a template). mwwrite = Full name of the target page; or when used with 'mwoption', part of the page name; or a formula in the format "::id::< ... >" referencing the value of 'mwwrite' from another _create (see example 4 below). mwfollow = Will send the user to the newly create page after form submission mwoption can hold three different values: " add_random " = Create random numbers " next_available " = Get the next available number. If mwwrite is : "orders/", this option will find the highest orders number (e.g. orders/192) and will create a page with one number higher (e.g. orders/193) " range: " = Get the next available free slot in a range of numbers. If mwwrite is : "orders/", this option will find the first free spot in a range of numbers. If mwoption="range:2019000-2019999" and mwwrite="orders/" then FlexForm will start looking for a page called orders/2019000. If exists it will look for orders/2019001 etc.. till the first free page is found. mwleadingzero can be used in combination with range. When a range is set like 1-99999 using mwleadingzero will use the length of the end range and use it to fill the start range with leading zeros, making the range from 00001-99999. mwfields = comma separated names of form elements that need to be included. Only works when using multiple _create. If you are creating multiple pages and want to re-assign form fields to template variables, you still add the form field name to mwfields, but add " :: " and then the name of the template variable. So if you want to tell mwfields to use formfield " name2 ", but add it to the template as " Name ", add : " name2::Name " to mwfields. mwslot = name of a specific content slot to use. nooverwrite = when this is set, no create will be done for a page that already exists. Even if you are creating a new slot for a page that already exist. noseo = when this is set, even if the setting create-seo-titles in your local settings is set to true to always create SEO friendly page titles, it will not make the title of a new page SEO friendly, but use the title given. mwformat = defaults to wiki. Currently only supports wiki or json. When set to json, the page content of the page will become a json. When used with mwtemplate, then the template name will be the key for the json. All form values will be stored as strings. Every new array with key names will automatically get a ffID value that will always be unique. This is done for easy editing later. There are several ways for creating a page with FlexForm. Easiest Use mwtemplate and mwwrite as described above (and optionally wsfollow, wsoption, etc) This will use the values of mwtemplate and mwwrite and any form elements the current for has and create a new page with template "mwtemplate" and title of "mwwrite". See example 1. More advanced and possibilities Use mwtemplate and mwwrite with more options than described above (and optionally wsfollow, wsoption, etc) mwwrite can use can use other elements in the form and use those values to create a title for a new page. Field names can be added using square brackets. So if a form also has a text input field of "title" mwwrite could be "[title]". [mwrandom] can also be used e.g. mwwrite="[title]/[mwrandom]". See example 2. Create multiple pages with one form and control what form elements are used. This is where mwfields comes in. This is a comma separated list of form elements that will be used to create the new page. If a form has 15 text input fields, then using _create will include all 15 (filled-in by user) elements in the new page. Using mwfields you can tell _create specifically what form element to use to create a new page. So, when creating multiple new pages with one form, mwfields should be used with any and all _create. See example 3. Create a new page and fill different content slots for that page. You have to give the definition of the first _create an id. The other _create elements reference the first _create with a mwwrite like mwwrite="::id::<idOfWSCreateWithID>". See example 4. Example Example 1 : Create a new page with the next available number < _create mwwrite = "orders/" mwtemplate = "Order" mwoption = "next_available" /> Create a new page with the next available number in a range and always start from the beginning < _create mwwrite = "orders/" mwtemplate = "Order" mwoption = "range:2019000-2019999" /> Random number < _create mwwrite = "Proj-solution:" mwoption = "add_random" mwtemplate = "Solution" /> Example 2 : Create from text, mwrandom and fieldvalues < _create mwwrite = "Proj-solution:[namefield]/[mwrandom]" mwtemplate = "Solution" /> Example 3 : Create from text and field values and only include specific form element names in the new template < _create mwwrite = "Proj-solution:[namefield]/Personal" mwtemplate = "Personal" mwfields = "naam, adres, straat, plaats" /> < _create mwwrite = "Proj-solution:[namefield]/Business" mwtemplate = "Business" mwfields = "Company, cadres, cstraat, cplaats" /> Example 4 : Create a page with title : Test/[title]. With no main content and a template of Structured data with an argument of Hello in slot:mds-metadataslot". At the same time content slot "mds-metadataslot2" get the same template with argument Hello2. < _create id = "testingSlot" mwwrite = "Test/[title]" mwtemplate = "Structured data" mwfollow mwfields = "Hello" mwslot = "mds-metadataslot" /> < _create mwwrite = "::id::testingSlot" mwtemplate = "wsnone" mwfields = "Hello2" mwslot = "mds-metadataslot2" /> Example 5 : Use wsnone and substitution to copy content of an existing page onto a new page. This example copies the content of "Main Page" when creating a new page named "Test new page". < form > < _create mwwrite = "Test new page" mwtemplate = "wsnone" mwfields = "Content" /> < textarea name = "Content" > {{subst::Main Page}} </ textarea > < input type = "submit" /> </ form > Note If you create a page from text, mwrandom and field values and also add mwoption="add_random", another random number will be added to the end of the page title. You can have multiple instances of _create in a form, as long as mwfields is a non empty argument with every _create. If you have multiple _create and they all have a mwfollow, the last _create in the list will be followed. Links https://www.mediawiki.org/wiki/Multi-Content_Revisions The _create and _edit tags share a lot of functionality but they do not always share the same attribute names or their intended usage may differ slightly. By presenting these attributes side by side, the following table may help you on your way more quickly. _create _edit comments Can be used to create new pages Can be used to edit existing pages Cannot be used to edit a selection of fields on a page Cannot be used to create new pages Can be used to edit existing pages, including select fields mwwrite page title, optionally a formula in conjunction with mwoption or mwleadingzero target page id or page title specific to page creation: mwleadingzero mwoption noseo nooverwrite x mwfollow x If you know the name of the target page in advance, you can always set mwreturn in the form tag instead. mwfollow was specifically created for use cases where the title of the page to be created cannot be predicted. mwfields allows for multiple fields (comma-separated) formfield allows for single fields only x usefield mwslot mwslot mwformat format wiki or json mwtemplate template template name or JSON configuration x value can be used to set the value explicitly, without reading it from a form field. 50000 0 plainlist 1 [[:DevOps:Doc/FlexForm/2.0/create]] Doc/FlexForm/2.0/create# QUERY4ba1580d2f1b642fc8e2e258e58224a5