Module for user customizations scripts. More...

Inherits MediaWiki\ResourceLoader\WikiModule.

Collaboration diagram for MediaWiki\ResourceLoader\UserModule:

[legend]

Public Member Functions
	getGroup ()
	Get group name.

Public Member Functions inherited from MediaWiki\ResourceLoader\WikiModule
	__construct (array $options=null)

	enableModuleContentVersion ()
	Disable module content versioning.

	getDefinitionSummary (Context $context)

	getScript (Context $context)

	getStyles (Context $context)

	getType ()

	isKnownEmpty (Context $context)

	shouldEmbedModule (Context $context)

	supportsURLLoading ()

Public Member Functions inherited from MediaWiki\ResourceLoader\Module
	getConfig ()

	getDependencies (Context $context=null)
	Get a list of modules this module depends on.

	getDeprecationInformation (Context $context)
	Get JS representing deprecation information for the current module if available.

	getFlip (Context $context)

	getHeaders (Context $context)
	Get headers to send as part of a module web response.

	getMessages ()
	Get the messages needed for this module.

	getModuleContent (Context $context)
	Get an array of this module's resources.

	getName ()
	Get this module's name.

	getOrigin ()
	Get this module's origin.

	getScriptURLsForDebug (Context $context)
	Get alternative script URLs for legacy debug mode.

	getSkins ()
	Get list of skins for which this module must be available to load.

	getSkipFunction ()
	Get the skip function.

	getSource ()
	Get the source of this module.

	getStyleURLsForDebug (Context $context)
	Get the URL or URLs to load for this module's CSS in debug mode.

	getTargets ()
	Get target(s) for the module, eg ['desktop'] or ['desktop', 'mobile'].

	getTemplates ()
	Takes named templates by the module and returns an array mapping.

	getVersionHash (Context $context)
	Get a string identifying the current version of this module in a given context.

	requiresES6 ()
	Whether the module requires ES6 support in the client.

	setConfig (Config $config)

	setDependencyAccessCallbacks (callable $loadCallback, callable $saveCallback)
	Inject the functions that load/save the indirect file path dependency list from storage.

	setFileDependencies (Context $context, array $paths)
	Set the indirect dependencies for this module pursuant to the skin/language context.

	setHookContainer (HookContainer $hookContainer)

	setLogger (LoggerInterface $logger)

	setMessageBlob ( $blob, $lang)
	Set in-object cache for message blobs.

	setName ( $name)
	Set this module's name.

	setSkinStylesOverride (array $moduleSkinStyles)
	Provide overrides for skinStyles to modules that support that.

Protected Member Functions
	getPages (Context $context)

Protected Member Functions inherited from MediaWiki\ResourceLoader\WikiModule
	getContent ( $titleText, Context $context)

	getContentObj (PageIdentity $page, Context $context, $maxRedirects=1)

	getDB ()
	Get the Database handle used for computing the module version.

	getRequireKey (string $titleText)
	Convert a namespace-formatted page title to a virtual package file name.

	getTitleInfo (Context $context)
	Get the information about the wiki pages for a given context.

	isPackaged ()
	Get whether this module is a packaged module.

Protected Member Functions inherited from MediaWiki\ResourceLoader\Module
	buildContent (Context $context)
	Bundle all resources attached to this module into an array.

	getFileDependencies (Context $context)
	Get the indirect dependencies for this module pursuant to the skin/language context.

	getHookRunner ()
	Get a HookRunner for running core hooks.

	getLessVars (Context $context)
	Get module-specific LESS variables, if any.

	getLogger ()

	getMessageBlob (Context $context)
	Get the hash of the message blob.

	getPreloadLinks (Context $context)
	Get a list of resources that web browsers may preload.

	saveFileDependencies (Context $context, array $curFileRefs)
	Save the indirect dependencies for this module pursuant to the skin/language context.

	validateScriptFile ( $fileName, $contents)
	Validate a user-provided JavaScript blob.

Protected Attributes
	$origin = self::ORIGIN_USER_INDIVIDUAL

