This is the default implementation of PreferencesFactory. More...

Inheritance diagram for MediaWiki\Preferences\DefaultPreferencesFactory:

Collaboration diagram for MediaWiki\Preferences\DefaultPreferencesFactory:

[legend]

Public Member Functions
	__construct (ServiceOptions $options, Language $contLang, AuthManager $authManager, LinkRenderer $linkRenderer, NamespaceInfo $nsInfo, PermissionManager $permissionManager, ILanguageConverter $languageConverter=null, LanguageNameUtils $languageNameUtils=null)

	getForm (User $user, IContextSource $context, $formClass=PreferencesFormOOUI::class, array $remove=[])

	getFormDescriptor (User $user, IContextSource $context)

	getSaveBlacklist ()
	Get the names of preferences that should never be saved (such as 'realname' and 'emailaddress'). Returns string[] More...

	setUser (User $user)
	Set the preferences user. More...

Protected Member Functions
	applyFilters (array &$preferences, array $formDescriptor, $verb)
	Applies filters to preferences either before or after form usage. More...

	cleanSignature ( $signature, $alldata, HTMLForm $form)

	datetimePreferences (IContextSource $context, &$defaultPreferences)

	editingPreferences (MessageLocalizer $l10n, &$defaultPreferences)

	filesPreferences (IContextSource $context, &$defaultPreferences)

	generateSkinOptions (IContextSource $context)

	getDateOptions (IContextSource $context)

	getImageSizes (MessageLocalizer $l10n)

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

	getThumbSizes (MessageLocalizer $l10n)

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

	getTimezoneOptions (IContextSource $context)

	profilePreferences (IContextSource $context, &$defaultPreferences, $canIPUseHTTPS)

	rcPreferences (MessageLocalizer $l10n, &$defaultPreferences)

	renderingPreferences (MessageLocalizer $l10n, &$defaultPreferences)

	saveFormData ( $formData, PreferencesFormOOUI $form, array $formDescriptor)
	Handle the form submission if everything validated properly. More...

	searchPreferences (&$defaultPreferences)

	skinPreferences (IContextSource $context, &$defaultPreferences)

	submitForm (array $formData, PreferencesFormOOUI $form, array $formDescriptor)
	Save the form data and reload the page. More...

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

	watchlistPreferences (IContextSource $context, &$defaultPreferences)

Protected Attributes
AuthManager	$authManager

Language	$contLang
	The wiki's content language. More...

LanguageNameUtils	$languageNameUtils

LinkRenderer	$linkRenderer

NamespaceInfo	$nsInfo

ServiceOptions	$options

PermissionManager	$permissionManager

User	$user
	The user to whom these preferences belong. More...

Private Member Functions
	loadPreferenceValues (IContextSource $context, &$defaultPreferences)
	Loads existing values for a given array of preferences. More...

Private Attributes
ILanguageConverter	$languageConverter

Detailed Description

This is the default implementation of PreferencesFactory.

Definition at line 64 of file DefaultPreferencesFactory.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Preferences\DefaultPreferencesFactory::__construct	(	ServiceOptions	$options,
		Language	$contLang,
		AuthManager	$authManager,
		LinkRenderer	$linkRenderer,
		NamespaceInfo	$nsInfo,
		PermissionManager	$permissionManager,
		ILanguageConverter	$languageConverter = `null`,
		LanguageNameUtils	$languageNameUtils = `null`
	)

Parameters

ServiceOptions	$options
Language	$contLang
AuthManager	$authManager
LinkRenderer	$linkRenderer
NamespaceInfo	$nsInfo
PermissionManager	$permissionManager
ILanguageConverter \| null	$languageConverter
LanguageNameUtils \| null	$languageNameUtils

Definition at line 137 of file DefaultPreferencesFactory.php.

Member Function Documentation

◆ applyFilters()

MediaWiki\Preferences\DefaultPreferencesFactory::applyFilters	(	array &	$preferences,
		array	$formDescriptor,
			$verb
	)

protected

Applies filters to preferences either before or after form usage.

Parameters

array	&$preferences
array	$formDescriptor
string	$verb	Name of the filter method to call, either 'filterFromForm' or 'filterForForm'

Definition at line 1732 of file DefaultPreferencesFactory.php.

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\loadPreferenceValues(), and MediaWiki\Preferences\DefaultPreferencesFactory\saveFormData().

◆ cleanSignature()

MediaWiki\Preferences\DefaultPreferencesFactory::cleanSignature	(		$signature,
			$alldata,
		HTMLForm	$form
	)

protected

Parameters

string	$signature
array	$alldata
HTMLForm	$form

Returns: string

Definition at line 1527 of file DefaultPreferencesFactory.php.

References Parser\cleanSigInSig(), and MediaWiki\MediaWikiServices\getInstance().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\profilePreferences().

◆ datetimePreferences()

MediaWiki\Preferences\DefaultPreferencesFactory::datetimePreferences	(	IContextSource	$context,
		&	$defaultPreferences
	)

protected

Parameters

IContextSource	$context
array	&$defaultPreferences

Returns: void

Definition at line 826 of file DefaultPreferencesFactory.php.

References MediaWiki\$context, $lang, Xml\element(), HTMLFormField\flattenOptions(), MediaWiki\Preferences\DefaultPreferencesFactory\getDateOptions(), IContextSource\getLanguage(), MediaWiki\Preferences\DefaultPreferencesFactory\getTimezoneOptions(), Html\hidden(), and wfTimestampNow().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\getFormDescriptor().

