Extension:Page Forms/nl

MediaWiki Handleiding extensies

Page Forms Release status: stabiel
Implementatie	Speciale pagina , API
Beschrijving	Een extensie die gebruikt kan worden met Semantic MediaWiki of Cargo/nl (of op zichzelf), waarmee gebruikers formulieren kunnen maken voor het aanmaken en bewerken van pagina's die sjablonen in infobox-stijl gebruiken. Formulieren worden gedefinieerd op wikipagina's, geschreven in een eigen opmaaktaal, en worden on-the-fly geparset wanneer een formulier wordt weergegeven.
Auteur(s)	Yaron Koren <yaron57@gmail.com>, Stephan Gambke en anderen
Laatste versie	5.9 (december 2024)
Compatibiliteit beleid	Master onderhoudt achterwaartse compatibiliteit.
MediaWiki	1.39+
Composer	mediawiki/page-forms
Licentie	GNU General Public Licentie 2.0 of hoger
Download	Extensie downloaden Git [?]: Download Git master blader door de repository (Phabricator · GitHub) commitgeschiedenis repository beheerders (GitHub) code review
Voorbeeld	Een automatisch gegenereerd formulier waarmee de gebruiker een opinieartikel kan bewerken
Parameters $wgPageForms24HourTime $wgPageFormsAutocompleteCacheTimeout $wgPageFormsAutocompleteOnAllChars $wgPageFormsAutoeditNamespaces $wgPageFormsCacheAutocompleteValues $wgPageFormsCacheFormDefinitions $wgPageFormsCheckboxesSelectAllMinimum $wgPageFormsDisableOutsideServices $wgPageFormsEmbedQueryCacheTTL $wgPageFormsGoogleMapsKey $wgPageFormsHeightForMinimizingInstances $wgPageFormsIgnoreTitlePattern $wgPageFormsLinkAllRedLinksToForms $wgPageFormsListSeparator $wgPageFormsMainFormsMinimum $wgPageFormsMaxAutocompleteValues $wgPageFormsMaxLocalAutocompleteValues $wgPageFormsRenameEditTabs $wgPageFormsRenameMainEditTab $wgPageFormsShowExpandAllLink $wgPageFormsShowTabsForAllHelperForms $wgPageFormsSimpleUpload $wgPageFormsUseDisplayTitle $wgPageFormsVisualEditorMaxHeight
Toegevoegde rechten viewedittab editrestrictedfields createclass multipageedit
Gebruikte hooks AdminLinks ArticlePurge BeforePageDisplay CanonicalNamespaces CargoTablesActionLinks CargoTablesSetActionLinks CargoTablesSetAllowedActions EditPage::importFormData HtmlPageLinkRendererEnd MakeGlobalVariablesScript MultiContentSave PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderRegisterModules SkinTemplateNavigation::Universal TinyMCEDisable
Beschikbare hooks 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
Vertaal de extensie Page Forms
Vagrant rol	pageforms
Problemen	Open taken · Rapporteer een bug

Page Forms (voor 2016 bekend als Semantic Forms) is een extensie op MediaWiki waarmee gebruikers gegevens kunnen toevoegen, bewerken en bevragen middels formulieren. Het is oorspronkelijk gemaakt als een zijtak van de extensie Semantic MediaWiki , om sjablonen te kunnen bewerken die hun parameters opslaan via SMW, en daarom werd ze oorspronkelijk "Semantic Forms" genoemd. Ze kan nu echter ook werken met de alternatieve extensie Cargo/nl of zonder een van beide.

Simpel gezegd maakt Page Forms op uw wiki formulieren voor het aanmaken en wijzigen van pagina's mogelijk, evenals voor het bevragen van gegevens, allemaal zonder enige vorm van programmeren. Formulieren kunnen niet slechts door beheerders, maar ook door gebruikers zelf worden gemaakt en bewerkt.

De belangrijkste onderdelen van de 'Page Forms'-functionaliteit zijn formulierdefinitiepagina's die in een afzonderlijke naamruimte 'Formulier:' staan. Dit zijn pagina's die bestaan uit opmaakcode die wordt geparset wanneer een gebruiker naar een formulier gaat. Aangezien formulieren enkel via deze definitiepagina's worden gedefinieerd, kunnen gebruikers zelf formulieren maken en wijzigen, zonder dat daarvoor enige vorm van programmeren nodig is.

De extensie Page Forms wordt meestal gebruikt om aanroepen van infobox-style sjablonen binnen pagina's, te wijzigen of toe te voegen. Met een form kan een gebruiker een vooraf gedefinieerde set sjablonen of secties van een pagina invullen. Als op een pagina sectie Cargo of Semantische MediaWiki wordt gebruikt, dan kunnen de gegevens in de sjablonen worden opgeslagen en geraadpleegd.

De forms kunnen op worden gebruikt om de gegevens in de bestaande pagina te bewerken. U kunt het tonen van een tab "met form bewerken" op elke pagina inschakelen.