Protected Attributes inherited from MediaWiki\ResourceLoader\WikiModule
array	$datas = []
	List of page names that contain JSON.

string null	$group
	Group of module.

string	$origin = self::ORIGIN_USER_SITEWIDE
	Origin defaults to users with sitewide authority.

array	$scripts = []
	List of page names that contain JavaScript.

array	$styles = []
	List of page names that contain CSS.

array	$titleInfo = []
	In-process cache for title info, structured as an array [ <batchKey> // Pipe-separated list of sorted keys from getPages => [ <titleKey> => [ // Normalised title key 'page_len' => .., 'page_latest' => .., 'page_touched' => .., ] ] ].

Protected Attributes inherited from MediaWiki\ResourceLoader\Module
Config	$config

array	$contents = []
	Map of (context hash => cached module content)

string bool	$deprecated = false
	Deprecation string or true if deprecated; false otherwise.

array	$fileDeps = []
	Map of (variant => indirect file dependencies)

LoggerInterface	$logger

array	$msgBlobs = []
	Map of (language => in-object cache for message blob)

string null	$name = null
	Module name.

int	$origin = self::ORIGIN_CORE_SITEWIDE
	Script and style modules form a hierarchy of trustworthiness, with core modules like skins and jQuery as most trustworthy, and user scripts as least trustworthy.

string[] null	$skins = null
	Skin names.

string[]	$targets = [ 'desktop', 'mobile' ]
	What client platforms the module targets (e.g.

array	$versionHash = []
	Map of (context hash => cached module version hash)

Additional Inherited Members
Static Public Member Functions inherited from MediaWiki\ResourceLoader\WikiModule
static	invalidateModuleCache (PageIdentity $page, ?RevisionRecord $old, ?RevisionRecord $new, string $domain)
	Clear the preloadTitleInfo() cache for all wiki modules on this wiki on page change if it was a JS or CSS page.

static	preloadTitleInfo (Context $context, IDatabase $db, array $moduleNames)

Static Public Member Functions inherited from MediaWiki\ResourceLoader\Module
static	expandRelativePaths (array $filePaths)
	Expand directories relative to $IP.

static	getRelativePaths (array $filePaths)
	Make file paths relative to MediaWiki directory.

static	getVary (Context $context)
	Get vary string.

Static Protected Member Functions inherited from MediaWiki\ResourceLoader\WikiModule
static	fetchTitleInfo (IReadableDatabase $db, array $pages, $fname=__METHOD__)

Static Protected Member Functions inherited from MediaWiki\ResourceLoader\Module
static	safeFileHash ( $filePath)
	Compute a non-cryptographic string hash of a file's contents.

Detailed Description

Module for user customizations scripts.

Access: internal

Definition at line 35 of file UserModule.php.

Member Function Documentation

◆ getGroup()

MediaWiki\ResourceLoader\UserModule::getGroup ( )

Get group name.

Returns: string

Reimplemented from MediaWiki\ResourceLoader\WikiModule.

Definition at line 78 of file UserModule.php.

◆ getPages()

MediaWiki\ResourceLoader\UserModule::getPages ( Context $context )

protected

Parameters

Context $context

Returns: array[]

Reimplemented from MediaWiki\ResourceLoader\WikiModule.

Definition at line 42 of file UserModule.php.

References MediaWiki\ResourceLoader\Module\$config, MediaWiki\ResourceLoader\WikiModule\$group, MediaWiki\MainConfigNames\AllowUserJs, Config\get(), MediaWiki\ResourceLoader\Module\getConfig(), MediaWiki\MediaWikiServices\getInstance(), MediaWiki\ResourceLoader\Context\getSkin(), MediaWiki\ResourceLoader\Context\getUserIdentity(), NS_USER, and MediaWiki\MainConfigNames\UseSiteJs.

Member Data Documentation

◆ $origin

MediaWiki\ResourceLoader\UserModule::$origin = self::ORIGIN_USER_INDIVIDUAL

protected

Definition at line 36 of file UserModule.php.

The documentation for this class was generated from the following file:

includes/ResourceLoader/UserModule.php

Public Member Functions

Protected Member Functions