A service class to control user options. More...

Inheritance diagram for MediaWiki\User\UserOptionsManager:

Collaboration diagram for MediaWiki\User\UserOptionsManager:

[legend]

Public Member Functions

__construct (ServiceOptions $options, DefaultOptionsLookup $defaultOptionsLookup, LanguageConverterFactory $languageConverterFactory, ILoadBalancer $loadBalancer, LoggerInterface $logger, HookContainer $hookContainer, UserFactory $userFactory)

clearUserOptionsCache (UserIdentity $user)

Clears cached user options. More...

getDefaultOptions ()

Combine the language default options with any site-specific options and add the default language variants.

Returns: array

More...

getOption (UserIdentity $user, string $oname, $defaultOverride=null, bool $ignoreHidden=false, int $queryFlags=self::READ_NORMAL)

Get the user's current setting for a given option.

Parameters

UserIdentity	$user	The user to get the option for
string	$oname	The option to check
mixed \| null	$defaultOverride	A default value returned if the option does not exist
bool	$ignoreHidden	Whether to ignore the effects of $wgHiddenPrefs
int	$queryFlags	A bit field composed of READ_XXX flags

Returns: mixed|null User's current value for the option

See also: getBoolOption(); getIntOption()

More...

getOptionKinds (UserIdentity $userIdentity, IContextSource $context, $options=null)

Return an associative array mapping preferences keys to the kind of a preference they're used for. More...

getOptions (UserIdentity $user, int $flags=0, int $queryFlags=self::READ_NORMAL)

Get all user's options.

Parameters

UserIdentity	$user	The user to get the option for
int	$flags	Bitwise combination of: UserOptionsManager::EXCLUDE_DEFAULTS Exclude user options that are set to the default value.
int	$queryFlags	A bit field composed of READ_XXX flags

Returns: array

More...

listOptionKinds ()

Return a list of the types of user options currently returned by UserOptionsManager::getOptionKinds(). More...

loadUserOptions (UserIdentity $user, int $queryFlags=self::READ_NORMAL, array $data=null)

Loads user options either from cache or from the database. More...

resetOptions (UserIdentity $user, IContextSource $context, $resetKinds=[ 'registered', 'registered-multiselect', 'registered-checkmatrix', 'unused'])

Reset certain (or all) options to the site defaults. More...

saveOptions (UserIdentity $user)

Saves the non-default options for this user, as previously set e.g. More...

saveOptionsInternal (UserIdentity $user, IDatabase $dbw)

Saves the non-default options for this user, as previously set e.g. More...

setOption (UserIdentity $user, string $oname, $val)

Set the given option for a user. More...

Public Member Functions inherited from MediaWiki\User\UserOptionsLookup

getBoolOption (UserIdentity $user, string $oname, int $queryFlags=self::READ_NORMAL)

Get the user's current setting for a given option, as a boolean value. More...

getDefaultOption (string $opt)

Get a given default option value. More...

getIntOption (UserIdentity $user, string $oname, int $defaultOverride=0, int $queryFlags=self::READ_NORMAL)

Get the user's current setting for a given option, as an integer value. More...

Public Attributes
const	CONSTRUCTOR_OPTIONS

Public Attributes inherited from MediaWiki\User\UserOptionsLookup
const	EXCLUDE_DEFAULTS = 1
	Exclude user options that are set to their default value. More...

Public Attributes inherited from IDBAccessObject
const	READ_NONE = -1
	Constants for object loading bitfield flags (higher => higher QoS) More...

