Tech:Adding a new extension

This is a simple guide showing any user how to add an EXISTING extension to their wiki. If the extension doesn't exist or is not configured, you cannot add it this way.


 * 1) Create a GitHub account/Login
 * 2) Check the extension on MediaWiki
 * 3) Go to our LocalSettings page
 * 4) Look for 'wmgUseNameofExtension', and like the , the name of the wiki (ending with  )
 * 5) If the extension is VisualEditor or Flow, you'll have to add the name of the wiki to the Parsoid config list.

If you are confused or want someone else to take care of your request, please request here.

Getting a new extension
All of this portion must be done by Miraheze staff/sysops, but it's here for documentation purposes. If you want to add a new extension, request it here.

All of this stuff needs to be done before the steps above:


 * 1) Open a ticket for a Security Review
 * 2) Wait.  We will review the security checklist, among other things.  If we notice a bug, we'll try to fix it or wait for the extension developers to fix it.
 * 3) On passing review, the extension needs to be added to the mediawiki repository:  .  We generally use the branch for the current wiki version (e.g. REL1_26) if available.
 * 4) LocalExtensions.php gets a $wmgUseFoo variable added.
 * 5) LocalSettings.php gets this setup:
 * Setup any other extension globals here.
 * 1) Rebuild Localization Cache with   on all mw servers.
 * 2) If the extension has database tables, run "/usr/local/bin/foreachwikiindblist /srv/mediawiki/dblist/all.dblist /srv/mediawiki/w/maintenance/sql.php " for all SQL queries ran on wikis. Ideally, you should *never* need to run update.php. If this is not done for one reason or another, email operations@miraheze.org with an explanation and it will be acknowledged, discussed or fixed.
 * 1) If the extension has database tables, run "/usr/local/bin/foreachwikiindblist /srv/mediawiki/dblist/all.dblist /srv/mediawiki/w/maintenance/sql.php " for all SQL queries ran on wikis. Ideally, you should *never* need to run update.php. If this is not done for one reason or another, email operations@miraheze.org with an explanation and it will be acknowledged, discussed or fixed.