Manual:Hooks/ResourceLoaderGetConfigVars/ru

From mediawiki.org
This page is a translated version of the page Manual:Hooks/ResourceLoaderGetConfigVars and the translation is 9% complete.
ResourceLoaderGetConfigVars
Доступен с version 1.17.0
Called right before ResourceLoaderStartUpModule::getConfig returns, to set static (not request-specific) configuration variables. Can not depend on current page, current user or current request; see below.
Определяет функцию:
public static function onResourceLoaderGetConfigVars( array &$vars, string $skin, Config $config ) { ... }
Прикрепить хук: В extension.json:
{
	"Hooks": {
		"ResourceLoaderGetConfigVars": "MediaWiki\\Extension\\MyExtension\\Hooks::onResourceLoaderGetConfigVars"
	}
}
Вызывается из: Файла(Файлов): resourceloader/ResourceLoaderStartUpModule.php
Interface: ResourceLoaderGetConfigVarsHook.php

Для получения дополнительной информации о присоединении перехватчиков, см Руководство:Хуки .
Примеры расширений с использованием этого хука см. в Category:ResourceLoaderGetConfigVars extensions/ru.

Details

ResourceLoaderStartUpModule::getConfig() runs this hook. Use it to export static configuration variables to JavaScript. Values that depend on the current page, user or request state must be added through MakeGlobalVariablesScript instead.

  • &$vars - Array of variables to be added into the output of the startup module.
  • $skin - (введено в 1.32) Current skin name to restrict config variables to a certain skin (if needed)
  • $config - (введено в 1.34)

Example

Register the configuration variables from the hook:

class VisualEditorHooks {
	public static function onResourceLoaderGetConfigVars( array &$vars, string $skin, Config $config ) {
		$vars['wgVisualEditor'] = [
			'disableForAnons' => $config->get( 'VisualEditorDisableForAnons' ),
			'enableExperimentalCode' => $config->get( 'VisualEditorEnableExperimentalCode' ),
		];

		return true;
	}
}

Retrieve them using mw.config , like:

conf = mw.config.get( 'wgVisualEditor' );
if ( conf.disableForAnons ) {
	// Do stuff
}

См. также