Extension:Page Forms/Download and installation

Download

You can download the Page Forms code, in .zip format: https://github.com/wikimedia/mediawiki-extensions-PageForms/archive/5.9.zip

You can also download the code directly via Git from the MediaWiki source code repository (see available tags). From a command line in the extensions directory, run the following:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PageForms.git

To view the code online, including version history for each file, see PageForms.

Not recommended

There are some additional ways to download Page Forms, which are not recommended:

• Page Forms can be downloaded via the MediaWiki Extension Distributor, which lets you download any extension for any version of MediaWiki. This not recommended because the code being downloaded represents a random snapshot in time, that could contain bugs that were fixed later - or, if the "development/trunk" version is used, it could conversely contain code that is too new, and hasn't been fully tested yet.
• Page Forms is available via some Linux distributions, like Debian. These should probably not be used, since their version of the software tends to be significantly out of date.

Installation

Once you have downloaded the code as a directory called PageForms in your extensions folder, you just need to add the following line to your LocalSettings.php file:

wfLoadExtension( 'PageForms' );

There are four User rights defined for Page Forms:

• 'createclass' is the permission to create new classes (see Extension:Page Forms/Special pages ). By default it is given to all members of the 'user' group.
• 'editrestrictedfields' is the "permission" to edit restricted fields. By default it is given to all members of the 'sysop' group.
• 'multipageedit' is the "permission" to use the MultiPageEdit special page, which allows to edit multiple pages through a single spreadsheet-like interface. By default it is given to all members of the 'user' group.
• 'viewedittab' is the "permission" to see the "edit with form" tab. By default it is given to everyone (i.e, '*').

You can modify the set of users who have any of these permissions. For example, to have the "edit with form" tab show up only for administrators, you could add the following, below the inclusion of Page Forms:

$wgGroupPermissions['*']['viewedittab'] = false;
$wgGroupPermissions['sysop']['viewedittab'] = true;

Composer

Page Forms can also be downloaded and installed using Composer.

To install with Composer, add the following to your composer.local.json file:

{
  "require": {
    "mediawiki/page-forms": "^5.9"
  }
}

More information about the package can be found on Packagist: mediawiki/page-forms

Upgrading

If you used 'git clone' to install Page Forms, you can update to the very latest code for it with a simple command. The latest code may not be a stable release. From a command line in the Page Forms directory, run the following:

git pull