View source for Manual:User preferences/ar

<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
== Retrieving user preferences ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To retrieve all of a user's preferences, use UserOptionsLookup::getOptions() with a user identity object as a parameter.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To retrieve a specific preference of a user, use UserOptionsLookup::getOption() with a user identity and the name of the preference as a parameter, for example:
</div>

<syntaxhighlight lang="php">
$emailFrequency = MediaWikiServices::getInstance()->getUserOptionsLookup()->getOption( $this->getUser(), 'echo-email-frequency' );
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">If the preference is of the multiselect or checkmatrix type, the parameter will be &lt;preference-name>&lt;option-value>.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">For example, if the preference name is 'searchNs' and the option value is '2', the parameter for getOption will be 'searchNs2'.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">There is an exception to this, however: If the preference specifies an explicit option prefix, that prefix will be used instead of the preference name (&lt;prefix-name>&lt;option-name>). See the Gadgets extension for an example.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
To retrieve it in JavaScript, use the {{ll|ResourceLoader/Core modules#user.options|user.options}} module.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Setting default preferences ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For information about how to set default preferences for all users, see {{ll|Manual:$wgDefaultUserOptions}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Changing a preference ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Preferences can be changed through the {{ll|API:Options|nsp=0}} API action.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Creating a preferences interface ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For information about creating a preferences interface for your features, see {{ll|Manual:Hooks/GetPreferences}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Gadget and user script preferences ==
</div>
Any gadget or user script can define a preference, the name of which must start with "<code>userjs-</code>". Such a preference will not appear in [[Special:Preferences]] or in {{ll|API:Userinfo}} responses, and it will not be validated. It can be read from {{ll|ResourceLoader/Core modules#user.options|user.options}}, and set through {{ll|API:Options}}.

<div lang="en" dir="ltr" class="mw-content-ltr">
== Hidden API preferences ==
</div>
API preferences are also defined through the [[Manual:Hooks/GetPreferences|GetPreferences]] hook, with the type set to <code>'api'</code>.  They are validated and readable the normal ways, but are not part of the Special:Preferences form.

<div lang="en" dir="ltr" class="mw-content-ltr">
== Disabling user preferences ==
</div>

<span id="By_preference"></span>
=== التفضيلات ===
{{MW 1.16|and after}}
To disable individual preferences ''for all users'', add preference names to the {{manual|$wgHiddenPrefs}} configuration variable. For example, to prevent everyone from being able to mark their edits minor by default, set the following in your {{manual|LocalSettings.php}}:

<syntaxhighlight lang="php">
$wgHiddenPrefs[] = 'minordefault';
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== By user group ===
</div>
{{MW 1.22|and after}}
To prevent individual user groups from editing their preferences, you can use the 'editmyoptions' {{manual|User rights|user right}}. With this line in your {{manual|LocalSettings.php}}, users in the group 'user' (which contains all logged in users) can't edit their user preferences:

<syntaxhighlight lang="php">
$wgGroupPermissions['user']['editmyoptions'] = false;
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== By user ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
It is not possible to disable only certain individual users' preferences.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== See also ==
</div>
* {{ll|Help:Preferences}} – <span lang="en" dir="ltr" class="mw-content-ltr">user documentation for preferences</span>
* {{ll|Extension:GlobalPreferences}} – <span lang="en" dir="ltr" class="mw-content-ltr">an extension for managing preferences across multiple wikis</span>
* {{ll|Manual:user_properties table}} - <span lang="en" dir="ltr" class="mw-content-ltr">stores user preferences</span>

[[Category:Preferences{{#translation:}}]]