Extension:Wikistories

The Wikistories extension support the creation, curation and distribution of visual stories based on wiki content.

Running locally
Once downloaded and installed successfully from steps above, follow the steps below to run locally:


 * Clone the dependency extensions and skin. You can run these from your root Mediawiki directory.
 * Add the following code at the bottom of your LocalSettings.php file.
 * Run  from the   directory.

Now if you refresh your browser and go to some article page in your local set up, you should see Wikistories at the top of the article. Make sure you are in mobile view in your browser as Wikistories is only enabled for mobile usage.

Configuration options
The Wikistories extension has support for some basic configuration that allows you to run it in different ways.

Running the extension as a Beta Feature
Wikistories has support to run it as a Beta Feature. We can do this with the  we set in LocalSettings.php. This defines how is the discovery module activated, and it can be set to 'beta' (which means it is a beta feature) or 'public' (which means it is available by default to everyone, including anons). Any other value means the discovery feature is disabled.

Therefore to run as a Beta Feature you first need to install the Beta Feature extension: And then update your LocalSettings.php with: After this you should be able to go to the Beta Features tab in your user preferences and check the Wikistories checkbox to manually activate it.

Sending notifications to story watchers when story needs to be updated
If a user running Wikistories locally adds a story to their watchlist, then they should be sent a notification when the story needs to be updated. This requires cloning and installing the Echo extension from your root Mediawiki directory.

And then update your LocalSettings.php with:

Then you will get an echo notification when a story you are watching needs updated.

Configuring API domains
There are two config for API domains:


 * : Sets the Commons API domain. Defaults to production value 'commons.wikimedia.org', and you can use 'commons.wikimedia.beta.wmflabs.org' for beta cluster.
 * : Sets the REST API domain. Defaults to null, in which case the domain of the current site will be used. Otherwise use 'wikipedia.org' for full article text when running locally

Other configuration options

 * : Minimum number of frames a story needs to have to be valid.
 * : Maximum number of frames a story needs to have to be valid.
 * : Maximum number of characters a story frame can have.
 * : Percentage threshold of unmodified text allowed before showing final edit warning

Code stewardship
Maintained by the Inuka team