How to enable the WikiEditor in your own MediaWiki

How to enable the WikiEditor in your own MediaWiki

If you just installed MediaWiki and you want to improve its default text editor, you have basically two options: either enable the WikiEditor extension, which was successfully used by the most MediaWiki-based Wikis in the world since 2015 - including, of course, Wikipedia - or implement the brand-new (and visually astonishing) VisualEditor extension, which is basically the "successor" of the former being officially adopted by Wikipedia since 2015.

Quick comparison

To get an immediate glimpse of what we're talking about, this is the default MediaWiki editor, i.e. what you probably have now:

mediawiki-default-editor

This is the WikiEditor:

mediawiki-wiki-editor

And this is is the VisualEditor:

mediawiki-visual-editor

In terms of pure visual appeal, it's pretty clear that we have a winner. However, installing the Visual Editor in your own MediaWiki environment is not a trivial task: other than requiring some experience (and a good amount of time), you need to have the required amount of control over your web site hosting service - or have access to another one you can use - because you'll need to setup some stuff, including a  dedicated Node.js instance to run the required Parsoid service.

If you are interested in going for that path, until we'll write an easy-to-understand guide, you can go through the official VisualEditor documentation for installing it within a shared host.

Conversely, installing the WikiEditor is a matter of few minues, which is something that makes it the perfect choice if you want to improve your editor's experience without losing too much time.

Downloading WikiEditor

As a matter of fact, you most likely have it already - unless you installed MediaWiki years ago - as the WikiEditor extension comes shipped together with the default MediaWiki bundle since 1.18 (and above). Just to be sure about that, look inside the /extensions/  folder within your MediaWiki installation and check if the /WikiEditor/  folder is there or not. If that's the case you can skip to the next paragraph, otherwise do the following:

  • Download the extension from the MediaWiki Extension Distributor page.
  • Unpack the archive within the /extension/WikiEditor/  folder, without creating additional subfolders (the first php files will need to be there).

Installing and configuring

Open the LocalSettings.php file in your MediaWiki installation's root folder and look for the Extensions section, which starts with the following commented lines:

Right after that you'll find a list of  wfLoadExtension('SOME_NAME')  lines of code, one for each installed extension. Add the following at the end of the list, or uncomment it in case it's already there:

If you're using MediaWiki 1.24 or older, instead of the wfLoadExtension  you will see a list of include  statements. That's because the wfLoadExtension  method has been added in MediaWiki 1.25. If you need to install this extension in earlier versions, use the following line of code instead of the previous one:

Testing it out

 

As soon as you save your LocalSettings.php configuration file, the WikiEditor will replace the default MediaWiki editor for all users. You can easily check it out by creating a new entry or edit an existing one.

That's it for now: happy writing!

 

About Ryan

IT Project Manager, Web Interface Architect and Lead Developer for many high-traffic web sites & services hosted in Italy and Europe. Since 2010 it's also a lead designer for many App and games for Android, iOS and Windows Phone mobile devices for a number of italian companies. Microsoft MVP for Development Technologies since 2018.

View all posts by Ryan

4 Comments on “How to enable the WikiEditor in your own MediaWiki”

  1. Pingback: How to import Wikipedia Templates into your own MediaWiki
  2. Pingback: MySQL Lock Wait Timeout Exceeded Error in InnoDB Tables - How to fix it
  3. Pingback: MySQL Lock Wait Timeout Exceeded Error in InnoDB Tables - Soluzione
  4. Hi Ryan! I loved the tutorial, but unfortunately, enabling the WikiEditor did not work. This blog says August 2016 is the publish date, but I’m wondering if this isn’t actually an old post for a previous version that was refreshed to look new? One example why I would say that, is the comment text you say should be there, isn’t. This is a brand new mediawiki installation on my local machine where I have full permissions(I think — so far I’ve been able to download and enable other plugins), downloaded, installed, and configured less than a month ago.

    These seem like very simple instructions, but it’s not working for me. Here are my specs:

    MediaWiki 1.30.0
    PHP 5.6.25 (apache2handler)
    MySQL 5.7.14
    ICU 57.1

    And WikiEditor 0.5.1 extension came pre-installed. I enabled it with the wfLoadExtension() call, as indicated, but didn’t have any luck. Still showing the basic editor.

    This MediaWiki help page ( https://www.mediawiki.org/wiki/Extension:WikiEditor) even says the following:

    “In some situations, WikiEditor may not show in your browser after the installation. Clearing your browser cache will solve the problem.”

    However, clearing my browser cache DID NOT solve the problem. It’s just strange. I wanted to share my experience with you so if something has changed you could get to the bottom of it and update this post accordingly. Also, if you have any suggestions or are *aware* of any bugs regarding this, any help is appreciated. Thanks.

Leave a Reply

Your email address will not be published. Required fields are marked *


The reCAPTCHA verification period has expired. Please reload the page.

This site uses Akismet to reduce spam. Learn how your comment data is processed.