Extension:VEForAll

The VEForAll ("VisualEditor For All") extension allows other extensions to incorporate the VisualEditor interface into textareas for user editing.

This extension does not directly impact the user interface. Rather, it defines a JavaScript function (called " ") that can be called by other extensions on their textareas. At the moment, two extensions - CommentStreams and Page Forms - can make use of VEForAll.

As might be expected, the VisualEditor extension must be installed for this extension to work.

Download
You can download the VEForAll code, in .zip format, here.

You can also download the code directly via Git from the MediaWiki source code repository. From a command line, you can call the following:

You can also view the code online here.

Installation
To install this extension, create a 'VEForAll' directory (either by extracting a compressed file or downloading via Git), and place this directory within the main MediaWiki 'extensions' directory. Then, in the file 'LocalSettings.php', add the following line:

Using VEForAll with other extensions
VEForAll can currently be used with the CommentStreams, Page Forms and WSForm extensions:


 * For CommentStreams, you must use version 4.5 of the extension or higher. You simply need to have VEForAll (and VisualEditor) installed, and then textareas for entering comments will automatically get the VisualEditor interface.


 * For Page Forms, you must use version 4.7 or higher. Then, in the form definition, add  to the tag for any textarea input (including the "free text" input), and the VisualEditor interface should show up when viewing that form.


 * Note that WSForm is not officially released yet, but since it is on production websites it is mentioned. As of version 0.8.0.8.8, just use editor="ve" when defining a textarea. Eg. . You can have as many VE editors on a page as needed and you can even add a menu/button to the VE Editor that will open another VE Editor.

Configuration
By default, the toolbar is display at the bottom of the textarea. In Page Forms, you can instead display it at the top by adding  to the textarea's tag in the form definition.

You can use the "VEForAllToolbarConfigNormal" hook to customize the display of the VisualEditor toolbar. For example, to add "math" and "media" buttons, add the following to LocalSettings.php:

Authors and credits
VEForAll is heavily based on the (now-obsolete) VEForPageForm extension by Pierre Boutet and Clément Flipo. Some work to make the code more generic was done by Ike Hecht, Yaron Koren and Cindy Cicalese. VEForAll also includes code from the StructuredDiscussions extension.