Private Member Functions
	canUseCachedValues (UserIdentity $user, int $queryFlags)
	Determines if it's ok to use cached options values for a given user and query flags. More...

	getCacheKey (UserIdentity $user)
	Gets a key for various caches. More...

	getDBAndOptionsForQueryFlags ( $queryFlags)

	isValueEqual ( $a, $b)
	Determines whether two values are sufficiently similar that the database does not need to be updated to reflect the change. More...

	loadOptionsFromDb (UserIdentity $user, int $queryFlags, array $prefetchedOptions=null)
	Fetches the options directly from the database with no caches. More...

	loadOriginalOptions (UserIdentity $user, int $queryFlags=self::READ_NORMAL, array $data=null)
	Loads the original user options from the database and applies various transforms, like timecorrection. More...

	setOptionsFromDb (UserIdentity $user, int $queryFlags, iterable $rows)
	Builds associative options array from rows fetched from DB. More...

Private Attributes
DefaultOptionsLookup	$defaultOptionsLookup

HookRunner	$hookRunner

LanguageConverterFactory	$languageConverterFactory

ILoadBalancer	$loadBalancer

LoggerInterface	$logger

array	$modifiedOptions = []
	options modified withing this request More...

array	$optionsFromDb = []
	Cached original user options as fetched from database, no adjustments applied. More...

array	$originalOptionsCache = []
	Cached original user options with all the adjustments like time correction and hook changes applied. More...

array	$queryFlagsUsedForCaching = []
	Query flags used to retrieve options from database. More...

ServiceOptions	$serviceOptions

UserFactory	$userFactory

Detailed Description

A service class to control user options.

Since: 1.35

Definition at line 44 of file UserOptionsManager.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\User\UserOptionsManager::__construct	(	ServiceOptions	$options,
		DefaultOptionsLookup	$defaultOptionsLookup,
		LanguageConverterFactory	$languageConverterFactory,
		ILoadBalancer	$loadBalancer,
		LoggerInterface	$logger,
		HookContainer	$hookContainer,
		UserFactory	$userFactory
	)

Parameters

ServiceOptions	$options
DefaultOptionsLookup	$defaultOptionsLookup
LanguageConverterFactory	$languageConverterFactory
ILoadBalancer	$loadBalancer
LoggerInterface	$logger
HookContainer	$hookContainer
UserFactory	$userFactory

Definition at line 103 of file UserOptionsManager.php.

References MediaWiki\User\UserOptionsManager\$defaultOptionsLookup, MediaWiki\User\UserOptionsManager\$languageConverterFactory, MediaWiki\User\UserOptionsManager\$loadBalancer, MediaWiki\User\UserOptionsManager\$logger, MediaWiki\User\UserOptionsManager\$userFactory, and MediaWiki\Config\ServiceOptions\assertRequiredOptions().

Member Function Documentation

◆ canUseCachedValues()

MediaWiki\User\UserOptionsManager::canUseCachedValues	(	UserIdentity	$user,
		int	$queryFlags
	)

private

Determines if it's ok to use cached options values for a given user and query flags.

Parameters

UserIdentity	$user
int	$queryFlags

Returns: bool

Definition at line 663 of file UserOptionsManager.php.

◆ clearUserOptionsCache()

MediaWiki\User\UserOptionsManager::clearUserOptionsCache ( UserIdentity $user )

Clears cached user options.

Access: internal: To be used by User::clearInstanceCache

Parameters

UserIdentity $user

Definition at line 507 of file UserOptionsManager.php.

◆ getCacheKey()

MediaWiki\User\UserOptionsManager::getCacheKey ( UserIdentity $user )

private

Gets a key for various caches.

Parameters

UserIdentity $user

Returns: string

Definition at line 644 of file UserOptionsManager.php.

◆ getDBAndOptionsForQueryFlags()

MediaWiki\User\UserOptionsManager::getDBAndOptionsForQueryFlags ( $queryFlags )

private

Parameters

int $queryFlags a bit field composed of READ_XXX flags

Returns: array [ IDatabase $db, array $options ]

Definition at line 652 of file UserOptionsManager.php.

◆ getDefaultOptions()

MediaWiki\User\UserOptionsManager::getDefaultOptions ( )

Combine the language default options with any site-specific options and add the default language variants.

Returns: array

Reimplemented from MediaWiki\User\UserOptionsLookup.

