mediawiki / aform

0.4.0 2026-10-26 11:46 UTC

Requires

• php: >=7.4
• composer/installers: 1.*,>=1.0.1

Requires (Dev)

• mediawiki/minus-x: 1.1.1
• php-parallel-lint/php-console-highlighter: 1.0.0
• php-parallel-lint/php-parallel-lint: 1.3.2

GPL-3.0+

• Toni Hermoso Pulido

• form
• mediawiki

Published on Packagist.org on 2026-10-26 12:26 UTC

README

MediaWiki parser hook extension that provides parser functions for generating HTML form markup.

Installation

1. Copy the extension directory to extensions/Aform/.
2. Add to LocalSettings.php:

   wfLoadExtension( 'Aform' );

Requires PHP ≥ 7.4 and MediaWiki with wfLoadExtension support.

Parser Functions

#aform — open a form

{{#aform: action=PageName | method=get }}

Parameter	Description
action	Wiki page name (converted to URL automatically) or absolute URL (https://, http://, ftp://)
method	get or post
common attrs	class, id, style, rel, itemprop, content, data-*, aria-*

#aformend — close the form

{{#aformend:}}

#ainput — single input field

{{#ainput: type=text | name=q | value=default | size=20 }}

Parameter	Description
type	Input type (text, hidden, submit, checkbox, etc.)
name	Field name
value	Field value
size	Field width
readonly, disabled, checked, required	Boolean attributes: any value turns them on (required=no still sets required)
alt, placeholder, autocomplete, pattern, inputmode	Standard HTML attributes
common attrs	class, id, style, rel, itemprop, content, data-*, aria-*

#ainput_multi — multiple hidden inputs from a list

{{#ainput_multi: type=hidden | list=field1=value1&field2=value2 }}

The list parameter is an &-separated list of name=value pairs. Each pair generates one <input> element. Other #ainput attributes except value (type, size, placeholder, required, common attrs, etc.) are applied to all generated inputs.

#aselect — select dropdown

{{#aselect: name=animal | values=Dog,Cat,Mouse | selected=Dog }}

Parameter	Description
name	Field name (use name=field[] for multi-select)
values	Comma-separated option values
names	Comma-separated display labels (parallel to values; defaults to value if omitted)
selected	Comma-separated values to pre-select
sep	Custom separator character instead of ,
size	Visible row count
multiple	Set to multiple to allow multiple selections
common attrs	class, id, style, rel, itemprop, content, data-*, aria-*

#alabel — label element

{{#alabel: My Label | for=fieldid | class=form-label }}

The first positional argument is the label text. Supports for and common attrs (class, id, style, rel, itemprop, content, data-*, aria-*).

Example

{{#aform: action={{FULLPAGENAME}} | method=get }}

{{#alabel: Animal | for=animal-select }}

{{#aselect: name=animal[] | multiple=multiple | values=Dog,Cat,Mouse | selected=Dog }}

{{#ainput: type=text | size=4 | name=offset }}

{{#ainput_multi: type=hidden | list=text=House&size=100 }}

{{#aformend:}}

Development

composer test   # lint (parallel-lint + minus-x)
composer fix    # fix file permissions/line endings