We're now using the HTMLForm object with some customisation to generate the Preferences form. More...

Static Public Member Functions
static	cleanSignature ($signature, $alldata, $form)

static	datetimePreferences ($user, IContextSource $context, &$defaultPreferences)

static	editingPreferences ($user, IContextSource $context, &$defaultPreferences)

static	filesPreferences ($user, IContextSource $context, &$defaultPreferences)

static	filterIntval ($value, $alldata)

static	filterTimezoneInput ($tz, $alldata)

static	generateSkinOptions ($user, IContextSource $context)

static	getDateOptions (IContextSource $context)

static	getFormObject ($user, IContextSource $context, $formClass= 'PreferencesForm', array $remove=[])

static	getImageSizes (IContextSource $context)

static	getOptionFromUser ($name, $info, $user)
	Pull option from a user account. More...

static	getPreferences ($user, IContextSource $context)

static	getSaveBlacklist ()

static	getThumbSizes (IContextSource $context)

static	getTimeZoneList (Language $language)
	Get a list of all time zones. More...

static	getTimezoneOptions (IContextSource $context)

static	loadPreferenceValues ($user, $context, &$defaultPreferences)
	Loads existing values for a given array of preferences. More...

static	miscPreferences ($user, IContextSource $context, &$defaultPreferences)
	Dummy, kept for backwards-compatibility. More...

static	profilePreferences ($user, IContextSource $context, &$defaultPreferences)

static	rcPreferences ($user, IContextSource $context, &$defaultPreferences)

static	renderingPreferences ($user, IContextSource $context, &$defaultPreferences)

static	searchPreferences ($user, IContextSource $context, &$defaultPreferences)

static	skinPreferences ($user, IContextSource $context, &$defaultPreferences)

static	tryFormSubmit ($formData, $form)
	Handle the form submission if everything validated properly. More...

static	tryUISubmit ($formData, $form)

static	validateSignature ($signature, $alldata, $form)

static	watchlistPreferences ($user, IContextSource $context, &$defaultPreferences)

Static Protected Attributes
static array	$defaultPreferences = null

static array	$saveFilters

Static Private Attributes
static array static	$saveBlacklist

Detailed Description

We're now using the HTMLForm object with some customisation to generate the Preferences form.

This object handles generic submission, CSRF protection, layout and other logic in a reusable manner. We subclass it as a PreferencesForm to make some minor customisations.

In order to generate the form, the HTMLForm object needs an array structure detailing the form fields available, and that's what this class is for. Each element of the array is a basic property-list, including the type of field, the label it is to be given in the form, callbacks for validation and 'filtering', and other pertinent information. Note that the 'default' field is named for generic forms, and does not represent the preference's default (which is stored in $wgDefaultUserOptions), but the default for the form field, which should be whatever the user has set for that preference. There is no need to override it unless you have some special storage logic (for instance, those not presently stored as options, but which are best set from the user preferences view).

Field types are implemented as subclasses of the generic HTMLFormField object, and typically implement at least getInputHTML, which generates the HTML for the input field to be placed in the table.

Once fields have been retrieved and validated, submission logic is handed over to the tryUISubmit static method of this class.

Definition at line 50 of file Preferences.php.

Member Function Documentation

static Preferences::cleanSignature	(	$signature,
		$alldata,
		$form
	)

static

Parameters

string	$signature
array	$alldata
HTMLForm	$form

Returns: string

Definition at line 1276 of file Preferences.php.

References $wgParser, Parser\cleanSigInSig(), and global.

static Preferences::datetimePreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Returns: void

Definition at line 656 of file Preferences.php.

References $defaultPreferences, $lang, $user, Xml\element(), HTMLFormField\flattenOptions(), IContextSource\getLanguage(), Html\hidden(), and wfTimestampNow().

static Preferences::editingPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 791 of file Preferences.php.

References $defaultPreferences, $user, IContextSource\getConfig(), and IContextSource\msg().

static Preferences::filesPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 634 of file Preferences.php.

References $defaultPreferences.

