MediaWiki REL1_28
ResourceLoaderWikiModule Class Reference

Abstraction for ResourceLoader modules which pull from wiki pages. More...

Inheritance diagram for ResourceLoaderWikiModule:
Collaboration diagram for ResourceLoaderWikiModule:

Public Member Functions

 __construct (array $options=null)
 
 enableModuleContentVersion ()
 Disable module content versioning.
 
 getDefinitionSummary (ResourceLoaderContext $context)
 
 getGroup ()
 Get group name.
 
 getPosition ()
 
 getScript (ResourceLoaderContext $context)
 
 getStyles (ResourceLoaderContext $context)
 
 getType ()
 
 isKnownEmpty (ResourceLoaderContext $context)
 
- Public Member Functions inherited from ResourceLoaderModule
 getConfig ()
 
 getDefinitionMtime (ResourceLoaderContext $context)
 Back-compat dummy for old subclass implementations of getModifiedTime().
 
 getDependencies (ResourceLoaderContext $context=null)
 Get a list of modules this module depends on.
 
 getFlip ( $context)
 
 getHashMtime (ResourceLoaderContext $context)
 Back-compat dummy for old subclass implementations of getModifiedTime().
 
 getMessages ()
 Get the messages needed for this module.
 
 getModifiedHash (ResourceLoaderContext $context)
 Helper method for providing a version hash to getVersionHash().
 
 getModifiedTime (ResourceLoaderContext $context)
 Get this module's last modification timestamp for a given context.
 
 getModuleContent (ResourceLoaderContext $context)
 Get an array of this module's resources.
 
 getName ()
 Get this module's name.
 
 getOrigin ()
 Get this module's origin.
 
 getScriptURLsForDebug (ResourceLoaderContext $context)
 Get the URL or URLs to load for this module's JS in debug mode.
 
 getSkipFunction ()
 Get the skip function.
 
 getSource ()
 Get the origin of this module.
 
 getStyleURLsForDebug (ResourceLoaderContext $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 (ResourceLoaderContext $context)
 Get a string identifying the current version of this module in a given context.
 
 isRaw ()
 Whether this module's JS expects to work without the client-side ResourceLoader module.
 
 setConfig (Config $config)
 
 setFileDependencies (ResourceLoaderContext $context, $files)
 Set in-object cache for file dependencies.
 
 setLogger (LoggerInterface $logger)
 
 setMessageBlob ( $blob, $lang)
 Set in-object cache for message blobs.
 
 setName ( $name)
 Set this module's name.
 
 supportsURLLoading ()
 Whether this module supports URL loading.
 

Static Public Member Functions

static invalidateModuleCache (Title $title, Revision $old=null, Revision $new=null, $wikiId)
 Clear the preloadTitleInfo() cache for all wiki modules on this wiki on page change if it was a JS or CSS page.
 
static preloadTitleInfo (ResourceLoaderContext $context, IDatabase $db, array $moduleNames)
 
- Static Public Member Functions inherited from ResourceLoaderModule
static expandRelativePaths (array $filePaths)
 Expand directories relative to $IP.
 
static getRelativePaths (array $filePaths)
 Make file paths relative to MediaWiki directory.
 

Protected Member Functions

 getContent ( $titleText)
 
 getDB ()
 Get the Database object used in getTitleInfo().
 
 getPages (ResourceLoaderContext $context)
 Subclasses should return an associative array of resources in the module.
 
 getTitleInfo (ResourceLoaderContext $context)
 Get the information about the wiki pages for a given context.
 
- Protected Member Functions inherited from ResourceLoaderModule
 buildContent (ResourceLoaderContext $context)
 Bundle all resources attached to this module into an array.
 
 getDeprecationInformation ()
 Get JS representing deprecation information for the current module if available.
 
 getFileDependencies (ResourceLoaderContext $context)
 Get the files this module depends on indirectly for a given skin.
 
 getLessVars (ResourceLoaderContext $context)
 Get module-specific LESS variables, if any.
 
 getLogger ()
 
 getMessageBlob (ResourceLoaderContext $context)
 Get the hash of the message blob.
 
 saveFileDependencies (ResourceLoaderContext $context, $localFileRefs)
 Set the files this module depends on indirectly for a given skin.
 
 validateScriptFile ( $fileName, $contents)
 Validate a given script file; if valid returns the original source.
 

Static Protected Member Functions

static fetchTitleInfo (IDatabase $db, array $pages, $fname=__METHOD__)
 
- Static Protected Member Functions inherited from ResourceLoaderModule
static javaScriptParser ()
 
static safeFileHash ( $filePath)
 Compute a non-cryptographic string hash of a file's contents.
 
static safeFilemtime ( $filePath)
 Safe version of filemtime(), which doesn't throw a PHP warning if the file doesn't exist.
 

Protected Attributes

 $group
 
 $origin = self::ORIGIN_USER_SITEWIDE
 
string $position = 'bottom'
 Position on the page to load this module at.
 
 $scripts = []
 
 $styles = []
 
 $titleInfo = []
 
- Protected Attributes inherited from ResourceLoaderModule
Config $config
 
 $contents = []
 
array bool $deprecated = false
 
 $fileDeps = []
 
LoggerInterface $logger
 
 $msgBlobs = []
 
 $name = null
 
 $origin = self::ORIGIN_CORE_SITEWIDE
 
 $targets = [ 'desktop' ]
 
 $versionHash = []
 

Private Member Functions

 setTitleInfo ( $key, array $titleInfo)
 

Additional Inherited Members

- Public Attributes inherited from ResourceLoaderModule
const LOAD_GENERAL = 'general'
 
const LOAD_STYLES = 'styles'
 
const ORIGIN_ALL = 10
 
const ORIGIN_CORE_INDIVIDUAL = 2
 
const ORIGIN_CORE_SITEWIDE = 1
 
const ORIGIN_USER_INDIVIDUAL = 4
 
const ORIGIN_USER_SITEWIDE = 3
 
const TYPE_COMBINED = 'combined'
 
const TYPE_SCRIPTS = 'scripts'
 
const TYPE_STYLES = 'styles'
 

Detailed Description

Abstraction for ResourceLoader modules which pull from wiki pages.

This can only be used for wiki pages in the MediaWiki and User namespaces, because of its dependence on the functionality of Title::isCssJsSubpage and Title::isCssOrJsPage().

This module supports being used as a placeholder for a module on a remote wiki. To do so, getDB() must be overloaded to return a foreign database object that allows local wikis to query page metadata.

Safe for calls on local wikis are:

Definition at line 46 of file ResourceLoaderWikiModule.php.

Constructor & Destructor Documentation

◆ __construct()

ResourceLoaderWikiModule::__construct ( array  $options = null)
Parameters
array$optionsFor back-compat, this can be omitted in favour of overwriting getPages.

Definition at line 68 of file ResourceLoaderWikiModule.php.

References $options, and as.

Member Function Documentation

◆ enableModuleContentVersion()

ResourceLoaderWikiModule::enableModuleContentVersion ( )

Disable module content versioning.

This class does not support generating content outside of a module request due to foreign database support.

See getDefinitionSummary() for meta-data versioning.

Returns
bool

Reimplemented from ResourceLoaderModule.

Definition at line 238 of file ResourceLoaderWikiModule.php.

◆ fetchTitleInfo()

static ResourceLoaderWikiModule::fetchTitleInfo ( IDatabase  $db,
array  $pages,
  $fname = __METHOD__ 
)
staticprotected

Reimplemented in TestResourceLoaderWikiModule.

Definition at line 305 of file ResourceLoaderWikiModule.php.

References $batch, $fname, $res, $title, $titleInfo, as, and IDatabase\select().

◆ getContent()

ResourceLoaderWikiModule::getContent (   $titleText)
protected
Parameters
string$titleText
Returns
null|string

Definition at line 150 of file ResourceLoaderWikiModule.php.

References $content, $handler, $title, CONTENT_FORMAT_CSS, CONTENT_FORMAT_JAVASCRIPT, ContentHandler\getForTitle(), Revision\newFromTitle(), Revision\RAW, and wfDebugLog().

Referenced by getScript(), and getStyles().

◆ getDB()

ResourceLoaderWikiModule::getDB ( )
protected

Get the Database object used in getTitleInfo().

Defaults to the local replica DB. Subclasses may want to override this to return a foreign database object, or null if getTitleInfo() shouldn't access the database.

NOTE: This ONLY works for getTitleInfo() and isKnownEmpty(), NOT FOR ANYTHING ELSE. In particular, it doesn't work for getContent() or getScript() etc.

Returns
IDatabase|null

Definition at line 142 of file ResourceLoaderWikiModule.php.

References DB_REPLICA, and wfGetDB().

Referenced by getTitleInfo().

◆ getDefinitionSummary()

ResourceLoaderWikiModule::getDefinitionSummary ( ResourceLoaderContext  $context)
Parameters
ResourceLoaderContext$context
Returns
array

Reimplemented from ResourceLoaderModule.

Definition at line 246 of file ResourceLoaderWikiModule.php.

References $context, $summary, getPages(), and getTitleInfo().

◆ getGroup()

ResourceLoaderWikiModule::getGroup ( )

Get group name.

Returns
string

Reimplemented from ResourceLoaderModule.

Reimplemented in ResourceLoaderSiteStylesModule, ResourceLoaderUserModule, and ResourceLoaderUserStylesModule.

Definition at line 127 of file ResourceLoaderWikiModule.php.

References $group.

Referenced by isKnownEmpty().

◆ getPages()

ResourceLoaderWikiModule::getPages ( ResourceLoaderContext  $context)
protected

Subclasses should return an associative array of resources in the module.

Keys should be the title of a page in the MediaWiki or User namespace.

Values should be a nested array of options. The supported keys are 'type' and (CSS only) 'media'.

For scripts, 'type' should be 'script'.

For stylesheets, 'type' should be 'style'. There is an optional media key, the value of which can be the medium ('screen', 'print', etc.) of the stylesheet.

Parameters
ResourceLoaderContext$context
Returns
array

Reimplemented in ResourceLoaderSiteModule, ResourceLoaderSiteStylesModule, ResourceLoaderUserModule, and ResourceLoaderUserStylesModule.

Definition at line 102 of file ResourceLoaderWikiModule.php.

References ResourceLoaderModule\$config, as, Config\get(), ResourceLoaderModule\getConfig(), and scripts.

Referenced by getDefinitionSummary(), getScript(), getStyles(), and getTitleInfo().

◆ getPosition()

ResourceLoaderWikiModule::getPosition ( )
Returns
string

Reimplemented from ResourceLoaderModule.

Definition at line 440 of file ResourceLoaderWikiModule.php.

References $position.

◆ getScript()

ResourceLoaderWikiModule::getScript ( ResourceLoaderContext  $context)

◆ getStyles()

ResourceLoaderWikiModule::getStyles ( ResourceLoaderContext  $context)

◆ getTitleInfo()

ResourceLoaderWikiModule::getTitleInfo ( ResourceLoaderContext  $context)
protected

Get the information about the wiki pages for a given context.

Parameters
ResourceLoaderContext$context
Returns
array Keyed by page name

Definition at line 289 of file ResourceLoaderWikiModule.php.

References $dbr, getDB(), and getPages().

Referenced by getDefinitionSummary(), and isKnownEmpty().

◆ getType()

ResourceLoaderWikiModule::getType ( )
Since
1.28
Returns
string

Reimplemented from ResourceLoaderModule.

Reimplemented in ResourceLoaderSiteStylesModule, and ResourceLoaderUserStylesModule.

Definition at line 448 of file ResourceLoaderWikiModule.php.

References ResourceLoaderModule\LOAD_GENERAL, ResourceLoaderModule\LOAD_STYLES, and scripts.

◆ invalidateModuleCache()

static ResourceLoaderWikiModule::invalidateModuleCache ( Title  $title,
Revision  $old = null,
Revision  $new = null,
  $wikiId 
)
static

Clear the preloadTitleInfo() cache for all wiki modules on this wiki on page change if it was a JS or CSS page.

Parameters
Title$title
Revision | null$oldPrior page revision
Revision | null$newNew page revision
string$wikiId
Since
1.28

Definition at line 417 of file ResourceLoaderWikiModule.php.

References $cache, $title, CONTENT_FORMAT_CSS, and CONTENT_FORMAT_JAVASCRIPT.

Referenced by WikiPage\doDeleteUpdates(), WikiPage\doEditUpdates(), Title\invalidateCache(), and ResourceLoaderWikiModuleTest\testGetPreloadedTitleInfo().

◆ isKnownEmpty()

ResourceLoaderWikiModule::isKnownEmpty ( ResourceLoaderContext  $context)
Parameters
ResourceLoaderContext$context
Returns
bool

Reimplemented from ResourceLoaderModule.

Definition at line 260 of file ResourceLoaderWikiModule.php.

References as, getGroup(), and getTitleInfo().

◆ preloadTitleInfo()

static ResourceLoaderWikiModule::preloadTitleInfo ( ResourceLoaderContext  $context,
IDatabase  $db,
array  $moduleNames 
)
static

◆ setTitleInfo()

ResourceLoaderWikiModule::setTitleInfo (   $key,
array  $titleInfo 
)
private

Definition at line 280 of file ResourceLoaderWikiModule.php.

References $titleInfo.

Member Data Documentation

◆ $group

ResourceLoaderWikiModule::$group
protected

◆ $origin

ResourceLoaderWikiModule::$origin = self::ORIGIN_USER_SITEWIDE
protected

Definition at line 51 of file ResourceLoaderWikiModule.php.

◆ $position

string ResourceLoaderWikiModule::$position = 'bottom'
protected

Position on the page to load this module at.

Definition at line 48 of file ResourceLoaderWikiModule.php.

Referenced by getPosition().

◆ $scripts

ResourceLoaderWikiModule::$scripts = []
protected

Definition at line 60 of file ResourceLoaderWikiModule.php.

Referenced by getScript().

◆ $styles

ResourceLoaderWikiModule::$styles = []
protected

Definition at line 57 of file ResourceLoaderWikiModule.php.

Referenced by getStyles().

◆ $titleInfo

ResourceLoaderWikiModule::$titleInfo = []
protected

Definition at line 54 of file ResourceLoaderWikiModule.php.

Referenced by fetchTitleInfo(), and setTitleInfo().


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