MoreMenu
MoreMenu est un script qui ajoute le menu déroulant « Page », et celui « Utilisateur » le cas échéant. Il s’agit du successeur du gadget Drop-down menus de Haza-w, qui l’a bien influencé.
Description | Liens utiles pour les tâches courantes, les outils d’analyse des pages et utilisateurs et les journaux |
---|---|
Auteurs | MusikAnimal |
Mise à jour | 2023-07-25 (517 day ago) |
Version | 5.1.23 |
Source | GitHub |
Habillages pris en charges | Tous |
Navigateurs pris en charge | Tous les navigateurs « modernes » (voir ceux compatibles) |
Présentation
Ce gadget ajoute jusqu’à deux menus déroulants à la barre de menu contenant les liens utiles pour les tâches courantes, les journaux (concernant la page ou l’utilisateur ou utilisatrice), les outils d’analyse et de statistique, et les outils d’administration. Pour toutes les pages (à l’exception des pages spéciales), le menu Page est visible. Le menu Utilisateur n’est visible que sur les pages relatives à un utilisateur ou à une utilisatrice, y compris la liste des contributions.
Certains liens ne sont disponibles que si vous avez certains droits (par exemple block pour les liens de de blocage). De plus, certains éléments du menu Utilisateur n’apparaissent qu’en fonction de l’utilisateur ou utilisatrice concerné·e, par exemple si la personne a certains droits ou si elle a été bloquée. Ainsi, le journal des blocages n’est proposé que si la personne a été bloquée par le passé. Par ailleurs, certains liens ne sont visibles que dans certains espaces de noms ou projets.
Installation
Installing globally (recommended)
Add the following to your global.js:
mw.loader.load('https://meta.wikimedia.org/w/index.php?action=raw&ctype=text/javascript&title=MediaWiki:MoreMenu.import.js');
This will import all the core modules and give you a functioning script and make it available on all wikis.
English Wikipedia extension
If you are a user of the English Wikipedia, browse to your common.js and import the enwiki extension, which adds menu items for RfAs/RfBs and XfDs, where applicable.
mw.loader.using(['mediawiki.util', 'mediawiki.api'], function () {
mw.loader.load('https://en.wikipedia.org/w/?title=MediaWiki:Gadget-MoreMenu.enwiki.js&action=raw&ctype=text/javascript');
});
Similar extensions can be added for any wiki, or may already exist on your wiki. See Customization below for more.
Menus jumping on page load
If you use the Vector skin, you prevent the tabs at the top ("Edit", "View history", etc.) from jumping around. For English users, add the following to the top of your global.css:
@import url('https://meta.wikimedia.org/w/index.php?title=MediaWiki:Gadget-MoreMenu-pagestyles.en.css&action=raw&ctype=text/css');
For non-English, replace the .en
in the path to your desired language. See Special:PrefixIndex/MediaWiki:Gadget-MoreMenu-pagestyles for a list of supported languages. If your language is missing, let the maintainers know on the talk page.
Installing as a gadget
Your local wiki may have MoreMenu available in the gadget preferences. Installing globally is recommended, however, so that MoreMenu is available on all wikis.
If you are an interface administrator and would like to install MoreMenu as a gadget on your wiki, follow these steps:
- Create
MediaWiki:Gadget-MoreMenu-local.js
with the following:mw.loader.load('https://meta.wikimedia.org/w/load.php?modules=ext.gadget.MoreMenu');
- Add the following to
MediaWiki:Gadgets-definition
:* MoreMenu-local[ResourceLoader|dependencies=mediawiki.api,mediawiki.util,user.options]|MoreMenu-local.js
- Add a description for the gadget at
MediaWiki:Gadget-MoreMenu-local
, preferably linking to this page ([[meta:MoreMenu]]
) - Optional: You can set up a peer gadget that prevents the menus from "jumping" on page load in the Vector skin. See Peer gadget for more information.
- Optional: Extend MoreMenu by adding links that specific to your wiki, for example links to a user's Request for Adminship. Create
MediaWiki:Gadget-MoreMenu.extension.js
with your extension code, and modify yourMediaWiki:Gadgets-definition
to use it:* MoreMenu-local[ResourceLoader|dependencies=mediawiki.api,mediawiki.util,user.options]|MoreMenu-local.js|MoreMenu.extension
Localization
Translations are pulled from MediaWiki:Gadget-MoreMenu.messages.lang.js
, with MediaWiki:Gadget-MoreMenu.messages.en.js as the fallback. To add new translations, make a protected edit request on the talk page, listing the key/value pairs of the messages. See Special:PrefixIndex/MediaWiki:Gadget-MoreMenu.messages for a list of currently supported languages.
Please submit changes to the English translations as a pull request on the GitHub repository.
Customization
Options
MoreMenu.disableAutoRemoval
– Don't automatically remove the native "More" menu when it's empty.MoreMenu.prefillDeletionReason
– Set tofalse
to disable prefilling the deletion reason when clicking the Delete link.
These options should be set at the top of your global.js, like the following:
MoreMenu = {
disableAutoRemoval: true,
};
MoreMenu can be extended with custom links and functionality. Links should be added only after the moremenu.ready
hook has been fired. See the examples below.
Adding custom links
MoreMenu.addLink(menu, name, url, insertAfter)
Adds the link to the given menu.MoreMenu.addSubmenuLink(menu, submenu, name, url, insertAfter)
Adds the link to the given submenu.
Here are the descriptions for each parameter:
menu
— The ID of the top-level menu under which to place the link. Either "user" or "page".submenu
— The ID of the submenu under which to place the link. For example, "analysis" or "page-logs".name
— The title for the link. This can be either a raw string or a message key.url
— The URL for the link. Usemw.util.getUrl()
for internal links.insertAfter
(optional) — The ID of an existing link after which to place the link. You can usefalse
to force the link to be put at the top, andtrue
to force it to the bottom. Otherwise, if no link with the given ID is found, or this parameter is omitted entirely, the link will be placed into the menu alphabetically.
Examples
To add a link to https://example.org under the "Page" menu, add the following code to your common.js page:
mw.hook('moremenu.ready').add(function (config) {
MoreMenu.addLink(
'page',
'Example',
'https://www.example.org'
);
// add more MoreMenu.addLink(); instances here...
});
The config
object contains a lot of data. In most cases you want your link to contain the target username (config.targetUser.name
) or the page name (config.page.name
). If these are external links, you may need to use the encoded names, as with config.targetUser.encodedName
and config.page.encodedName
. See Configuration values for a list of all the available data.
Say you wanted to show a link to the user's "Requests for Adminship" pages under the "Analysis" submenu:
mw.hook('moremenu.ready').add(function (config) {
MoreMenu.addSubmenuLink(
'user',
'analysis',
'RfAs',
mw.util.getUrl('Special:PrefixIndex/Wikipedia:Requests for Adminship/' + config.user.name)
);
// add more links here...
});
Now let's say you wanted to add a "RfXs" submenu, with links to RfAs, request for bureaucratship, etc., and only show these links if those pages exist. See Links to pages matching a pattern for how to do this!
Advanced
In addition to MoreMenu.addLink()
and MoreMenu.addSubmenuLink()
, you can take advantage of the logic MoreMenu provides you in constructing your link based on some parameters, such as the user's permissions, or adding an entirely new submenu of links.
See MoreMenu/Advanced for more information.
Peer gadget
When top-level menus are added in the Vector skin, the "Read", "Edit", and "View history" tabs will shift. This means that if you are working very quickly, you might accidentally click in the wrong place before MoreMenu finishes loading. To prevent this, you can use a peer gadget to keep the space available.
First, check Special:PrefixIndex/MediaWiki:Gadget-MoreMenu-pagestyles to see if there is CSS code for your language already that you can copy to your wiki. If there isn't, you'll need to calculate the widths. Once the gadget is enabled, you can run $('.mm-page').outerWidth()
and $('.mm-user').outerWidth()
to get the widths in pixels.
Once you have the widths, create MediaWiki:Gadget-MoreMenu-local-pagestyles.css
with the following (in this case for English, and using em
instead of px
):
/*** VECTOR ***/
/* User menu */
.client-js .skin-vector.ns-2 #p-views,
.client-js .skin-vector.ns-3 #p-views,
.client-js > .skin-vector.mw-special-Contributions #p-views,
.client-js > .skin-vector.mw-special-DeletedContributions #p-views,
.client-js > .skin-vector.mw-special-Block #p-views {
padding-right: 3.68em;
}
/* Page menu */
.client-js .skin-vector:not(.ns-special) #p-views .vector-menu-content::after {
content: '';
display: inline-block;
width: 3.85em;
}
Then update your gadget configuration accordingly:
* MoreMenu-local[ResourceLoader|dependencies=mediawiki.api,mediawiki.util,user.options|peers=MoreMenu-local-pagestyles]|MoreMenu-local.js
* MoreMenu-local-pagestyles[hidden]|MoreMenu-local-pagestyles.css
Bugs/feature requests
Ask/request anything you'd like on the talk page.