Page Forms ondersteunen ook het automatisch aanvullen van velden, gebruikers kunnen dat eenvoudig zien welke waarde er eerder zijn ingevuld bij een bepaald veld. Dat voorkomt wat spelfouten en het is natuurlijk ook minder intikken, enz.

Gegevens van een pagina die niet in een form kunnen, zoals een vrije tekst beschrijving van het onderwerp van de pagina, wordt niet genegeerd bij het bewerken met een form, het wordt in een losstaand invoerveld geplaatst, de zogenaamde "free text".

Page Forms kunnen ook veel functionaliteit bevatten die gerelateerd is aan forms.

Hieronder staan links naar de volledige documentatie.

• Downloaden en installeren

Het downloaden uit Git, een standaard download of een software package; het installeren.

• Snelstartgids

Hoe direct te starten met Page Forms.

• Hosting

Wiki hosting websites die Page Forms ondersteunen en openbare wiki's die gebruikt kunnen worden voor het uitproberen van de software.

• Speciale pagina's

Alle "speciale pagina's" die Page Forms definieert: degene die helper forms geven (Special:CreateProperty, Special:CreateTemplate, Special:CreateForm, Special:CreateCategory, Special:CreateClass), degene die lijsten tonen (Special:Templates, Special:Forms), degene die gebruikt worden voor het tonen van actuele forms (Special:FormEdit, Special:FormStart, Special:RunQuery, Special:UploadWindow) en een die zorgt voor een spreadsheet-achtige interface voor het bewerken van meerdere pagina's die een sjabloon bevatten (Special:MultiPageEdit).

• Page Forms en sjablonen

Page Forms heeft een aanpak gebaseerd op sjablonen, met informatie over de vier parserfuncties die het onderkent voor sjablonen: #template_params, #template_display, #arraymap en #arraymaptemplate.

• Formulieren definiëren

Dit is het eerste van de twee volgende hoofdgedeelten. Hoe een form te definiëren via een pagina binnen de "Form:" namespace. Omvat de gehele definitie syntaxis voor forms, inclusief de tags {{{info}}}, {{{for template}}}, {{{end template}}}, {{{field}}}, {{{section}}} en {{{standard input}}}. Het omvat ook het toevoegen van tabs en tooltips.

• Invoertypes

Het tweede hoofdgedeelte. Een lijst van de toegestane invoertypes, met daarbij voor elk invoertype de parameters en de van SMW en Cargo gegevenstypes die elk daarbij kan gebruiken.

• Waarden, koppelingen en automatisch aanvullen

De derde hoofdsectie. Informatie over het instellen van mogelijke/toegestane waarden voor de relevante invoertypen, waaronder het toewijzen van waarden aan vriendelijkere weergavenamen, opties met betrekking tot automatisch aanvullen en de parameter "weergeven bij selecteren".

• De tab "Edit with form"

Het tonen op de pagina's van de tab "edit with form", met gebruik van de parserfunctie #default_form. Ook hoe de tab "edit" kan worden hernoemd of uitgeschakeld (als u dat wil).

• Naar formulieren linken

Hoe gebruikers naar de formulieren te brengen, via de functies #forminput, #formlink, #formredlink en #queryformlink. Hoe #formredlink te gebruiken om rood-gelinkte pagina automatisch aan te maken. Hoe links aan te maken die direct een pagina aanpassen, via de functie #autoedit.

• Query formulieren aanmaken

Formulieren aanmaken voor zoeken van gegevens in plaats van gegevens te wijzigen, via de pagina Special:RunQuery.

• Problemen

Problemen die men hierbij vaak krijgt met formulieren en de bijbehorende oplossingen, ontwerp gegevensstructuur en het gebruiken met andere extensies.

• Bekende fouten en geplande functies

Bekende softwarefouten en de aanpak om dat te omzeilen, functies die gepland zijn in het huidige ontwikkelplan (roadmap).

• Ondersteuning krijgen

Waar kunt u vragen stellen. Hoe kunt u problemen rapporteren, om een wijziging verzoeken, oplossingen doorgeven en vertalingen maken.

• Ontwikkeldocumentatie

Informatie voor ontwikkelaars die 'Page Forms' willen aanpassen of een extensie willen maken die er mee samen werkt.

• Auteurs en credits

De belangrijkste auteurs, anderen die hebben gewerkt aan de code, bedanken van andere organisaties en software projecten.

• Versie geschiedenis

De versies van Page Forms, vanaf mei 2007.

• Sites die 'Page Forms' gebruiken

Een klein aantal van de wiki's die Page Forms gebruiken, met links naar uitgebreidere lijsten.

• Gerelateerde extensies

Extensies waarbij Page Forms aanwezig moet zijn, extensies die tegelijk met Page Forms gebruikt kunnen worden en extensies die een vergelijkbaar doel hebben als Page Forms.

Spiekbriefje
Links	SMW korte referentie · Cargo korte referentie · Zandbak
Parserfuncties	{{#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}}
Invoertypes	text , textarea , tokens , combobox , date , datetime , year , datepicker , datetimepicker , checkbox , dropdown , radiobutton , checkboxes , listbox , tree , rating , regexp , googlemaps , leaflet , openlayers