static Preferences::filterIntval	(	$value,
		$alldata
	)

static

Parameters

string	$value
array	$alldata

Returns: int

Definition at line 1380 of file Preferences.php.

References $value.

static Preferences::filterTimezoneInput	(	$tz,
		$alldata
	)

static

Parameters

string	$tz
array	$alldata

Returns: string

Definition at line 1389 of file Preferences.php.

static Preferences::generateSkinOptions	(		$user,
		IContextSource	$context
	)

static

Parameters

User	$user	The User object
IContextSource	$context

Returns: array Text/links to display as key; $skinkey as value

Definition at line 1113 of file Preferences.php.

References $ret, $user, as, Skin\getAllowedSkins(), IContextSource\getConfig(), IContextSource\getLanguage(), Linker\link(), Title\makeTitleSafe(), IContextSource\msg(), Title\newMainPage(), and NS_USER.

static Preferences::getDateOptions ( IContextSource $context )

static

Parameters

IContextSource $context

Returns: array

Definition at line 1181 of file Preferences.php.

References $lang, $ret, $wgDefaultUserOptions, as, IContextSource\getLanguage(), global, IContextSource\msg(), and wfTimestampNow().

static Preferences::getFormObject	(		$user,
		IContextSource	$context,
			$formClass = `'PreferencesForm'`,
		array	$remove = `[]`
	)

static

Parameters

User	$user
IContextSource	$context
string	$formClass
array	$remove	Array of items to remove

Returns: PreferencesForm|HtmlForm

Definition at line 1295 of file Preferences.php.

References $name, $user, as, getPreferences(), and IContextSource\msg().

Referenced by SpecialPreferences\execute().

static Preferences::getImageSizes ( IContextSource $context )

static

Parameters

IContextSource $context

Returns: array

Definition at line 1216 of file Preferences.php.

References $ret, as, IContextSource\getConfig(), and IContextSource\msg().

static Preferences::getOptionFromUser	(	$name,
		$info,
		$user
	)

static

Pull option from a user account.

Handles stuff like array-type preferences.

Parameters

string	$name
array	$info
User	$user

Returns: array|string

Definition at line 166 of file Preferences.php.

References $name, $options, $user, $value, as, and HTMLFormField\flattenOptions().

static Preferences::getPreferences	(		$user,
		IContextSource	$context
	)

static

Exceptions

MWException

Parameters

User	$user
IContextSource	$context

Returns: array|null

Definition at line 83 of file Preferences.php.

References $defaultPreferences, $user, and Hooks\run().

Referenced by ApiOptions\execute(), getFormObject(), and User\getOptionKinds().

static Preferences::getSaveBlacklist ( )

static

Returns: array

Definition at line 73 of file Preferences.php.

Referenced by User\getOptionKinds().

static Preferences::getThumbSizes ( IContextSource $context )

static

Parameters

IContextSource $context

Returns: array

Definition at line 1232 of file Preferences.php.

References $ret, as, IContextSource\getConfig(), and IContextSource\msg().

static Preferences::getTimeZoneList ( Language $language )

static

Get a list of all time zones.

Parameters

Language $language Language used for the localized names

Returns: array A list of all time zones. The system name of the time zone is used as key and the value is an array which contains localized name, the timecorrection value used for preferences and the region

Since: 1.26

Definition at line 1518 of file Preferences.php.

References $value, as, and wfMessage().

static Preferences::getTimezoneOptions ( IContextSource $context )

static

Parameters

IContextSource $context

Returns: array

Definition at line 1335 of file Preferences.php.

References $timestamp, as, IContextSource\getConfig(), IContextSource\getLanguage(), MWTimestamp\getLocalInstance(), and IContextSource\msg().

static Preferences::loadPreferenceValues	(		$user,
			$context,
		&	$defaultPreferences
	)

static

Loads existing values for a given array of preferences.

Exceptions

MWException

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences	Array to load values for

Returns: array|null

Definition at line 116 of file Preferences.php.

