Release status: stable
|Description||Provides an extendable wikitext editing interface and many feature-providing modules|
|Author(s)||Trevor Parscal, Roan Kattouw|
Translate the WikiEditor extension if possible
|Check usage and version matrix; code metrics|
|Bugs: list open list all report|
The WikiEditor extension is an extendable framework with a set of feature-based modules that improve the user experience of editing. It is also the editing interface that Wikipedia currently uses.
Installation[edit | edit source]
- Download and extract the files in a directory called
extensions/folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository.
- Add the following code at the bottom of your LocalSettings.php:
require_once( "$IP/extensions/WikiEditor/WikiEditor.php" );
- Done – Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.
Configuration[edit | edit source]
# Enables use of WikiEditor by default but still allow users to disable it in preferences $wgDefaultUserOptions['usebetatoolbar'] = 1; $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;
In some situations, WikiEditor may not show in your browser after the installation. Clearing your browser cache will solve the problem.
Toolbar customization[edit | edit source]
Extending[edit | edit source]
Toolbar Module[edit | edit source]
A toolbar visible on editing pages which replaces the stock toolbar. See the toolbar icons.
Sections[edit | edit source]
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
Actions[edit | edit source]
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|
Table of Contents Module[edit | edit source]
Navigable table of content while editing a page to navigate in its sections. This module will enable the HTML iframe version of the text editing control, which is unstable and should only be used in experimental environments.
To enable this module, use the following code :
# Displays a navigation column (summary) on the right side $wgDefaultUserOptions['usenavigabletoc'] = 1;
The following bug can be one of the potential issues with HTML iframe: 22438
See also[edit | edit source]
- Manual:Custom edit buttons#Extension:WikiEditor
|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.|
|Language:||English • Deutsch • 日本語 • русский|