Extension:Page Forms

From MediaWiki.org
(Redirected from Semantic Forms)
Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎日本語 • ‎polski • ‎русский • ‎sicilianu • ‎中文
Page Forms - navigation (viewTemplate:Page Forms navigation)
Basics Main pageExtension:Page Forms (talk) · Download and installationExtension:Page Forms/Download and installation · Quick start guideExtension:Page Forms/Quick start guide · HostingExtension:Page Forms/Hosting · Special pagesExtension:Page Forms/Special pages
Using Page Forms PF and templatesExtension:Page Forms/Page Forms and templates · Defining formsExtension:Page Forms/Defining forms (Input typesExtension:Page Forms/Input types) · The "Edit with form" tabExtension:Page Forms/The "edit with form" tab · Linking to formsExtension:Page Forms/Linking to forms · Creating query formsExtension:Page Forms/Creating query forms
Resources for help Common problemsExtension:Page Forms/Common problems · Known bugs and planned featuresExtension:Page Forms/Known bugs and planned features · Getting supportExtension:Page Forms/Getting support · Developers' documentationExtension:Page Forms/Developers' documentation · TestingExtension:Page Forms/Testing
About Page Forms Authors and creditsExtension:Page Forms/Authors and credits · Version historyExtension:Page Forms/Version history · Sites that use Page FormsExtension:Page Forms/Sites that use Page Forms · Related extensionsExtension:Page Forms/Related extensions
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png
Page Forms

Release status:Extension status stable

ImplementationTemplate:Extension#type Special page, API
DescriptionTemplate:Extension#description An extension that can be used with Semantic MediaWikiExtension:Semantic MediaWiki or CargoExtension:Cargo (or by itself), that allows users to create forms for creating and editing pages that use infobox-style templates. Forms are defined within wiki pages, written in a custom markup language, and are parsed on-the-fly when a form is displayed.
Author(s)Template:Extension#username Yaron Koren <yaron57@gmail.com>, Stephan Gambke and others
Latest versionTemplate:Extension#version 4.0.2 (November 2016)
MediaWikiTemplate:Extension#mediawiki 1.21+
ComposerComposer mediawiki/page-forms
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Download See here
ExampleTemplate:Extension#example An auto-generated form allowing the user to edit an opinion item
Hooks usedTemplate:Extension#hook
MakeGlobalVariablesScriptManual:Hooks/MakeGlobalVariablesScript
LinkEndManual:Hooks/LinkEnd
UnknownActionManual:Hooks/UnknownAction
SkinTemplateTabsManual:Hooks/SkinTemplateTabs
SkinTemplateNavigationManual:Hooks/SkinTemplateNavigation
AdminLinksManual:Hooks/AdminLinks
ParserBeforeStripManual:Hooks/ParserBeforeStrip
ParserFirstCallInitManual:Hooks/ParserFirstCallInit
ResourceLoaderRegisterModulesManual:Hooks/ResourceLoaderRegisterModules

Translate the Page Forms extension if it is available at translatewiki.net

Check usage and version matrix.

IssuesPhabricator

Open tasks · Report a bug

Page Forms (known until November 2016 as Semantic Forms) is an extension to MediaWiki that allows users to add, edit and query data using forms. It was originally created as an offshoot of the Semantic MediaWikiExtension:Semantic MediaWiki extension, to be able to edit templates that store their parameters via SMW, which is why it was originally called "Semantic Forms". However, it can now also work with the alternative CargoExtension:Cargo extension, or with neither extension installed.

Very simply, Page Forms allows you to have forms for creating and editing pages on your wiki, as well as for querying data, all without any programming. Forms can be created and edited not just by administrators, but by users themselves.

The main components of Page Forms functionality are form definition pages, which exist in a separate namespace, 'Form:'. These are pages consisting of markup code which gets parsed when a user goes to a form. Since forms are defined strictly through these definition pages, users can themselves create and edit forms, without the need for any actual programming.

The Page Forms extension is mostly used to add and edit calls to infobox-style templates within pages. A form allows a user to populate a pre-defined set of templates, as well as page sections, for any page; if Cargo or Semantic MediaWiki are used, the data within the templates can then be stored and queried.

Forms can also be used to edit the data in an existing page, and you can enable an "Edit with form" tab to show up on any page.

Page Forms also supports autocompletion of fields, so users can easily see what the previously-entered values were for a given field. This greatly helps to avoid issues of naming ambiguity, spelling, etc.

Data in a page that doesn't fit into the form, like a free-form text description of the page's subject, isn't ignored when the page is edited with a form; rather, it is placed into a separate input box called "free text".

Page Forms also includes a wide variety of other functionality related to forms.

Below are links to the entire documentation.

How to download Page Forms via either Git, a standard download, or a software package; and how to install it.
How to get started with Page Forms right away.
Wiki hosting sites that support Page Forms, plus public wikis that can be used for trying out the software.
All the "special pages" that Page Forms defines: the ones that provide helper forms (Special:CreateProperty, Special:CreateTemplate, Special:CreateForm, Special:CreateCategory, Special:CreateClass), the ones that display lists (Special:Templates, Special:Forms) and the ones used to display actual forms (Special:FormEdit, Special:FormStart, Special:RunQuery, Special:UploadWindow).
The template-based philosophy of Page Forms - plus information on the two parser functions that PF defines for templates: #arraymap and #arraymaptemplate.
This is the first of the two major sections. How to define a form via a page within the "Form:" namespace. Covers the entire form-definition syntax, including the {{{info}}}, {{{for template}}}, {{{end template}}}, {{{field}}}, {{{section}}} and {{{standard input}}} tags. Also covers how to add tabs and tooltips.
The second major section. A listing of all allowed input types, as well as parameters for each, and the set of SMW and Cargo data types that each can be used with. Also includes complete information on autocompletion options.
How to get the "Edit with form" tab to appear on pages, using the #default_form parser function. Plus, how to rename the tab to simply "edit", and how to remove the standard "edit" tab (if you want to).
How to bring users to forms, via the #forminput, #formlink, #formredlink and #queryformlink functions. Also, how to use #formredlink to have red-linked pages created automatically. Also, how to create links that directly modify a page, via the #autoedit function.
Creating forms to query data, instead of to modify data, via the Special:RunQuery page.
Common issues people have run into, and their solutions, relating to forms, data structure design, and the use of Page Forms with other extensions.
Known bugs in the software, and potential workarounds for them; plus features that are planned in the current "development roadmap".
Where to ask questions, submit bug reports, submit feature requests, submit fixes, and add new translations.
Information for developers who want to modify Page Forms, or create an extension that works in tandem with it.
The main authors, others who have contributed to the code, and credits to other organizations and software projects.
A version history of Page Forms, from May 2007 to the present.
A small sampling of the wikis that use Page Forms, plus links to more comprehensive lists.
Extensions that require the presence of Page Forms, extensions that can be used together with Page Forms, and extensions that have a similar purpose to Page Forms.
Cheat sheet
Links SMW quick reference · Cargo quick reference · Scratchpad · Sandbox
Parser functions {{#arraymap:value|delimiter|var|formula|new_delimiter}}
{{#arraymaptemplate:value|template|delimiter|new_delimiter}}
{{#forminput:form=|size=|default value=|button text=|query string=|autocomplete on category=|autocomplete on namespace=|placeholder=|popup|no autofocus|query string parameters}}
{{#formlink:form=|link text=|link type=|query string=|target=|tooltip=|popup|new window|query string parameters}}
{{#formredlink:form=|link text=|existing page link text=|query string=|target=|popup|new window|create page|query string parameters}}
{{#queryformlink:form=|link text=|link type=|query string=|tooltip=|popup|new window|query string parameters}}
{{#autoedit:form=|target=|link text=|link type=|query string=|reload|tooltip=|query string parameters}}
{{#default_form:form name}}
Input types

text, text with autocomplete, textarea, textarea with autocomplete, tokens, combobox, date, datetime, year, datepicker, checkbox, dropdown, radiobutton, checkboxes, listbox, tree, regexp, googlemaps, openlayers