VisualEditor's MediaWiki extension is mainly designed to work with the Vector, Monobook and Minerva skins, given the initial intent to work for the Wikimedia production site. However, it should be relatively easy to ensure your skin works with VisualEditor, especially if it is Vector-based.
VisualEditor requires the following elements on the page to function:
#contentserves as the main container for the editor. The toolbar will be attached here.
#mw-content-textserves as the editable area. It must be a descendant of
#content. Other descendants are greyed out and non-interactive while the editor is active.
#ca-editserves as the entry point – clicking it will open the editor.
Finally, you will need to add your skin to the
$wgVisualEditorSupportedSkins global array variable through your
LocalSettings.php file (otherwise it will just mysteriously never load).
VisualEditor interacts with the following elements if they are available, but should not have any problems if they are not (beyond the relevant functionality being missing):
#firstHeadingis updated with the page title (respecting DISPLAYTITLE) after the page is saved and when launching the editor from the wikitext edit form.
#contentSubis updated with the redirect status dynamically when the redirection is changed and after the page is saved.
.mw-editsectionlinks are modified to allow launching the visual editor. The default structure (as in
Skin::doEditSectionLink) is expected, if they are present.
#footer-info-lastmodare updated with the modification time after the page is saved.
- The IDs of content actions' links should begin with
ca-. Several content action links are modified or otherwise taken into account when present (
- The IDs of toolbar links should begin with
#t-permalinkis updated after the page is saved.
- The IDs of portlets (sidebar sections and other navigation menus) should begin with
p-. Tabs in
.selectedclass added/removed when the editor launches.
#catlinksserves to open the category editing dialog, and is updated dynamically when categories are edited and after the page is saved.
- Some elements that could interfere with the toolbar are hidden while the editor is active, including
In future, we will probably generalise VisualEditor's MediaWiki extension to be pluggable into new skins. Suggestions as to how best to do this efficiently are welcome.