Definition at line 125 of file UserOptionsManager.php.

◆ getOption()

MediaWiki\User\UserOptionsManager::getOption	(	UserIdentity	$user,
		string	$oname,
			$defaultOverride = `null`,
		bool	$ignoreHidden = `false`,
		int	$queryFlags = `self::READ_NORMAL`
	)

Get the user's current setting for a given option.

Parameters

UserIdentity	$user	The user to get the option for
string	$oname	The option to check
mixed \| null	$defaultOverride	A default value returned if the option does not exist
bool	$ignoreHidden	Whether to ignore the effects of $wgHiddenPrefs
int	$queryFlags	A bit field composed of READ_XXX flags

Returns: mixed|null User's current value for the option

See also: getBoolOption(); getIntOption()

Reimplemented from MediaWiki\User\UserOptionsLookup.

Definition at line 132 of file UserOptionsManager.php.

References MediaWiki\MainConfigNames\HiddenPrefs.

◆ getOptionKinds()

MediaWiki\User\UserOptionsManager::getOptionKinds	(	UserIdentity	$userIdentity,
		IContextSource	$context,
			$options = `null`
	)

Return an associative array mapping preferences keys to the kind of a preference they're used for.

Different kinds are handled differently when setting or reading preferences.

See UserOptionsManager::listOptionKinds for the list of valid option types that can be provided.

See also: UserOptionsManager::listOptionKinds

Parameters

UserIdentity	$userIdentity
IContextSource	$context
array \| null	$options	Assoc. array with options keys to check as keys. Defaults user options.

Returns: string[] The key => kind mapping data

Definition at line 303 of file UserOptionsManager.php.

◆ getOptions()

MediaWiki\User\UserOptionsManager::getOptions	(	UserIdentity	$user,
		int	$flags = `0`,
		int	$queryFlags = `self::READ_NORMAL`
	)

Get all user's options.

Parameters

UserIdentity	$user	The user to get the option for
int	$flags	Bitwise combination of: UserOptionsManager::EXCLUDE_DEFAULTS Exclude user options that are set to the default value.
int	$queryFlags	A bit field composed of READ_XXX flags

Returns: array

Reimplemented from MediaWiki\User\UserOptionsLookup.

Definition at line 158 of file UserOptionsManager.php.

◆ isValueEqual()

MediaWiki\User\UserOptionsManager::isValueEqual	(	$a,
		$b
	)

private

Determines whether two values are sufficiently similar that the database does not need to be updated to reflect the change.

This is basically the same as comparing the result of Database::addQuotes().

Parameters

mixed	$a
mixed	$b

Returns: bool

Definition at line 683 of file UserOptionsManager.php.

◆ listOptionKinds()

MediaWiki\User\UserOptionsManager::listOptionKinds ( )

Return a list of the types of user options currently returned by UserOptionsManager::getOptionKinds().

Currently, the option kinds are:

'registered' - preferences which are registered in core MediaWiki or by extensions using the UserGetDefaultOptions hook.
'registered-multiselect' - as above, using the 'multiselect' type.
'registered-checkmatrix' - as above, using the 'checkmatrix' type.
'userjs' - preferences with names starting with 'userjs-', intended to be used by user scripts.
'special' - "preferences" that are not accessible via UserOptionsLookup::getOptions or UserOptionsManager::setOptions.
'unused' - preferences about which MediaWiki doesn't know anything. These are usually legacy options, removed in newer versions.

The API (and possibly others) use this function to determine the possible option types for validation purposes, so make sure to update this when a new option kind is added.

See also: getOptionKinds

Returns: string[] Option kinds

Definition at line 279 of file UserOptionsManager.php.

◆ loadOptionsFromDb()

MediaWiki\User\UserOptionsManager::loadOptionsFromDb	(	UserIdentity	$user,
		int	$queryFlags,
		array	$prefetchedOptions = `null`
	)

private

Fetches the options directly from the database with no caches.

Parameters

