mediawiki-extensions-Gadgets/README.md

44 lines
1.6 KiB
Markdown
Raw Normal View History

Gadgets
=============
The Gadgets extension provides a way for users to pick JavaScript or CSS
based "gadgets" that other wiki users provide.
See https://www.mediawiki.org/wiki/Extension:Gadgets for more documentation.
The Gadgets extension was originally written by Daniel Kinzler in 2007
2008-02-04 08:08:43 +00:00
and is released under the GNU General Public Licence (GPL).
Prerequisites
-------------
This version of Gadgets requires MediaWiki 1.27 or later. To get a version
compatible with an earlier MediaWiki release, visit
[ExtensionDistributor/Gadgets](https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Gadgets).
2010-11-11 18:46:54 +00:00
Installing
-------------
2008-02-04 08:08:43 +00:00
Copy the Gadgets directory into the extensions folder of your
MediaWiki installation. Then add the following lines to your
LocalSettings.php file (near the end):
require_once "$IP/extensions/Gadgets/Gadgets.php";
Usage
-------------
See http://www.mediawiki.org/wiki/Extension:Gadgets#Usage
Caveats
-------------
* Gadgets do not apply to Special:Preferences, Special:UserLogin and
2010-11-11 18:46:54 +00:00
Special:ResetPass so users can always disable any broken gadgets they
may have enabled, and malicious gadgets will be unable to steal passwords.
Configuration
-------------
* `$wgGadgetsRepoClass`: configures which GadgetRepo implementation will be used
to source gadgets from. Currently, "MediaWikiGadgetsDefinitionRepo" is the
recommended setting and default. The "GadgetDefinitionNamespaceRepo" is not
ready for production usage yet.
* `$wgSpecialGadgetUsageActiveUsers`: configures whether or not to show active
user stats on Special:GadgetUsage. True by default.