References $context, $defaultPreferences, $name, $user, as, User\getDefaultOptions(), and HTMLForm\loadInputFromParameters().

static Preferences::miscPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Dummy, kept for backwards-compatibility.

Definition at line 1105 of file Preferences.php.

static Preferences::profilePreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Returns: void

Definition at line 209 of file Preferences.php.

References $code, $defaultPreferences, $lang, $languages, LanguageConverter\$languagesWithVariants, $link, $name, $options, $t, $time, $user, $wgAuth, $wgContLang, $wgDisableAuthManager, $wgParser, as, Language\fetchLanguageNames(), IContextSource\getConfig(), User\getGroupMember(), User\getGroupName(), IContextSource\getLanguage(), IContextSource\getOutput(), IContextSource\getRequest(), IContextSource\getTitle(), SpecialPage\getTitleFor(), IContextSource\getUser(), global, Linker\link(), Linker\linkKnown(), User\makeGroupLinkHTML(), IContextSource\msg(), ParserOptions\newFromContext(), wfBCP47(), and wfCanIPUseHTTPS().

Referenced by PreferencesTest\prefsFor().

static Preferences::rcPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 877 of file Preferences.php.

References $defaultPreferences, $user, IContextSource\getConfig(), and IContextSource\msg().

static Preferences::renderingPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 729 of file Preferences.php.

References $defaultPreferences, $value, as, IContextSource\getConfig(), and IContextSource\msg().

static Preferences::searchPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 1094 of file Preferences.php.

References $defaultPreferences, as, and MWNamespace\getValidNamespaces().

static Preferences::skinPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Returns: void

Definition at line 585 of file Preferences.php.

References $defaultPreferences, $user, IContextSource\getConfig(), IContextSource\getLanguage(), Linker\link(), Title\makeTitleSafe(), IContextSource\msg(), and NS_USER.

static Preferences::tryFormSubmit	(	$formData,
		$form
	)

static

Handle the form submission if everything validated properly.

Parameters

array	$formData
PreferencesForm	$form

Returns: bool|Status|string

Definition at line 1423 of file Preferences.php.

References $name, $user, $value, as, MediaWiki\Auth\AuthManager\callLegacyAuthPlugin(), Status\newFatal(), and Hooks\run().

static Preferences::tryUISubmit	(	$formData,
		$form
	)

static

Parameters

array	$formData
PreferencesForm	$form

Returns: Status

Definition at line 1486 of file Preferences.php.

References $context, $res, and Status\newGood().

static Preferences::validateSignature	(	$signature,
		$alldata,
		$form
	)

static

Parameters

string	$signature
array	$alldata
HTMLForm	$form

Returns: bool|string

Definition at line 1250 of file Preferences.php.

References $wgParser, Xml\element(), false, and global.

static Preferences::watchlistPreferences	(		$user,
		IContextSource	$context,
		&	$defaultPreferences
	)

static

Parameters

User	$user
IContextSource	$context
array	$defaultPreferences

Definition at line 945 of file Preferences.php.

References $defaultPreferences, $user, as, false, IContextSource\getConfig(), IContextSource\getLanguage(), SpecialPage\getTitleFor(), Linker\linkKnown(), and IContextSource\msg().

Member Data Documentation

array Preferences::$defaultPreferences = null

staticprotected

Definition at line 52 of file Preferences.php.

Referenced by datetimePreferences(), editingPreferences(), filesPreferences(), getPreferences(), loadPreferenceValues(), profilePreferences(), rcPreferences(), renderingPreferences(), searchPreferences(), skinPreferences(), and watchlistPreferences().

array static Preferences::$saveBlacklist

staticprivate

Initial value:

= [
        'realname',
        'emailaddress',
    ]

Definition at line 65 of file Preferences.php.

array Preferences::$saveFilters

staticprotected

Initial value:

= [

'timecorrection' => [ 'Preferences', 'filterTimezoneInput' ]

Definition at line 55 of file Preferences.php.

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

includes/Preferences.php

Static Public Member Functions

Static Protected Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

Member Data Documentation