UserIdentity	$user
int	$queryFlags
array \| null	$prefetchedOptions

Returns: array

Definition at line 523 of file UserOptionsManager.php.

References $dbr, $res, and MediaWiki\User\UserIdentity\getId().

◆ loadOriginalOptions()

MediaWiki\User\UserOptionsManager::loadOriginalOptions	(	UserIdentity	$user,
		int	$queryFlags = `self::READ_NORMAL`,
		array	$data = `null`
	)

private

Loads the original user options from the database and applies various transforms, like timecorrection.

Runs hooks.

Parameters

UserIdentity	$user
int	$queryFlags
array \| null	$data	associative array of non-default options

Returns: array

Definition at line 590 of file UserOptionsManager.php.

◆ loadUserOptions()

MediaWiki\User\UserOptionsManager::loadUserOptions	(	UserIdentity	$user,
		int	$queryFlags = `self::READ_NORMAL`,
		array	$data = `null`
	)

Loads user options either from cache or from the database.

Note: Query flags are ignored for anons, since they do not have any options stored in the database. If the UserIdentity was itself obtained from a replica and doesn't have ID set due to replication lag, it will be treated as anon regardless of the query flags passed here.

Parameters

UserIdentity	$user
int	$queryFlags
array \| null	$data	associative array of non-default options.

Returns: array

Access: internal: To be called by User loading code to provide the $data

Definition at line 492 of file UserOptionsManager.php.

◆ resetOptions()

MediaWiki\User\UserOptionsManager::resetOptions	(	UserIdentity	$user,
		IContextSource	$context,
			$resetKinds = `[ 'registered'`,
		'registered-multiselect'	,
		'registered-checkmatrix'	,
		'unused']
	)

Reset certain (or all) options to the site defaults.

The optional parameter determines which kinds of preferences will be reset. Supported values are everything that can be reported by getOptionKinds() and 'all', which forces a reset of all preferences and overrides everything else.

Note: You need to call saveOptions() to actually write to the database.

Parameters

UserIdentity	$user
IContextSource	$context	Context source used when $resetKinds does not contain 'all'.
array \| string	$resetKinds	Which kinds of preferences to reset. Defaults to [ 'registered', 'registered-multiselect', 'registered-checkmatrix', 'unused' ]

Definition at line 222 of file UserOptionsManager.php.

◆ saveOptions()

MediaWiki\User\UserOptionsManager::saveOptions ( UserIdentity $user )

Saves the non-default options for this user, as previously set e.g.

via setOption(), in the database's "user_properties" (preferences) table.

Since: 1.38, this method was internal before that.

Parameters

UserIdentity $user

Definition at line 389 of file UserOptionsManager.php.

References DB_PRIMARY.

◆ saveOptionsInternal()

MediaWiki\User\UserOptionsManager::saveOptionsInternal	(	UserIdentity	$user,
		IDatabase	$dbw
	)

Saves the non-default options for this user, as previously set e.g.

via setOption(), in the database's "user_properties" (preferences) table.

Parameters

UserIdentity	$user
IDatabase	$dbw

Returns: bool true if options were changed and new options successfully saved.

Access: internal: only public for use in User::saveSettings

Definition at line 415 of file UserOptionsManager.php.

◆ setOption()

MediaWiki\User\UserOptionsManager::setOption	(	UserIdentity	$user,
		string	$oname,
			$val
	)

Set the given option for a user.

You need to call saveOptions() to actually write to the database.

Parameters

UserIdentity	$user
string	$oname	The option to set
mixed	$val	New value to set

Definition at line 200 of file UserOptionsManager.php.

◆ setOptionsFromDb()

MediaWiki\User\UserOptionsManager::setOptionsFromDb	(	UserIdentity	$user,
		int	$queryFlags,
		iterable	$rows
	)

private

Builds associative options array from rows fetched from DB.

Parameters

UserIdentity	$user
int	$queryFlags
	iterable<object\|array>	$rows

