Manual:$wgDefaultUserOptions/it
From Linux Web Expert
| <translate> User accounts, authentication</translate>: $wgDefaultUserOptions | |
|---|---|
| Default user preferences. |
|
| <translate> Introduced in version:</translate> | 1.4.0 |
| <translate> Removed in version:</translate> | <translate> still in use</translate> |
| <translate> Allowed values:</translate> | Vedi sotto |
| <translate> Default value:</translate> | Vedi sotto |
| <translate> Other settings:</translate> <translate> Alphabetical</translate> | <translate> By function</translate> | |
To add a new user preference, see:
The below changes to LocalSettings.php will override the default user preferences for anonymous visitors and users who have not customized their preferences. Existing user accounts who had the (previous) default option and didn't set it explicitly (which means that it's not stored in the database) will then use the new default.
In the old preferences system, the change affects only anonymous visitors (if relevant) and new accounts.
Available preferences
The following user preferences are available for customization:
| Name | Default | Description | Versions | |
|---|---|---|---|---|
| User Profile | ||||
| fancysig | 0 | If User uses a custom (raw) signature (0 or 1). If user has not set a custom signature, their signature is controlled by the contents of the wiki page mediawiki:Signature or mediawiki:Signature-anon. If user has specified a custom sig, the actual text of the signature is in the nickname option. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| nickname | ''
|
Actual text of the custom signature |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.23 | |
| enotifwatchlistpages | 1 | Email notification to editor if there are changes to a page the editor has on their watchlist. Only used if $wgEnotifWatchlist is set. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| enotifusertalkpages | 1 | Email notification to editor if there are changes to the editor's talk page. Only used if $wgEnotifUserTalk is set. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| enotifminoredits | 0 | Email notification to editor if there is a minor change to a watched page or user talk page, and the relevant option for sending emails on changes to watched page or user talk page is on. Only used if $wgEnotifWatchlist or $wgEnotifUserTalk are set. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| enotifrevealaddr | 0 | Only used if $wgEnotifRevealEditorAddress and either $wgEnotifWatchlist or $wgEnotifUserTalk are set. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.5 | |
| gender | 'unknown'
|
Used for gender-correct addressing by the software. This information will be public. Options are: male, female, or unknown. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.15 | |
| realname | Default “real name”. Real name is optional. If you choose to provide it, this will be used for giving you attribution for your work. Use $wgHiddenPrefs to disable the real name field. | |||
| language | User specific interface language, especially useful in conjunction with $wgHiddenPrefs. This is not to set the wiki's default language. Use $wgLanguageCode instead.
| |||
| Quickbar | ||||
| disablemail | 0 | Whether other users can send eMail to this user, if $wgEnableUserEmail is enabled. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.16 | |
| quickbar | Quickbar location (only applies if using Cologne Blue or Classic skins). Options are: 0 - None, 1 - Fixed left, 2 - Fixed right, 3 - Floating left, 4 - Floating right, 5 (since 1.19) - Left/right depending on your language. |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.21</tvar> is unsupported version</translate>"> 1.8 – 1.21 | ||
| Skin | ||||
| skin | false
|
Which skin to use. May be false to indicate that the site default (as defined in $wgDefaultSkin) should be used. Previously, numbers were used to designate skins. The only numerical values that are currently operative (as of MediaWiki 1.29) are 0, which means the default skin, and 2, which means Cologne Blue. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| skin-responsive | 1 | Enable responsive mode. Adapt skin to available viewport area. (May have no effect on some skins). |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.37 | |
| Math | ||||
| math | 1 | How to render in-line maths (contents of <math></math> tags). Only applies if $wgUseTeX is set. Options are: 0 - Always render PNG, 1 - Leave it as TeX (for text browsers)
|
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.30</tvar> is unsupported version</translate>"> 1.8 – 1.30 | |
| Files | ||||
| imagesize | 2 | Size to limit images on description pages to. Values correspond to the entries in $wgImageLimits. By default, 2 is 800*600. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| thumbsize | 5 | Thumbnail size - Values correspond to the entries in $wgThumbLimits. By default, 5 is 300px. |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| Date and Time | ||||
| date | 'default'
|
Date format. Options:
|
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| timecorrection | A fixed timezone offset or ZoneInfo zone, e.g.:
| |||
| Editing | ||||
| rows | 25 | Edit box size (rows) <translate> (deprecated in <tvar name=2>1.29</tvar>)</translate> |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.34</tvar> is unsupported version</translate>"> 1.8 – 1.34 | |
| cols | 80 | Edit box size (columns) <translate> (deprecated in <tvar name=2>1.29</tvar>)</translate> |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.34</tvar> is unsupported version</translate>"> 1.8 – 1.34 | |
| editsection | Enable section editing via [edit] links. Behaviour changed in 1.23: add .mw-editsection { display:none!important; } to site-wide or user CSS, see phab:T54811.
|
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.22</tvar> is unsupported version</translate>"> 1.8 – 1.22 | ||
| editsectiononrightclick | 0 | Enable section editing by right clicking on section titles (JavaScript) |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| editondblclick | 0 | Edit pages on double click (JavaScript) |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.13 | |
| showtoolbar | 1 | Show edit toolbar (requires javascript) |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.31</tvar> is unsupported version</translate>"> 1.8 – 1.31 | |
| previewonfirst | 0 | Show preview when starting to edit |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.13 | |
| previewontop | 1 | Show preview before edit box |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.8 | |
| minordefault | 0 | Mark all edits minor by default |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.13 | |
| externaleditor | Use external editor by default |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.21</tvar> is unsupported version</translate>"> 1.8 – 1.21 | ||
| externaldiff | Use external diff by default |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.21</tvar> is unsupported version</translate>"> 1.8 – 1.21 | ||
| uselivepreview | 0 | |||
| forceeditsummary | 0 | Prompt user when entering a blank edit summary | ||
| editfont | 'monospace'
|
Edit area font style. Options are: default (browser default), monospace, sans-serif, serif. | ||
| useeditwarning | 1 | Warn me when I leave an edit page with unsaved changes | ||
| Recent changes | ||||
| rcenhancedfilters-disable | 0 | Opts-out from New Filters for edit review. | ||
| rcdays | 7 | Days to show in recent changes (cannot exceed $wgRCMaxAge) | ||
| rclimit | 50 | Maximum number of entries to display in recent changes (truncates rcdays)
| ||
| hideminor | 0 | Hide minor edits from recent changes | ||
| shownumberswatching | 1 | Show the number of users, who are watching this page (on recent changes, watch list and article pages). Only used if $wgRCShowWatchingUsers is set. | ||
| usenewrc | 1 | Enhanced recent changes - javascript collapsible tree | ||
| hidepatrolled | 0 | Hide patrolled edits from recent changes | ||
| newpageshidepatrolled | 0 | Hide patrolled pages from new page list | ||
| hidecategorization | 1 | Hide categorization of pages | ||
| Watchlist | ||||
| wlenhancedfilters-disable | 0 | Disable enhanced watchlist with JavaScript. | ||
| watchlistdays | 7.0 | Number of days to show in watchlist (cannot exceed $wgRCMaxAge) | ||
| extendwatchlist | 1 | Expand watchlist to show all applicable changes | ||
| wllimit | 250 | Number of edits to show in expanded watchlist (if 'extendwatchlist' == 1) | ||
| watchlisthideown | 0 | Hide my edits from the watchlist | ||
| watchlisthidebots | 0 | Hide bot edits from the watchlist | ||
| watchlisthideminor | 0 | Hide minor edits from the watchlist | ||
| watchcreations | 1 | Add pages the user creates and files they upload to their watchlist | ||
| watchrollback | 0 | Add pages where the user has performed a rollback to their watchlist | ||
| watchlisthideanons | 0 | Hide anonymous users' changes from the watchlist | ||
| watchlisthideliu | 0 | Hide logged-in users' changes from the watchlist | ||
| watchlisttoken | Token of watchlist | |||
| watchlisthidepatrolled | 0 | Hide patrolled edits from the watchlist | ||
| watchlistreloadautomatically | 0 | Reload the watchlist automatically whenever a filter is changed (JavaScript required) | ||
| watchlistunwatchlinks | 0 | Add direct unwatch/watch markers (×/+) to watched pages with changes (JavaScript required for toggle functionality) | ||
| watchlisthidecategorization | 1 | Hides changes to category membership | ||
| watchdefault | 1 |
Add pages the user edits to their watchlist, checking the "Watch this page" by default on all edited pages. This option can be disabled by editors in Preferences → Watchlist tab → Watched pages section and unchecking "Add pages and files I edit to my watchlist" | ||
| watchmoves | 0 | Add pages the user moves to their watchlist | ||
| watchdeletion | 0 | Add pages the user deletes to their watchlist | ||
| watchuploads | 1 | Add new files the user uploads to their watchlist | ||
| Search | ||||
| searchlimit | 20 | Hits per page | ||
| vector-simplesearch | Whether or not the Vector skin should use the simple search box (Options are 1 for true and 0 for false). <translate> (removed in <tvar name=2>1.23</tvar>)</translate> | |||
| ajaxsearch | Enables AJAX Search (Options are 1 for true and 0 for false) | |||
| searcheverything | Search in all namespaces. <translate> (removed in <tvar name=2>1.24</tvar>)</translate> [1] | |||
| searchnamespaces | Add 'searchnamespaces' to $wgHiddenPrefs to prevent users from customizing “namespaces to be searched by default” in their preferences (they will still be able to set which namespaces should be searched on Special:Search). Use $wgNamespacesToBeSearchedDefault to set which namespaces are enabled for searching by default. | |||
| Misc | ||||
| stubthreshold | 0 | Threshold for stub display |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.36</tvar> is unsupported version</translate>"> 1.8 – 1.36 | |
| underline | 2 | Whether to underline links. Options are: 0 - never, 1 - always, 2 - browser default | ||
| justify | Justify paragraphs | |||
| numberheadings | 0 | Option "Auto-numbering Headings", 1 turns on the numbering of all headings within articles |
<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.37</tvar> is unsupported version</translate>"> 1.8 – 1.37 | |
| showtoc | Boolean. 1 is show the TOC, 0 is hide it. | |||
| nocache | Disable page caching | |||
| showhiddencats | 0 | Show hidden categories | ||
| showjumplinks | Enable "jump to" accessibility links | |||
| diffonly | 0 | Don't show page content below diffs | ||
| norollbackdiff | 0 | No diff after rollback | ||
| ccmeonemails | 0 | Send me copies of emails I send to other users | ||
| prefershttps | 1 | Always use a secure connection while logged in | ||
| email-allow-new-users | 1 | Allow emails from brand-new users | ||
| pst-cssjs | 1 | ? |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.36 | |
| search-match-redirect | true
|
Redirect to exact matches when searching |
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.35 | |
| search-special-page | 'Search'
|
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>"> <translate> ≥</translate> 1.38 | ||
| showrollbackconfirmation | 0 | Show a confirmation prompt when clicking on a rollback link | ||
| requireemail | 0 | Send password reset emails only when both email address and username are provided. | ||
| Estensione:WikiEditor (packaged with MediaWiki 1.18+) | ||||
| usenavigabletoc | Enable navigable table of contents | |||
| wikieditor-publish | Enable step-by-step publishing | |||
| wikieditor-preview | Enable side-by-side preview | |||
| usebetatoolbar | Enable enhanced editing toolbar | |||
| usebetatoolbar-cgd | Enable dialogs for inserting links, tables and more | |||
| Extension:LiquidThreads | ||||
| lqt-watch-threads | ⧼lqt-preference-watch-threads⧽ (true by default) | |||
| lqtnotifytalk | ⧼lqt-preference-notify-talk⧽ (false by default) | |||
| Extension:Flow | ||||
| echo-subscriptions-web-flow-discussion | ⧼echo-subscriptions-web-flow-discussion⧽ (true by default) | |||
| echo-subscriptions-email-flow-discussion | ⧼echo-subscriptions-email-flow-discussion⧽ (false by default) | |||
| Extension:VisualEditor | ||||
| visualeditor-betatempdisable | 0 | Temporarily disable the visual editor while it is in beta | ||
Notes:
- New settings are added to MediaWiki periodically. Some of these settings have been added since $wgDefaultUserOptions was introduced in v1.4.0. Currently there is no documentation about when settings were added.
- It is possible for extensions and language files to add extra toggles to the 'misc' tab. Languages that use this feature should have the setting described here. Extensions should add the information to their extension page.
- This list is not up to date with the latest MediaWiki Version. List options with --list (see Manuale:UserOptions.php).
Gadget options
gadget-$gname e.g. gadget-HotCat for MediaWiki:Gadget-HotCat.js
Valori predefiniti
Each language sets its own default values for the user preferences in its language file. For example languages that read right-to-left will probably set the Quickbar to appear on the right, instead of on the left. The values added to $wgDefaultUserOptions are overrides, i.e. if the value exists here then it will take precedence, but settings may be omitted from the array in which case the language's default value will be used.
In versions of MediaWiki prior to 1.8.0 the default value of this setting was simply an empty array, with the current language providing the default values.
From version 1.8.0 onwards, only the language-specific settings were overridden in the language file, so most settings are now explicitly set in DefaultSettings.php.
From version 1.19 (r91432), the overrides by the language files were removed because they didn't work, and the features that used them, like quickbar, have been done differently and better.
Esempi
To disable section editing links by default (for new and anonymous users), set the following in LocalSettings.php:
$wgDefaultUserOptions['editsection'] = 0;
From version 1.23 onwards, the section editing links need to be disabled via site-wide or user CSS, see phab:T54811 for details on the change.
MediaWiki:Common.css: .mw-editsection { display:none!important; }
Add pages the user edits to their watchlist by default:
$wgDefaultUserOptions['watchdefault'] = 1;
If the preference is of type multiselect, things are a bit more complicated. The key for each default user option is the concatenation of the preference key with the option key. For example if the preference key is 'favoritecolors' and the option key is 'red', the default user option key would be 'favoritecolorsred'. In this hypothetical scenario, if you wanted to have red and yellow selected by default, you would use:
$wgDefaultUserOptions['favoritecolorsred'] = 1;
$wgDefaultUserOptions['favoritecolorsyellow'] = 1;
If the preference is of type checkmatrix, things are even more complicated. The key for each default user option is the concatenation of the preference key with the column key and row key, separated with hyphens. For example if the preference key is 'favoritecars' and the column key is 'red' and the row key is 'corvette', the default user option key would be 'favoritecars-red-corvette'. In this hypothetical scenario, if you wanted to have red Corvette and black Jetta selected by default, you would use:
$wgDefaultUserOptions['favoritecars-red-corvette'] = 1;
$wgDefaultUserOptions['favoritecars-black-jetta'] = 1;
When writing a MediaWiki extension, instead of using the global variable $wgDefaultUserOptions, you can add a section to extensions.json:
"DefaultUserOptions": {
"math": "png"
},
References
Pagine correlate
- userOptions.php - Changing the user options of existing users
- $wgNamespacesToBeSearchedDefault
- $wgHiddenPrefs - Disabling certain user options
- UserGetDefaultOptions
