wiki.techinc.nl/includes/Hook/MakeGlobalVariablesScriptHook.php
libraryupgrader 5357695270 build: Updating dependencies
composer:
* mediawiki/mediawiki-codesniffer: 36.0.0 → 37.0.0
  The following sniffs now pass and were enabled:
  * Generic.ControlStructures.InlineControlStructure
  * MediaWiki.PHPUnit.AssertCount.NotUsed

npm:
* svgo: 2.3.0 → 2.3.1
  * https://npmjs.com/advisories/1754 (CVE-2021-33587)

Change-Id: I2a9bbee2fecbf7259876d335f565ece4b3622426
2021-07-22 03:36:05 +00:00

34 lines
1.2 KiB
PHP

<?php
namespace MediaWiki\Hook;
use OutputPage;
/**
* This is a hook handler interface, see docs/Hooks.md.
* Use the hook name "MakeGlobalVariablesScript" to register handlers implementing this interface.
*
* @stable to implement
* @ingroup Hooks
*/
interface MakeGlobalVariablesScriptHook {
/**
* Export user- or page-specific `mw.config` variables to JavaScript.
*
* When using this hook, be as selective as possible about when the data is set.
* Reduce the cost by setting values only for specific titles, namespaces, or user-rights.
*
* Data exported here is transmitted with the highest possible bandwidth priority (ahead of
* page content even). Any data that is not dependant on the current request, should go
* through MediaWiki\ResourceLoader\Hook\ResourceLoaderGetConfigVarsHook instead.
*
* This hook is called from OutputPage::getJSVars.
*
* @since 1.35
*
* @param array &$vars Variable (or multiple variables)
* @param OutputPage $out OutputPage which called the hook, can be used to get the real title
* @return void This hook must not abort, it must return no value
*/
public function onMakeGlobalVariablesScript( &$vars, $out ): void;
}