Extensions FAQ

Where can I find a list of installed extensions?
The Special:Version page on each wiki contains a list of extensions that have registered themselves with the MediaWiki software. All extensions can be installed without showing up on Special:Version, if the developer does not include the correct code to list it there.

How do I enable an extension?
For most extensions, copy the extension PHP file (or directory) to your  folder and add the following statement to your , with   being the filename of your extension, such as MyExtension.php.

Since 1.25 (2015), there is a new way of installing extensions, which works with extensions that support extension registration. The equivalent for the extension above would be:

Some extensions, however, have additional steps and/or different installation procedures. Some extensions will contain a text-file named  (sometimes  ) that will have more detailed information about that extension.

See also: 

How do I write my own extension?
See.

How do I disable caching for pages using my extension?
If you're writing e.g. special page:

For parser tag hooks:

In case your extension output is only dependent on some option or user context and not time, you can still let it get cached by the parser cache but make sure it's marked as one output variant (of many possible). Use the PageRenderingHash hook to influence the cache hash accordingly.

(Note that in older versions of MediaWiki, you would use  to disable caching, but this was deprecated in MW 1.28 and removed altogether in MW 1.35.)

Special pages
When rendering output that will not be subject to parser cache, such as on a special page

where  is the wikitext to be parsed.

Parser hooks
 See Manual:Tag extensions#How do I render wikitext in my extension? 

How do I enable searching in my extension's output (dynamic content)?
You can't. Dynamic content can not be included in a static index.

How can I avoid modification of my extension's HTML output?
See Manual:Tag extensions

How can I pass XML-style parameters in my extension tag?
See Manual:Tag extensions

Extensions and Templates
See Manual:Tag extensions

"NaodW..." or "UNIQ..."
In previous versions of MediaWiki, there was a problem with templates and extensions that caused the appearance of "NaodW..." or "UNIQ..." strings in the template output. MediaWiki 1.5(.1) has problems with some PHP versions that causes that output. You should upgrade to MediaWiki 1.5.2 or later.

Another clue is that your extension (or another one installed) might be using  function instead of. Then change it to  (using the parser given in parameter or $wgParser).

How can I determine in my extension, if an article is protected or not?
Use the Title class and the isProtected method, e.g.

What permissions do I apply to the extensions folder?
All the scripts in the /wiki structure need to be readable and executable by the user that PHP runs as. All perms are usually 755 and owner/group being a different user. The LocalSettings.php file is created by the script on setup and so will be an example to set the rest by.

How do I get my extension to show up on Special:Version?
See Manual:Developing extensions