Manual:User preferences/ar

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Retrieving user preferences

To retrieve all of a user's preferences, use UserOptionsLookup::getOptions() with a user identity object as a parameter.

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:

$emailFrequency = MediaWikiServices::getInstance()->getUserOptionsLookup()->getOption( $this->getUser(), 'echo-email-frequency' );

If the preference is of the multiselect or checkmatrix type, the parameter will be <preference-name><option-value>. For example, if the preference name is 'searchNs' and the option value is '2', the parameter for getOption will be 'searchNs2'. 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 (<prefix-name><option-name>). See the Gadgets extension for an example.

To retrieve it in JavaScript, use the user.options module.

Setting default preferences

For information about how to set default preferences for all users, see Manual:$wgDefaultUserOptions .

Changing a preference

Preferences can be changed through the واجهة برمجة التطبيقات:خيارات API action.

Creating a preferences interface

For information about creating a preferences interface for your features, see Manual:Hooks/GetPreferences .

Gadget and user script preferences

Any gadget or user script can define a preference, the name of which must start with "userjs-". Such a preference will not appear in Special:Preferences or in واجهة برمجة التطبيقات:معلومات_مستخدم responses, and it will not be validated. It can be read from user.options , and set through واجهة برمجة التطبيقات:خيارات .

Hidden API preferences

API preferences are also defined through the GetPreferences hook, with the type set to 'api'. They are validated and readable the normal ways, but are not part of the Special:Preferences form.

Disabling user preferences

التفضيلات

إصدار ميدياويكي:

<translate> ≥</translate> 1.16

To disable individual preferences for all users, add preference names to the $wgHiddenPrefs configuration variable. For example, to prevent everyone from being able to mark their edits minor by default, set the following in your LocalSettings.php:

$wgHiddenPrefs[] = 'minordefault';

By user group

إصدار ميدياويكي:

<translate> ≥</translate> 1.22

To prevent individual user groups from editing their preferences, you can use the 'editmyoptions' user right. With this line in your LocalSettings.php, users in the group 'user' (which contains all logged in users) can't edit their user preferences:

$wgGroupPermissions['user']['editmyoptions'] = false;

By user

It is not possible to disable only certain individual users' preferences.