summaryrefslogtreecommitdiff
path: root/www/wiki/extensions/Gadgets/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'www/wiki/extensions/Gadgets/README.md')
-rw-r--r--www/wiki/extensions/Gadgets/README.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/www/wiki/extensions/Gadgets/README.md b/www/wiki/extensions/Gadgets/README.md
new file mode 100644
index 00000000..8235e3aa
--- /dev/null
+++ b/www/wiki/extensions/Gadgets/README.md
@@ -0,0 +1,43 @@
+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
+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).
+
+Installing
+-------------
+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):
+
+ wfLoadExtension( 'Gadgets' );
+
+Usage
+-------------
+See https://www.mediawiki.org/wiki/Extension:Gadgets#Usage
+
+Caveats
+-------------
+* Gadgets do not apply to Special:Preferences, Special:UserLogin and
+ 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.