Go to file
Siddharth VP 14af941e88 Add global 'withgadget' query parameter for ad-hoc loading of gadgets
When viewing pages, the 'withgadget=' query parameter can be used in
the URL to load a gadget that isn't enabled by the user's preferences.

The gadget is only loaded if all other conditions are still satisfied
(supported skin, supported targets, required user rights).

Bug: T29766
Change-Id: I5b30d4e0010561685eef661a515e2892045bb776
2021-10-16 03:14:34 +00:00
.phan build: Upgrade mediawiki/mediawiki-phan-config from 0.5.0 to 0.6.0 2019-05-19 12:09:35 +00:00
i18n Localisation updates from https://translatewiki.net. 2021-09-28 08:18:48 +02:00
includes Add global 'withgadget' query parameter for ad-hoc loading of gadgets 2021-10-16 03:14:34 +00:00
tests/phpunit Revert "Make each gadget a separate preference, instead of one huge multiselect" 2021-10-07 19:52:18 +00:00
.eslintrc.json build: Updating mediawiki/mediawiki-codesniffer to 32.0.0 2020-10-29 13:34:25 +00:00
.gitignore Fix typos, update gitignore with OS tempfiles 2020-03-11 21:24:22 +05:30
.gitreview Whoops, track not trace 2016-10-24 17:02:35 -07:00
.phpcs.xml Add missing @var and improve documentation 2020-12-18 00:21:49 +01:00
CODE_OF_CONDUCT.md build: Updating mediawiki/phan-taint-check-plugin to 1.3.0 2018-08-19 12:48:57 +00:00
composer.json build: Updating ansi-regex to 5.0.1 2021-10-04 22:12:57 +00:00
COPYING Add COPYING 2014-01-16 02:31:28 +00:00
extension.json Revert "Make each gadget a separate preference, instead of one huge multiselect" 2021-10-07 19:52:18 +00:00
Gadgets.alias.php Add PL special page alias for "GadgetUsage" 2021-04-03 17:08:13 +02:00
Gadgets.namespaces.php Merge "Change Tigrinya translations for Gadgets namespaces" 2021-06-28 13:04:09 +00:00
Gruntfile.js build: Updating dependencies 2021-01-29 13:35:14 +00:00
package-lock.json build: Updating ansi-regex to 5.0.1 2021-10-04 22:12:57 +00:00
package.json build: Updating npm dependencies 2021-05-10 07:23:45 +00:00
README.md Merge "Use wfLoadExtension in README.md" 2016-12-23 21:46:44 +00:00

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.

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.