Extension:GlobalCssJs
![]() Release status: stable |
|
---|---|
Implementation | Skin , MyWiki |
Description | Allows global CSS and JS on a "central" wiki to be loaded for all wikis in the farm |
Author(s) |
|
Latest version | 3.4.0 |
MediaWiki | 1.31+ |
PHP | 7.0+ |
License | GNU General Public License 2.0 or later |
Download | Usage |
Help | Help:Extension:GlobalCssJs |
|
|
Quarterly downloads | 28 (Ranked 147th) |
Translate the GlobalCssJs extension | |
Issues | Open tasks · Report a bug |
The GlobalCssJs extension allows loading CSS and JavaScript (JS) from a central wiki.
It supports wiki farm-wide and individual site-wide "MediaWiki:Global.js"/"MediaWiki:Global.css" pages and per-user "User:$username/global.js"/"User:$username/global.css" pages on a specified central wiki. The term "global" is used to mean across a wiki farm (compare with Extension:GlobalUsage) and the capitalization ("Css" and "Js") is due to MediaWiki extension naming conventions.
InstallationEdit
- Download and place the file(s) in a directory called
GlobalCssJs
in yourextensions/
folder. - Add the following code at the bottom of your
LocalSettings.php
:wfLoadExtension( 'GlobalCssJs' );
- Configure as required.
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
ConfigurationEdit
wgUseGlobalSiteCssJsEdit
Whether to enable MediaWiki:Global.js/MediaWiki:Global.css pages. By default enabled.
$wgUseGlobalSiteCssJs = true;
wgGlobalCssJsConfigEdit
ResourceLoader configuration of the global wiki. By default, no global wiki is specified.
$wgGlobalCssJsConfig = array(
'wiki' => false,
'source' => false,
);
'wiki'
should be set to the database name of the central wiki.'source'
should be the name of the ResourceLoader source.
An example configuration might look like:
$wgGlobalCssJsConfig = array(
'wiki' => 'metawiki',
'source' => 'metawiki',
);
// 'source' must point to a key in $wgResourceLoaderSources, like so:
// $wgResourceLoaderSources['metawiki'] = array(
// 'apiScript' => 'https://meta.wikimedia.org/w/api.php',
// 'loadScript' => 'https://meta.wikimedia.org/w/load.php',
//);
To test it our locally without a central repository, point it at the local wiki, like so:
$wgGlobalCssJsConfig = array(
'wiki' => $wgDBname,
'source' => 'local',
);
HookEdit
If you are not using shared user tables for managing users, you can use a hook to state whether a user on one wiki is equal to another.
public static function onLoadGlobalCssJs( User $user, $centralWiki, $localWiki );
$centralWiki
is the wiki the JS/CSS is being taken from, and $localWiki
is the current wiki the request is being executed on. The hook will not be called if $centralWiki === $localWiki
.
The function should return true if the users are the same, and false if they are not. An example subscriber can be found in the CentralAuth extension.
UsageEdit
See Help:Extension:GlobalCssJs for details.
This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
This extension is included in the following packages and/or wiki farms: This is not an authoritative list. Some wiki farms/hosts may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |