wikimedia/mediawiki-extensions-Gadgets
1
0
Fork 0
mirror of https://gerrit.wikimedia.org/r/mediawiki/extensions/Gadgets synced 2024-11-15 11:31:40 +00:00
Code Issues Packages Projects Releases Wiki Activity
Mirror of https://gerrit.wikimedia.org/g/mediawiki/extensions/Gadgets
643 commits 164 branches 5 tags 21 MiB
PHP 99.7%
JavaScript 0.3%
Go to file
Liangent cbef9a4faf Followup r100497, r101827: use another way which doesn't look that hacky to load styles in gadgets before documents. Also avoid double loading of the same stylesheet. 
Now a gadget generates up to three modules:
* The first is known as meta module which still use its original name to keep B/C. It contains no contents, with dependencies of ones specified by user, scripts module, and styles module. See below.
* The second is known as scripts module whose name ends with ".scripts". It contains all scripts in this gadgets, with dependencies specified by user
* The third is known as styles module whose name ends with ".styles". It contains all styles in this gadgets and loaded before documents. After its load it's instantly marked as ready without dependencies resolved (which is the same as dependencies of .scripts but may not be used at all)

The meta module is loaded as if there's only one module under that name, and it's safe for users to reuse that name. The styles module is loaded and marked as ready in <head>, as described above. Normally the scripts and styles modules shouldn't be used by users.

A possible bug that dependency-only gadgets (ie. no scripts or styles) may not be loaded is fixed.
2011-12-13 10:41:51 +00:00
ApiQueryGadgetCategories.php stylize.php, update whitespace, remove superfluous comment lines 2011-09-23 06:48:37 +00:00
ApiQueryGadgets.php (bug 31414) Skin specific gadgets 2011-10-22 19:09:25 +00:00
Gadgets.alias.php Update for magic words and special pages localisation for extensions from http://translatewiki.net. 2011-09-13 13:33:40 +00:00
Gadgets.i18n.php Localisation updates for core and extension messages from translatewiki.net 2011-12-03 14:56:00 +00:00
Gadgets.php stylize.php, update whitespace, remove superfluous comment lines 2011-09-23 06:48:37 +00:00
Gadgets_body.php Followup r100497, r101827: use another way which doesn't look that hacky to load styles in gadgets before documents. Also avoid double loading of the same stylesheet. 2011-12-13 10:41:51 +00:00
Gadgets_tests.php stylize.php, update whitespace, remove superfluous comment lines 2011-09-23 06:48:37 +00:00
install.settings Whitespace fixes 2008-02-04 08:08:43 +00:00
README stylize.php, update whitespace, remove superfluous comment lines 2011-09-23 06:48:37 +00:00
SpecialGadgets.php (bug 31414) Skin specific gadgets 2011-10-22 19:09:25 +00:00

README 

--------------------------------------------------------------------------
README for the Gadgets extension
Copyright © 2007 Daniel Kinzler
Licenses: GNU General Public Licence (GPL)
          GNU Free Documentation License (GFDL)
--------------------------------------------------------------------------

The Gadgets extension provides a way for users to pick JavaScript or CSS
based "gadgets" that other wiki users provide.

<http://mediawiki.org/wiki/Extension:Gadgets>

The Gadgets extension was originally written by Daniel Kinzler in 2007
and is released under the GNU General Public Licence (GPL).
The internationalization files may contain contributions by several people;
they should be mentioned in each file individually.

== Prerequisites ==
This version of Gadgets requires MediaWiki 1.17 or later. To get a version
compatible with earlier MediaWiki release, visit
    http://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):

  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
  Special:ResetPass so users can always disable any broken gadgets they
  may have enabled, and malicious gadgets will be unable to steal passwords.
* Uses BeforePageDisplay hook, thus only works with MonoBook based skins;
  specifically, does not work with CologneBlue.
* Gadget code is included after user code - that means that user JS has no
  access to things defined in gadgets, and user CSS is overwritten by CSS
  from gadgets. (pending a better way to insert things into the HTML head)