Page MenuHomeWickedGov Phorge
Files F5961871

UserOptionsLookup.php
No OneTemporary
Actions

Size
5 KB
Referenced Files
None
Subscribers
None

UserOptionsLookup.php
View Options

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\User\Options;
use MediaWiki\User\UserIdentity;
use Wikimedia\Rdbms\IDBAccessObject;
/**
* Provides access to user options
* @since 1.35
*/
abstract class UserOptionsLookup {
/**
* Exclude user options that are set to their default value.
*/
public const EXCLUDE_DEFAULTS = 1;
/**
* The suffix appended to preference names for the associated preference
* that tracks whether they have a local override.
* @since 1.43
*/
public const LOCAL_EXCEPTION_SUFFIX = '-local-exception';
/**
* Combine the language default options with any site-specific and user-specific defaults
* and add the default language variants.
*
* @param UserIdentity|null $userIdentity User to look the default up for; set to null to
* ignore any user-specific defaults (since 1.42)
* @return array
*/
abstract public function getDefaultOptions( ?UserIdentity $userIdentity = null ): array;
/**
* Get a given default option value.
*
* @param string $opt Name of option to retrieve
* @param UserIdentity|null $userIdentity User to look the defaults up for; set to null to
* ignore any user-specific defaults (since 1.42)
* @return mixed|null Default option value
*/
public function getDefaultOption(
string $opt,
?UserIdentity $userIdentity = null
) {
$defaultOptions = $this->getDefaultOptions( $userIdentity );
return $defaultOptions[$opt] ?? null;
}
/**
* Get the user's current setting for a given option.
*
* @param UserIdentity $user The user to get the option for
* @param string $oname The option to check
* @param mixed|null $defaultOverride A default value returned if the option does not exist
* @param bool $ignoreHidden Whether to ignore the effects of $wgHiddenPrefs
* @param int $queryFlags A bit field composed of READ_XXX flags
* @return mixed|null User's current value for the option,
* Note that while option values retrieved from the database are always strings, default
* values and values set within the current request and not yet saved may be of another type.
* @see getBoolOption()
* @see getIntOption()
*/
abstract public function getOption(
UserIdentity $user,
string $oname,
$defaultOverride = null,
bool $ignoreHidden = false,
int $queryFlags = IDBAccessObject::READ_NORMAL
);
/**
* Get all user's options
*
* @param UserIdentity $user The user to get the option for
* @param int $flags Bitwise combination of:
* UserOptionsManager::EXCLUDE_DEFAULTS Exclude user options that are set
* to the default value. Options
* that are set to their conditionally
* default value are not excluded.
* @param int $queryFlags A bit field composed of READ_XXX flags
* @return array
*/
abstract public function getOptions(
UserIdentity $user,
int $flags = 0,
int $queryFlags = IDBAccessObject::READ_NORMAL
): array;
/**
* Get the user's current setting for a given option, as a boolean value.
*
* @param UserIdentity $user The user to get the option for
* @param string $oname The option to check
* @param int $queryFlags A bit field composed of READ_XXX flags
* @return bool User's current value for the option
* @see getOption()
*/
public function getBoolOption(
UserIdentity $user,
string $oname,
int $queryFlags = IDBAccessObject::READ_NORMAL
): bool {
return (bool)$this->getOption(
$user, $oname, null, false, $queryFlags );
}
/**
* Get the user's current setting for a given option, as an integer value.
*
* @param UserIdentity $user The user to get the option for
* @param string $oname The option to check
* @param int $defaultOverride A default value returned if the option does not exist
* @param int $queryFlags A bit field composed of READ_XXX flags
* @return int User's current value for the option
* @see getOption()
*/
public function getIntOption(
UserIdentity $user,
string $oname,
int $defaultOverride = 0,
int $queryFlags = IDBAccessObject::READ_NORMAL
): int {
$val = $this->getOption(
$user, $oname, $defaultOverride, false, $queryFlags );
if ( $val == '' ) {
$val = $defaultOverride;
}
return intval( $val );
}
/**
* Determine if a user option came from a source other than the local store
* or the defaults. If this is true, setting the option will be ignored
* unless GLOBAL_OVERRIDE or GLOBAL_UPDATE is passed to setOption().
*
* @param UserIdentity $user
* @param string $key
* @return bool
*/
public function isOptionGlobal( UserIdentity $user, string $key ) {
return false;
}
}
/** @deprecated class alias since 1.42 */
class_alias( UserOptionsLookup::class, 'MediaWiki\\User\\UserOptionsLookup' );

File Metadata

Mime Type
text/x-php
Expires
Sat, Oct 3, 08:28 (1 w, 5 d ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
09/c8/29bbc788455748088675b3bea8c1
Default Alt Text
UserOptionsLookup.php (5 KB)

Event Timeline