◆ editingPreferences()

MediaWiki\Preferences\DefaultPreferencesFactory::editingPreferences	(	MessageLocalizer	$l10n,
		&	$defaultPreferences
	)

protected

Parameters

MessageLocalizer	$l10n
array	&$defaultPreferences

Definition at line 975 of file DefaultPreferencesFactory.php.

References MessageLocalizer\msg().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\getFormDescriptor().

◆ filesPreferences()

MediaWiki\Preferences\DefaultPreferencesFactory::filesPreferences	(	IContextSource	$context,
		&	$defaultPreferences
	)

protected

Parameters

IContextSource	$context
array	&$defaultPreferences

Definition at line 806 of file DefaultPreferencesFactory.php.

References MediaWiki\Preferences\DefaultPreferencesFactory\getImageSizes(), and MediaWiki\Preferences\DefaultPreferencesFactory\getThumbSizes().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\getFormDescriptor().

◆ generateSkinOptions()

MediaWiki\Preferences\DefaultPreferencesFactory::generateSkinOptions ( IContextSource $context )

protected

Parameters

IContextSource $context

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

Definition at line 1334 of file DefaultPreferencesFactory.php.

References MediaWiki\$context, Skin\getAllowedSkins(), IContextSource\getLanguage(), IContextSource\getRequest(), Skin\getSkinNames(), Title\makeTitleSafe(), MessageLocalizer\msg(), Title\newMainPage(), and NS_USER.

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\skinPreferences().

◆ getDateOptions()

MediaWiki\Preferences\DefaultPreferencesFactory::getDateOptions ( IContextSource $context )

protected

Parameters

IContextSource $context

Returns: array

Definition at line 1431 of file DefaultPreferencesFactory.php.

References MediaWiki\$context, $lang, $wgDefaultUserOptions, IContextSource\getLanguage(), MessageLocalizer\msg(), and wfTimestampNow().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\datetimePreferences().

◆ getForm()

MediaWiki\Preferences\DefaultPreferencesFactory::getForm	(	User	$user,
		IContextSource	$context,
			$formClass = `PreferencesFormOOUI::class`,
		array	$remove = `[]`
	)

Parameters

User	$user	Deprecated since 1.35, and will be ignored if $this->setUser() has been used.
IContextSource	$context
string	$formClass
array	$remove	Array of items to remove

Returns: HTMLForm

Implements MediaWiki\Preferences\PreferencesFactory.

Definition at line 1546 of file DefaultPreferencesFactory.php.

References MediaWiki\$context, MediaWiki\Preferences\DefaultPreferencesFactory\$user, MediaWiki\Preferences\DefaultPreferencesFactory\getFormDescriptor(), IContextSource\getOutput(), IContextSource\getRequest(), IContextSource\getTitle(), MessageLocalizer\msg(), MediaWiki\Preferences\DefaultPreferencesFactory\setUser(), and MediaWiki\Preferences\DefaultPreferencesFactory\submitForm().

◆ getFormDescriptor()

MediaWiki\Preferences\DefaultPreferencesFactory::getFormDescriptor	(	User	$user,
		IContextSource	$context
	)

Exceptions

MWException

Parameters

User	$user	Deprecated since 1.35, and will be ignored if $this->setUser() has been used.
IContextSource	$context

Returns: array|null

Implements MediaWiki\Preferences\PreferencesFactory.

Definition at line 197 of file DefaultPreferencesFactory.php.

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\getForm().

◆ getImageSizes()

MediaWiki\Preferences\DefaultPreferencesFactory::getImageSizes ( MessageLocalizer $l10n )

protected

Parameters

MessageLocalizer $l10n

Returns: array

Definition at line 1465 of file DefaultPreferencesFactory.php.

References MessageLocalizer\msg().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\filesPreferences().

◆ getOptionFromUser()

MediaWiki\Preferences\DefaultPreferencesFactory::getOptionFromUser	(		$name,
			$info,
		array	$userOptions
	)

protected

Pull option from a user account.

Handles stuff like array-type preferences.

Parameters

string	$name
array	$info
array	$userOptions

Returns: array|string

Definition at line 286 of file DefaultPreferencesFactory.php.

References MediaWiki\Preferences\DefaultPreferencesFactory\$options, and HTMLFormField\flattenOptions().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\loadPreferenceValues().

◆ getSaveBlacklist()

MediaWiki\Preferences\DefaultPreferencesFactory::getSaveBlacklist ( )

Get the names of preferences that should never be saved (such as 'realname' and 'emailaddress').

Returns: string[]

Implements MediaWiki\Preferences\PreferencesFactory.

Definition at line 184 of file DefaultPreferencesFactory.php.

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\loadPreferenceValues(), and MediaWiki\Preferences\DefaultPreferencesFactory\saveFormData().

◆ getThumbSizes()

MediaWiki\Preferences\DefaultPreferencesFactory::getThumbSizes ( MessageLocalizer $l10n )

protected

Parameters

MessageLocalizer $l10n

Returns: array

Definition at line 1482 of file DefaultPreferencesFactory.php.

References MessageLocalizer\msg().

Referenced by MediaWiki\Preferences\DefaultPreferencesFactory\filesPreferences().

◆ getTimeZoneList()

MediaWiki\Preferences\DefaultPreferencesFactory::getTimeZoneList ( Language $language )

protected

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