Extensão: Page Forms

Manual de extensões da MediaWiki

Page Forms Estado de lançamento: estável
Implementação	Página espacial , API
Descrição	Uma extensão que pode ser utilizada com Semantic MediaWiki ou Cargo (ou por si só), que permite aos utilizadores criarem formulários para criar e editar páginas que utilizam os modelos no estilo 'caixa de informação'. Os formulários são definidos nas páginas wiki, escritos numa linguagem de marcação personalizada e são analisados ​​​​dinamicamente quando um formulário é exibido.
Autor(es)	Yaron Koren <yaron57@gmail.com>, Stephan Gambke e outros
Última versão	6.0.3 (setembro de 2025)
Política de compatibilidade	Original mantém a compatibilidade com versões anteriores.
MediaWiki	1.40+
Composer	mediawiki/page-forms
Licença	GNU - Licença Pública Geral 2.0 ou superior
Transferência	Transferir extensão Git [?]: Explorar repositório (Phabricator · GitHub) Revisão de código Gerrit Registo de implementação do Git Transferir 'tarball' fonte
Exemplo	Um formulário auto gerado que permite ao utilizador editar um item de opinião
Parâmetros $wgPageForms24HourTime $wgPageFormsAutocompleteCacheTimeout $wgPageFormsAutocompleteOnAllChars $wgPageFormsAutoeditNamespaces $wgPageFormsCacheAutocompleteValues $wgPageFormsCacheFormDefinitions $wgPageFormsCheckboxesSelectAllMinimum $wgPageFormsDisableOutsideServices $wgPageFormsEmbedQueryCacheTTL $wgPageFormsGoogleMapsKey $wgPageFormsHeightForMinimizingInstances $wgPageFormsIgnoreTitlePattern $wgPageFormsLinkAllRedLinksToForms $wgPageFormsListSeparator $wgPageFormsMainFormsMinimum $wgPageFormsMaxAutocompleteValues $wgPageFormsMaxLocalAutocompleteValues $wgPageFormsRenameEditTabs $wgPageFormsRenameMainEditTab $wgPageFormsShowExpandAllLink $wgPageFormsShowTabsForAllHelperForms $wgPageFormsSimpleUpload $wgPageFormsUseDisplayTitle $wgPageFormsVisualEditorMaxHeight
Direitos adicionados viewedittab editrestrictedfields createclass multipageedit
Hooks utilizados AdminLinks ArticlePurge BeforePageDisplay CanonicalNamespaces CargoTablesActionLinks CargoTablesSetActionLinks CargoTablesSetAllowedActions EditPage::importFormData HtmlPageLinkRendererEnd MakeGlobalVariablesScript MultiContentSave PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderRegisterModules SkinTemplateNavigation::Universal TinyMCEDisable
Hooks fornecidos PageForms::AddRLModules PageForms::BeforeFreeTextSubst PageForms::CreateFormField PageForms::CreateTemplateText PageForms::EditFormInitialText PageForms::EditFormPreloadText PageForms::FormPrinterSetup PageForms::HTMLBeforeForm PageForms::PrintRedirectForm PageForms::RenderingEnd PageForms::SetTargetName PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageForms::UserCanEditPage PageForms::WritePageData
Traduza a extensão Page Forms
Função no Vagrant	pageforms
Problemas	Tarefas em aberto · Reportar um erro

Page Forms (conhecidos antes de 2016 como Formulários Semânticos) é uma extensão do MediaWiki que permite aos utilizadores adicionar, editar e consultar dados utilizando os formulários. It was originally created as an offshoot of the 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 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 modify 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.

Em baixo tem hiperligações para toda a documentação.

• Transferir e instalação

Como transferir "Page Forms" através do Git, uma transferência padrão, ou um pacote de programa; e como a instalar.

• Guia de início rápido

Como começar com as "Page Forms" de imediato.

• Alojamento

Wiki hosting sites that support Page Forms, plus public wikis that can be used for trying out the software.

• Páginas especiais

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), the ones used to display actual forms (Special:FormEdit, Special:FormStart, Special:RunQuery, Special:UploadWindow) and one that provides a spreadsheet-like interface to edit multiple pages containing a template (Special:MultiPageEdit).

• Formulários de Página e modelos

The template-based philosophy of Page Forms - plus information on the four parser functions that PF defines for templates: #template_params, #template_display, #arraymap and #arraymaptemplate.

• Definindo os formulários

Esta é a primeira das três secções principais. Como definir um formulário através de uma página dentro do espaço nominal "Formulário:" Abrange toda a sintaxe de definição de formulário, incluindo as etiquetas {{{info}}}, {{{for template}}}, {{{end template}}}, {{{field}}}, {{{section}}} e {{{standard input}}}. Também abrange como adicionar separadores e dicas de ferramentas.

• Tipos de entrada

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.

• Valores, mapeamento e autocompletar

A terceira secção principal. Information on setting possible/allowed values for the relevant input types, including "mapping" values to friendlier display names, options related to autocompletion, and the "show on select" parameter.

• The "edit with form" tab

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).

• Linking to forms

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.

• Criação de formulários de consulta

Creating forms to query data, instead of to modify data, via the Special:RunQuery page.

• Problemas comuns

Common issues people have run into, and their solutions, relating to forms, data structure design, and the use of Page Forms with other extensions.

• Erros conhecidos e funcionalidades planeadas

Known bugs in the software, and potential workarounds for them; plus features that are planned in the current "development roadmap".

• Obter apoio

Where to ask questions, submit bug reports, submit feature requests, submit fixes, and add new translations.

• Documentação do programador

Information for developers who want to modify Page Forms, or create an extension that works in tandem with it.

• Autor e créditos

The main authors, others who have contributed to the code, and credits to other organizations and software projects.

• Histórico da versão

A version history of Page Forms, from May 2007 to the present.

• Sites that use Page Forms

A small sampling of the wikis that use Page Forms, plus links to more comprehensive lists.

• Extensões relacionadas

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.

Cábula
Hiperligações	Referência rápida de SMW · Referência rápida de cargo · Página de testes
Funções do analisador	{{#arraymap :value|delimiter|var|formula|new_delimiter|conjunction}} {{#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|namespace selector|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}} {{#template_params :}} {{#template_display :_format=|_title=}} {{#autoedit :form=|target=|link text=|link type=|minor|query string=|reload|tooltip=|redirect|bring to page=|summary=|confirm|confirm text=|query string parameters}} {{#autoedit_rating :form=|target=|value=|star width=|num stars=|allow half stars=|minor|reload|tooltip=|summary=|confirm|query string parameters}} {{#default_form :form name}}
Tipos de entrada	text , textarea , tokens , combobox , date , datetime , year , datepicker , datetimepicker , checkbox , dropdown , radiobutton , checkboxes , listbox , tree , rating , regexp , googlemaps , leaflet , openlayers