MediaWiki  1.28.0
Preferences Class Reference

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 1271 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 651 of file Preferences.php.

References $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 786 of file Preferences.php.

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

static Preferences::filesPreferences (   $user,
IContextSource  $context,
$defaultPreferences 
)
static
Parameters
User$user
IContextSource$context
array$defaultPreferences

Definition at line 629 of file Preferences.php.

static Preferences::filterIntval (   $value,
  $alldata 
)
static
Parameters
string$value
array$alldata
Returns
int

Definition at line 1375 of file Preferences.php.

References $value.

static Preferences::filterTimezoneInput (   $tz,
  $alldata 
)
static
Parameters
string$tz
array$alldata
Returns
string

Definition at line 1384 of file Preferences.php.

static Preferences::generateSkinOptions (   $user,
IContextSource  $context 
)
static
Parameters
User$userThe User object
IContextSource$context
Returns
array Text/links to display as key; $skinkey as value

Definition at line 1108 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 1176 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$removeArray of items to remove
Returns
PreferencesForm|HtmlForm

Definition at line 1290 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 1211 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 1227 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$languageLanguage 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 1513 of file Preferences.php.

References $value, as, and wfMessage().

static Preferences::getTimezoneOptions ( IContextSource  $context)
static
static Preferences::loadPreferenceValues (   $user,
  $context,
$defaultPreferences 
)
static

Loads existing values for a given array of preferences.

Exceptions
MWException
Parameters
User$user
IContextSource$context
array$defaultPreferencesArray 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 1100 of file Preferences.php.

static Preferences::rcPreferences (   $user,
IContextSource  $context,
$defaultPreferences 
)
static
Parameters
User$user
IContextSource$context
array$defaultPreferences

Definition at line 872 of file Preferences.php.

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

static Preferences::renderingPreferences (   $user,
IContextSource  $context,
$defaultPreferences 
)
static
Parameters
User$user
IContextSource$context
array$defaultPreferences

Definition at line 724 of file Preferences.php.

References $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 1089 of file Preferences.php.

References as, and MWNamespace\getValidNamespaces().

static Preferences::skinPreferences (   $user,
IContextSource  $context,
$defaultPreferences 
)
static
Parameters
User$user
IContextSource$context
array$defaultPreferences
Returns
void

Definition at line 580 of file Preferences.php.

References $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 1418 of file Preferences.php.

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

static Preferences::tryUISubmit (   $formData,
  $form 
)
static
Parameters
array$formData
PreferencesForm$form
Returns
Status

Definition at line 1481 of file Preferences.php.

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

static Preferences::validateSignature (   $signature,
  $alldata,
  $form 
)
static
Parameters
string$signature
array$alldata
HTMLForm$form
Returns
bool|string

Definition at line 1245 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 940 of file Preferences.php.

References $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 getPreferences(), and loadPreferenceValues().

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: