View source for MoreMenu/cs

<languages/>
{{infobox
 | title = MoreMenu
 | label1 = Popis
 | data1 = Užitečné odkazy na běžné úkoly, nástroje pro analýzu uživatelů a stránek a protokoly
 | label2 = Autoři
 | data2 = {{u|MusikAnimal}}
 | label3 = Aktualizace
 | data3 = {{date and time since|2021-10-26}}
 | label4 = Verze
 | data4 = 5.1.17
 | label5 = Zdroj
 | data5 = [https://github.com/wikimedia-gadgets/MoreMenu GitHub]
 | label6 = Podpora [[mw:Special:MyLanguage/Help:Skins|Skinů]]
 | data6 = Vše
 | label7 = Podpora [[w:Web browser|prohlížečů]]
 | data7 = Všechny "moderní" prohlížeče, viz [[mw:Special:MyLanguage/Compatibility#Browsers|Kompatibilita#Prohlížeče]]
 | image = [[File:Screenshot of MoreMenu script.png|300px]]
 | caption = Analýza Jimbových příspěvků
}}

'''MoreMenu''' je skript, který na panel nástrojů přidá rozbalovací nabídky "Stránka" a případně "Uživatel". Je to nástupce {{nowrap|{{u|Haza-w}}}} {{nowrap|[[en:User:Haza-w/Drop-down menus|Drop-down menus]]}} gadget a byl jím silně ovlivněn.

== Přehled ==

Tento gadget přidává do panelu nabídek až dvě rozbalovací nabídky obsahující odkazy na užitečné běžné úlohy, protokoly uživatelů/stránek, analytické nástroje/statistiky a nástroje pro správce. Pro všechny stránky kromě [[mw:Special:MyLanguage/Help:Special pages|speciálních stránek]] je viditelná nabídka Stránka. Nabídka Uživatel je viditelná pouze na stránkách týkajících se uživatele, včetně [[mw:Special:MyLanguage/Help:User contributions|stránek s příspěvky]].

[[Image:MoreMenu gadget page analysis screenshot.png|left|thumb|600px|Snímek obrazovky nabídky Analýza v rozbalovací nabídce Stránka.]]
{{clear}}

Některé odkazy jsou dostupné pouze v případě, že máte určitá [[mw:Special:MyLanguage/Help:User rights and groups|práva]]. (například {{mono|blok}} pro blokové odkazy). Kromě toho se položky v nabídce Uživatel mohou zobrazovat na základě podmínek zobrazovaného uživatele, například ''jeho'' uživatelských práv, nebo pokud měl aktuální či předchozí bloky atd. Například položka ''Protokol blokování'' v podnabídce Bloky se zobrazí pouze v případě, že byl daný uživatel v minulosti zablokován. Některé odkazy jsou také viditelné pouze v určitých jmenných prostorech a na určitých projektech.

== Instalace ==

=== Globální instalace (doporučeno) ===
{{anchor|Installing globally (recommended)}}
Do [[m:Special:MyPage/global.js|global.js]] přidejte následující položky:
<syntaxhighlight lang="javascript">
mw.loader.load('https://meta.wikimedia.org/w/index.php?action=raw&ctype=text/javascript&title=MediaWiki:MoreMenu.import.js');
</syntaxhighlight>

Tím naimportujete všechny základní moduly a získáte funkční skript, který bude k dispozici na všech wiki.

<div lang="en" dir="ltr" class="mw-content-ltr">
==== English Wikipedia extension ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are a user of the English Wikipedia, browse to your [[w:Special:MyPage/common.js|common.js]] and import the enwiki extension, which adds menu items for RfAs/RfBs and XfDs, where applicable.
</div>
<syntaxhighlight lang="javascript">
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');
});
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Similar extensions can be added for any wiki, or may already exist on your wiki. See [[#Customization|Customization]] below for more.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Menus jumping on page load ====
</div>
{{anchor|Menus jumping on page load}}

<div lang="en" dir="ltr" class="mw-content-ltr">
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 [[Special:MyPage/global.css|global.css]]:
</div>
<syntaxhighlight lang="css">
@import url('https://meta.wikimedia.org/w/index.php?title=MediaWiki:Gadget-MoreMenu-pagestyles.en.css&action=raw&ctype=text/css');
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
For ''non-English'', replace the <code>.en</code> 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:MoreMenu|talk page]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Installing as a gadget ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Your local wiki may have MoreMenu available in the gadget preferences. [[#Installing globally (recommended)|Installing globally]] is recommended, however, so that MoreMenu is available on all wikis.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are an interface administrator and would like to install MoreMenu as a gadget on your wiki, follow these steps:
</div>
# <span lang="en" dir="ltr" class="mw-content-ltr">Create <code>MediaWiki:Gadget-MoreMenu-local.js</code> with the following:</span>
#:<syntaxhighlight lang="js">
mw.loader.load('https://meta.wikimedia.org/w/load.php?modules=ext.gadget.MoreMenu');
</syntaxhighlight>
# <span lang="en" dir="ltr" class="mw-content-ltr">Add the following to <code>MediaWiki:Gadgets-definition</code>:</span>
#:<syntaxhighlight>
MoreMenu-local[ResourceLoader|dependencies=mediawiki.api,mediawiki.util,user.options]|MoreMenu-local.js
</syntaxhighlight>
# <span lang="en" dir="ltr" class="mw-content-ltr">Add a description for the gadget at <code>MediaWiki:Gadget-MoreMenu-local</code>, preferably linking to this page (<code><nowiki>[[meta:MoreMenu]]</nowiki></code>)</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">''Optional'': You can set up a [[mw:Special:MyLanguage/ResourceLoader/Migration_guide_(users)#Gadget_peers|peer gadget]] that prevents the menus from "jumping" on page load in the Vector skin. See [[#Peer gadget|Peer gadget]] for more information.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">''Optional'': [[#Customization|Extend]] MoreMenu by adding links that specific to your wiki, for example [[MoreMenu/Advanced#Links to pages matching a pattern|links to a user's Request for Adminship]]. Create <code>MediaWiki:Gadget-MoreMenu.extension.js</code> with your extension code, and modify your <code>MediaWiki:Gadgets-definition</code> to use it:</span><syntaxhighlight>
MoreMenu-local[ResourceLoader|dependencies=mediawiki.api,mediawiki.util,user.options]|MoreMenu-local.js|MoreMenu.extension
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Localization ==
</div>
{{anchor|Localization}}
<div lang="en" dir="ltr" class="mw-content-ltr">
Translations are pulled from <code>MediaWiki:Gadget-MoreMenu.messages.''lang''.js</code>, with [[MediaWiki:Gadget-MoreMenu.messages.en.js]] as the fallback. To add new translations, make a [[:Template:Edit Protected|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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please submit changes to the English translations as a pull request on the [https://github.com/MusikAnimal/MoreMenu GitHub repository].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Customization ==
</div>
{{anchor|Customization}}
<div lang="en" dir="ltr" class="mw-content-ltr">
MoreMenu can be extended with custom links and functionality. Links should be added only after the <code>moremenu.ready</code> [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook hook] has been fired. See the examples below.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Adding custom links ===
</div>
* <code>MoreMenu.addLink(''menu'', ''name'', ''url'', ''insertAfter)''</code><span lang="en" dir="ltr" class="mw-content-ltr">Adds the link to the given menu.</span>
* <code>MoreMenu.addSubmenuLink(''menu'', ''submenu'', ''name'', ''url'', ''insertAfter'')</code><span lang="en" dir="ltr" class="mw-content-ltr">Adds the link to the given submenu.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Here are the descriptions for each parameter:
</div>

* <code>menu</code> — <span lang="en" dir="ltr" class="mw-content-ltr">The ID of the top-level menu under which to place the link. Either "user" or "page".</span>
* <code>submenu</code> — <span lang="en" dir="ltr" class="mw-content-ltr">The ID of the submenu under which to place the link. For example, "analysis" or "page-logs".</span>
* <code>name</code> — <span lang="en" dir="ltr" class="mw-content-ltr">The title for the link. This can be either a raw string or a [[#Localization|message key]].</span>
* <code>url</code> — <span lang="en" dir="ltr" class="mw-content-ltr">The URL for the link. Use [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-getUrl <code>mw.util.getUrl()</code>] for internal links.</span>
* <code>insertAfter</code> (optional) — <span lang="en" dir="ltr" class="mw-content-ltr">The ID of an existing link after which to place the link. You can use <code>false</code> to force the link to be put at the top, and <code>true</code> 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.</span>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
To add a link to https://example.org under the "Page" menu, add the following code to your [[w:Special:MyPage/common.js|common.js]] page:
</div>
<syntaxhighlight lang="javascript">
mw.hook('moremenu.ready').add(function (config) {
    MoreMenu.addLink(
        'page',
        'Example',
        'https://www.example.org'
    );
    
    // add more MoreMenu.addLink(); instances here...
    
});
</syntaxhighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>config</code> object contains a lot of data. In most cases you want your link to contain the target username (<code>config.targetUser.name</code>) or the page name (<code>config.page.name</code>). If these are external links, you may need to use the encoded names, as with <code>config.targetUser.encodedName</code> and <code>config.page.encodedName</code>. See [[MoreMenu/Advanced#Configuration values|Configuration values]] for a list of all the available data.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Say you wanted to show a link to the user's "Requests for Adminship" pages under the "Analysis" submenu:
</div>
<syntaxhighlight lang="javascript">
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...
    
});
</syntaxhighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
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 [[MoreMenu/Advanced#Links to pages matching a pattern|Links to pages matching a pattern]] for how to do this!
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Advanced ===
</div>
{{main|MoreMenu/Advanced}}

<div lang="en" dir="ltr" class="mw-content-ltr">
In addition to <code>MoreMenu.addLink()</code> and <code>MoreMenu.addSubmenuLink()</code>, 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See [[MoreMenu/Advanced]] for more information.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Peer gadget ==
</div>
{{anchor|Peer gadget}}
{{hatnote|<span lang="en" dir="ltr" class="mw-content-ltr">This documentation is for setting up MoreMenu as a gadget on your local wiki. See [[#Menus jumping on page load|Menus jumping on page load]] for user installation.</span>}}

<div lang="en" dir="ltr" class="mw-content-ltr">
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 [[mw:Special:MyLanguage/ResourceLoader/Migration guide (users)#Gadget peers|peer gadget]] to keep the space available.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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 <code>$('.mm-page').outerWidth()</code> and <code>$('.mm-user').outerWidth()</code> to get the widths in pixels.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Once you have the widths, create <code>MediaWiki:Gadget-MoreMenu-local-pagestyles.css</code> with the following (in this case for English, and using <code>em</code> instead of <code>px</code>):
</div>
<syntaxhighlight lang="css">
/*** 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;
}
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Then update your gadget configuration accordingly:
</div>
<syntaxhighlight>
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
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Bugs/feature requests ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Ask/request anything you'd like on the [[Talk:MoreMenu|talk page]].
</div>
[[Category:Gadgets{{#translation:}}|MoreMenu]]