Note: This extension is bundled with MediaWiki 1.18 and above. Thus you do not have to download it again.
Release status: stable
|Description||Provides an extendable wikitext editing interface and many feature-providing modules|
|Author(s)||Trevor Parscal, Roan Kattouw|
|Latest version||0.5.0 (2016-06-14)|
|License||GNU General Public License 2.0 or later|
Translate the WikiEditor extension if it is available at translatewiki.net
|Check usage and version matrix.|
|Open tasks · Report a bug|
The WikiEditor extension provides an improved interface for editing wikitext. It is the editing interface that Wikipedia currently uses.
It includes an extendable framework with a set of feature-based modules, each of which can be selectively enabled or disabled, aiming to improve the user experience of editing in different ways.
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'WikiEditor' );
- If necessary configure at your convenience.
- Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
To users running MediaWiki 1.24 or earlier:
The instructions above describe the new way of installing extensions using
wfLoadExtension(), since MediaWiki 1.25. If you need to install this extension in earlier versions, instead of
wfLoadExtension( 'WikiEditor' );, you need to use:
# Enables use of WikiEditor by default but still allows users to disable it in preferences $wgDefaultUserOptions['usebetatoolbar'] = 1; # Enables link and table wizards by default but still allows users to disable them in preferences $wgDefaultUserOptions['usebetatoolbar-cgd'] = 1; # Displays the Preview and Changes tabs $wgDefaultUserOptions['wikieditor-preview'] = 1; # Displays the Publish and Cancel buttons on the top right side $wgDefaultUserOptions['wikieditor-publish'] = 1;
Add the above code at the bottom of your LocalSettings.php. In some situations, WikiEditor may not show in your browser after the installation. Clearing your browser cache will solve the problem.
- The button for adding user signatures (four tildes) is available on talk pages and in namespaces specified in $wgExtraSignatureNamespaces.
- Note for IIS setup: By default, IIS doesn't understand .svg files. WikiEditor uses them to represents the icons. To fix this, you have to add the MIME type.
A toolbar visible on editing pages which replaces the stock toolbar. See the toolbar icons.
A toolbar is a series of groups, each with a series of tools, rendered in the writing direction of the content language, with visible dividers between groups.
Supported Tool Types
- Button - an icon which can be clicked
- Select - a drop-down list which can be selected from
A booklet is a series of named pages which can be viewed one at a time and navigated through using an index list widget.
Supported Page Types
- Table - a grid of columns and rows
- Characters - a series of rectangular buttons containing text values
Each tool has an action which is executed when the tool is used. The most commonly used action is encapsulate, which operates on the currently selected text, prepending text, appending text and in the case that no text was selected inserting text at the cursor. The encapsulate action takes three parameters, pre, peri and post, which can either be raw text or message keys.
|pre||preMsg||Text to place before the cursor/selection|
|peri||periMsg||Text to place at the cursor if there is no selection|
|post||postMsg||Text to place after the cursor/selection/peri text|
Part of the WikiEditor extension were a number of alpha quality modules. These alpha modules are now deprecated and are being removed. The modules are: highlighter, toc, templates and template editor. You should not be using them.
- Toolbar customization
- Toolbar customization library
- Custom edit buttons
- 2017 wikitext editor
|This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.|