Returns: array

Definition at line 558 of file UserOptionsManager.php.

Member Data Documentation

◆ $defaultOptionsLookup

DefaultOptionsLookup MediaWiki\User\UserOptionsManager::$defaultOptionsLookup

private

Definition at line 58 of file UserOptionsManager.php.

Referenced by MediaWiki\User\UserOptionsManager\__construct().

◆ $hookRunner

HookRunner MediaWiki\User\UserOptionsManager::$hookRunner

private

Definition at line 89 of file UserOptionsManager.php.

◆ $languageConverterFactory

LanguageConverterFactory MediaWiki\User\UserOptionsManager::$languageConverterFactory

private

Definition at line 61 of file UserOptionsManager.php.

Referenced by MediaWiki\User\UserOptionsManager\__construct().

◆ $loadBalancer

ILoadBalancer MediaWiki\User\UserOptionsManager::$loadBalancer

private

Definition at line 64 of file UserOptionsManager.php.

Referenced by MediaWiki\User\UserOptionsManager\__construct().

◆ $logger

LoggerInterface MediaWiki\User\UserOptionsManager::$logger

private

Definition at line 70 of file UserOptionsManager.php.

Referenced by MediaWiki\User\UserOptionsManager\__construct().

◆ $modifiedOptions

array MediaWiki\User\UserOptionsManager::$modifiedOptions = []

private

options modified withing this request

Definition at line 73 of file UserOptionsManager.php.

◆ $optionsFromDb

array MediaWiki\User\UserOptionsManager::$optionsFromDb = []

private

Cached original user options as fetched from database, no adjustments applied.

Definition at line 86 of file UserOptionsManager.php.

◆ $originalOptionsCache

array MediaWiki\User\UserOptionsManager::$originalOptionsCache = []

private

Cached original user options with all the adjustments like time correction and hook changes applied.

Ready to be returned.

Definition at line 80 of file UserOptionsManager.php.

◆ $queryFlagsUsedForCaching

array MediaWiki\User\UserOptionsManager::$queryFlagsUsedForCaching = []

private

Query flags used to retrieve options from database.

Definition at line 92 of file UserOptionsManager.php.

◆ $serviceOptions

ServiceOptions MediaWiki\User\UserOptionsManager::$serviceOptions

private

Definition at line 55 of file UserOptionsManager.php.

◆ $userFactory

UserFactory MediaWiki\User\UserOptionsManager::$userFactory

private

Definition at line 67 of file UserOptionsManager.php.

Referenced by MediaWiki\User\UserOptionsManager\__construct().

◆ CONSTRUCTOR_OPTIONS

const MediaWiki\User\UserOptionsManager::CONSTRUCTOR_OPTIONS

Initial value:

= [
        MainConfigNames::HiddenPrefs,
        MainConfigNames::LocalTZoffset,
    ]

Access: internal: For use by ServiceWiring

Definition at line 49 of file UserOptionsManager.php.

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

includes/user/UserOptionsManager.php

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ canUseCachedValues()

◆ clearUserOptionsCache()

◆ getCacheKey()

◆ getDBAndOptionsForQueryFlags()

◆ getDefaultOptions()

◆ getOption()

◆ getOptionKinds()

◆ getOptions()

◆ isValueEqual()

◆ listOptionKinds()

◆ loadOptionsFromDb()

◆ loadOriginalOptions()

◆ loadUserOptions()

◆ resetOptions()

◆ saveOptions()

◆ saveOptionsInternal()

◆ setOption()

◆ setOptionsFromDb()

Member Data Documentation

◆ $defaultOptionsLookup

◆ $hookRunner

◆ $languageConverterFactory

◆ $loadBalancer

◆ $logger

◆ $modifiedOptions

◆ $optionsFromDb

◆ $originalOptionsCache

◆ $queryFlagsUsedForCaching

◆ $serviceOptions

◆ $userFactory

◆ CONSTRUCTOR_OPTIONS