Community Central
Community Central
No edit summary
Tags: Visual edit Help
m (→‎Auto-populating the menu: Remove unused closed tag.)
Tag: Help
(12 intermediate revisions by 8 users not shown)
Line 6: Line 6:
   
 
== Default navigation bar elements ==
 
== Default navigation bar elements ==
[[File:MCU local nav.jpg|thumb|center|700px]]
+
[[File:MCU local ucx nav.png|thumb|center|700px]]
The navigation menu can be found in the page header at the top of every wiki page. It has the option to add up to four customizable menu options, in addition to the "Explore" menu and "Main Page" button.
+
The navigation menu can be found in the page header at the top of every wiki page. It has the option to add up to four customizable menu options, in addition to the "Explore" menu.
* The "Explore" tab is always present in the navigation and provides important wiki links, including [[Help:WikiActivity|WikiActivity]], [[Help:Random page|Random page]], [[Help:Community Page|Community]] (if enabled), [[Help:Videos|Videos]], and [[Help:Adding images|Images]]. This menu is not customizable and no additional links may be added.
+
* The "Explore" tab is always present in the navigation and provides important wiki links, including [[Help:Discussions|Discuss]] (unless disabled), [[Special:AllPages|All Pages]], [[Help:Community Page|Community]] (unless disabled), [[Help:Blogs|Recent Blog Posts]] (unless disabled), [[Help:Random page|Random page]], [[Help:Videos|Videos]], and [[Help:Adding images|Images]]. For some communities, a "Shop" item may also be present at the bottom (more info [[User blog:MisterWoodhouse/Introducing Affiliate Marketing|here]]), and a "Main Page" link may appear at the top depending on [[Help:Preferences|preference]]. Beyond this user preference, the entire "Explore" menu is not customizable and no additional links may be added.
 
* "Main Page" links to your wiki's [[Help:Main page|Main Page]].
 
* "Main Page" links to your wiki's [[Help:Main page|Main Page]].
  +
** For users with "Main Page" set as their default landing page, simply clicking the wordmark or [[Help:Sitename|sitename]] text links to the Main Page. '''This is default, and the experience shown to readers.'''
* On the right, it indicates a cosmetic header image that can be uploaded from [[Help:Theme Designer|Theme Designer]].
 
  +
** For users with "Recent Changes" set as their default landing page, a "Main Page" link will appear at the top of the aforementioned "Explore" tab. Clicking the wordmark or sitename text leads to Recent Changes.
* On the top right corner of the page header, there is a page count along with a few buttons that access to various tools (''For more info, see [[Help:Header shortcuts]]''). All users will see the "Add New Page" button, and registered users will see the Wiki Activity button next to it, along with the more shortcuts button next to the Wiki Activity button. Administrators will also see a button on the [[Help:Admin Dashboard|Admin Dashboard]].
 
  +
** For users with "Community Feeds" set as their default landing page, a "Main Page" link will ''replace'' the Discussions link with a Main Page link, or generate one in its place if Discussions is not enabled. Clicking the wordmark or sitename text will link to Discussions.
* On the left, there is a graphical wordmark, along with the community name. This is where both can be customized via [[Help:Theme Designer|Theme Designer]].
 
 
* A cosmetic header image, which appears behind the navigation, can be uploaded from [[Help:Theme Designer|Theme Designer]].
 
* On the top right corner of the page header, there is a page count along with a few buttons that access to various tools (''For more info, see [[Help:Header shortcuts]]''). All users will see the Discussions button (unless discussions is disabled) and the Light/Dark theme toggle button. Registered users will see the [[Help:Recent changes|Recent Changes]] button, along with the more shortcuts button which provides additional links.
 
* On the left, there is a graphical site logo, along with the community name. By default, the text adopts the wiki's [[Help:Sitename|sitename]], but both site logo and text can be customized via [[Help:Theme Designer|Theme Designer]].
   
 
== Customizing your navigation ==
 
== Customizing your navigation ==
Line 20: Line 23:
 
Each item in the navigation bar is represented by a line in MediaWiki:Wiki-navigation page. Level 1 items are prefixed with one asterisk (*), level 2 items are prefixed with two asterisks, and level 3 items are prefixed with 3 asterisks. Like so:
 
Each item in the navigation bar is represented by a line in MediaWiki:Wiki-navigation page. Level 1 items are prefixed with one asterisk (*), level 2 items are prefixed with two asterisks, and level 3 items are prefixed with 3 asterisks. Like so:
   
  +
[[File:UCP navigation edit.jpg|center|thumb|500px|Editing the navigation]]
<div style="text-align:center;">
 
[[File:UCP_navigation_edit.jpg|center|500px]]<br />
 
''Editing the navigation''
 
</div>
 
 
   
 
After the asterisk, type the name of the page you are linking to. If you want the name to display differently than the page's actual name, set a pipe between the name of the page and the text you want to display. For example, if you are linking to a page called Lion but you want to display it as Kitten, use <code>Lion|Kitten</code> after the asterisk.
 
After the asterisk, type the name of the page you are linking to. If you want the name to display differently than the page's actual name, set a pipe between the name of the page and the text you want to display. For example, if you are linking to a page called Lion but you want to display it as Kitten, use <code>Lion|Kitten</code> after the asterisk.
   
If you don't want a navigation item to link to anything, add <code>
+
If you don't want a navigation item to link to anything, add <code><nowiki>#|</nowiki></code> in front of it.
 
For example, a navigation bar set to:
<nowiki>#|</nowiki></code> in front of it.
 
For example, a navigation bar set to
 
   
 
<pre>
 
<pre>
Line 36: Line 34:
 
** Prequel trilogy
 
** Prequel trilogy
 
** Sequel trilogy
 
** Sequel trilogy
*#|Videogames
+
*#|Video games
** First videogame
+
** First video game
** Second videogame
+
** Second video game
 
**#|In Development
 
**#|In Development
*** Untitled Third Videogame|Third game
+
*** Untitled Third Video Game|Third game
 
*** Spin-off (Game)|Recently announced spin-off title
 
*** Spin-off (Game)|Recently announced spin-off title
 
</pre>
 
</pre>
 
will contain:
 
will contain:
* Two Level 1 navigation items, '''Movies''' and '''Videogames''', that aren't linking to any pages.
+
* Two Level 1 navigation items, '''Movies''' and '''Video games''', that aren't linking to any pages.
* Four Level 2 navigation items, two being under '''Movies''' and linking to '''Prequel trilogy''' and '''Sequel trilogy''' pages on your wiki, and two being under '''Videogames''' and linking to '''First videogame''' and '''Second videogame''', with '''In Development''' not linking to anything.
+
* Five Level 2 navigation items, two being under '''Movies''' and linking to '''Prequel trilogy''' and '''Sequel trilogy''' pages on your wiki, and three being under '''Videogames''' and linking to '''First videogame''' and '''Second videogame''', with '''In Development''' not linking to anything.
* Two Level 3 navigation items under '''In Development''', first linking to the '''Untitled Third Videogame''' page on your wiki and displaying the text '''Third game''', and a second one linking to '''Spin-off (Game)''' and displaying the text '''Recently announced spin-off title'''.
+
* Two Level 3 navigation items under '''In Development''', first linking to the '''Untitled Third Video Game''' page on your wiki and displaying the text '''Third game''', and a second one linking to '''Spin-off (Game)''' and displaying the text '''Recently announced spin-off title'''.
   
  +
[[File:UCP navigation preview.jpg|center|thumb|500px|Preview of the navigation]]
When you are ok with changes you done, '''review''' changes. Make sure you did not done any mistake. If you think it looks ok, save page.
 
<div style="text-align:center;">
 
[[File:UCP_navigation_preview.jpg|center|500px]]<br />
 
''Preview of the navigation''
 
</div>
 
   
  +
After you make your changes, review your changes and save.
   
 
=== How many links can it contain? ===
 
=== How many links can it contain? ===
Line 61: Line 56:
 
* 10 '''Level 3''' links with a dynamic width and a minimum width of 150px. These appear as dropdown style menus under each of the level 2 links.
 
* 10 '''Level 3''' links with a dynamic width and a minimum width of 150px. These appear as dropdown style menus under each of the level 2 links.
   
It is best to showcase as much '''relevant content''' as possible in an organized fashion, without overstuffing your navigation. '''Include links''' to those categories and pages that are '''most important for readers''', while leaving out any links that are only useful for editors or that are already built into Fandom's interface. For example, links to contact Fandom staff, create a new page, or access RecentChanges can already be found elsewhere on every page, and links to special pages or editing guidelines are only relevant to editors and shouldn't take up a navigation bar slot.
+
It is best to showcase as much '''relevant content''' as possible in an organized fashion, without overstuffing your navigation. '''Include links''' to those categories and pages that are '''most important for readers''', while leaving out any links that are only useful for editors or that are already built into Fandom's interface. For example, links to contact Fandom staff, create a new page, or access Recent Changes can already be found elsewhere on every page, and links to special pages or editing guidelines are only relevant to editors and shouldn't take up a navigation bar slot.
   
<div style="text-align:center;">
+
<div class="center">
'''No additional links or menu levels may be added with custom CSS or JavaScript.'''
+
[[Help:Customization policy|'''No additional top-level menus may be added with custom CSS or JavaScript.''' Additional items on all other child menus may be appended as necessary.]]
 
</div>
 
</div>
   
  +
=== Auto-populating the menu ===
  +
You can use [[Help:Magic words|magic words]] to automatically fill in menu items. Note that these are heavily affected by caching, and it may still be better to list out specific pages instead.
  +
  +
'''Supported magic words:'''
  +
* <code>#newlychanged#</code> — lists newly changed pages
  +
* <code>#topusers#</code> — lists the most active users on the wiki.
  +
* Please note: the keywords <code>#categoryX#</code> and <code>#category-Y#</code> no longer function as intended. They formerly returned the most popular pages in a category, but the popularity functionality was removed over 10 years ago and is not scheduled to be returned. If used, they will return the first 7 pages created in the category. This list will not change.
  +
  +
Since magic words generate lists of pages, they may only be used as Level 2 menu items; the list they generate will appear as the Level 3 menu items. All of the magic words list a maximum of 7 pages.
  +
  +
'''Notes:'''
  +
* Don't forget to include the <code>#</code> symbols around the magic words you choose to use.
  +
* Since magic words list at most 7 pages, up to 3 additional level 3 menu items may be added and will appear after the auto-generated list.
   
 
== Next pages ==
 
== Next pages ==
* Read our [[w:User_blog:Mira_Laime/The_best_possible_local_navigation_bar|guide on how to decide which links to include in your navigation]]
+
* Read our [[User blog:Mira Laime/The best possible local navigation bar|guide on how to decide which links to include in your navigation]]
 
* Learn how to edit [[Help:Toolbar|your toolbar]]
 
* Learn how to edit [[Help:Toolbar|your toolbar]]
* Learn how to view the [[Help:WikiActivity|latest wiki activity]]
+
* Learn how to view the [[Help:Recent changes|recent changes]]
* Learn how to edit the [[Help:Community messages|community corner]]
 
   
 
== Further help and feedback ==
 
== Further help and feedback ==
{{Help and feedback section}}[[be:Даведка:Меню Вікія]]
+
{{Help and feedback section}}
  +
 
[[ca:Ajuda:Navegació]]
 
[[ca:Ajuda:Navegació]]
 
[[de:Hilfe:Navigation]]
 
[[de:Hilfe:Navigation]]
Line 88: Line 96:
 
[[pt:Ajuda:Navegação]]
 
[[pt:Ajuda:Navegação]]
 
[[ru:Справка:Меню вики]]
 
[[ru:Справка:Меню вики]]
[[tr:Yardım:Navigasyon]]
+
[[tr:Yardım:Gezinti]]
 
[[uk:Довідка:Меню вікі]]
 
[[uk:Довідка:Меню вікі]]
 
[[vi:Trợ giúp:Điều hướng]]
 
[[vi:Trợ giúp:Điều hướng]]

Revision as of 15:25, 18 October 2021

A wiki's local navigation is the menu that can be found in the page header at the top of all pages. It provides useful links to the most important and interesting pages on your wiki. A well-crafted navigation menu will help readers find key content that they are looking for.

When deciding how to organize your local navigation bar and what content to include, you'll need to put yourself into your visitor's shoes. Think about what they are most likely to be looking for, and provide a straight path to as much relevant wiki content as possible.

Keep in mind that almost all visitors to your wiki come to read articles, not to create them. Editors only make up 0.05 percent of Fandom's visitors, and while wikis couldn't even exist without their hard work, the local navigation bar should first and foremost serve your readers. Editors create awesome content, and the navigation bar helps readers find it, while other site elements, such as the bottom tool bar help editors access the tools they need.

Default navigation bar elements

MCU local ucx nav

The navigation menu can be found in the page header at the top of every wiki page. It has the option to add up to four customizable menu options, in addition to the "Explore" menu.

  • The "Explore" tab is always present in the navigation and provides important wiki links, including Discuss (unless disabled), All Pages, Community (unless disabled), Recent Blog Posts (unless disabled), Random page, Videos, and Images. For some communities, a "Shop" item may also be present at the bottom (more info here), and a "Main Page" link may appear at the top depending on preference. Beyond this user preference, the entire "Explore" menu is not customizable and no additional links may be added.
  • "Main Page" links to your wiki's Main Page.
    • For users with "Main Page" set as their default landing page, simply clicking the wordmark or sitename text links to the Main Page. This is default, and the experience shown to readers.
    • For users with "Recent Changes" set as their default landing page, a "Main Page" link will appear at the top of the aforementioned "Explore" tab. Clicking the wordmark or sitename text leads to Recent Changes.
    • For users with "Community Feeds" set as their default landing page, a "Main Page" link will replace the Discussions link with a Main Page link, or generate one in its place if Discussions is not enabled. Clicking the wordmark or sitename text will link to Discussions.
  • A cosmetic header image, which appears behind the navigation, can be uploaded from Theme Designer.
  • On the top right corner of the page header, there is a page count along with a few buttons that access to various tools (For more info, see Help:Header shortcuts). All users will see the Discussions button (unless discussions is disabled) and the Light/Dark theme toggle button. Registered users will see the Recent Changes button, along with the more shortcuts button which provides additional links.
  • On the left, there is a graphical site logo, along with the community name. By default, the text adopts the wiki's sitename, but both site logo and text can be customized via Theme Designer.

Customizing your navigation

Editing navigation items

If you are an administrator, you can edit the navigation menu at MediaWiki:Wiki-navigation. You can also access this in your Admin Dashboard by clicking Top Navigation.

Each item in the navigation bar is represented by a line in MediaWiki:Wiki-navigation page. Level 1 items are prefixed with one asterisk (*), level 2 items are prefixed with two asterisks, and level 3 items are prefixed with 3 asterisks. Like so:

UCP navigation edit

Editing the navigation

After the asterisk, type the name of the page you are linking to. If you want the name to display differently than the page's actual name, set a pipe between the name of the page and the text you want to display. For example, if you are linking to a page called Lion but you want to display it as Kitten, use Lion|Kitten after the asterisk.

If you don't want a navigation item to link to anything, add #| in front of it. For example, a navigation bar set to:

*#|Movies
** Prequel trilogy
** Sequel trilogy
*#|Video games
** First video game
** Second video game
**#|In Development
*** Untitled Third Video Game|Third game
*** Spin-off (Game)|Recently announced spin-off title

will contain:

  • Two Level 1 navigation items, Movies and Video games, that aren't linking to any pages.
  • Five Level 2 navigation items, two being under Movies and linking to Prequel trilogy and Sequel trilogy pages on your wiki, and three being under Videogames and linking to First videogame and Second videogame, with In Development not linking to anything.
  • Two Level 3 navigation items under In Development, first linking to the Untitled Third Video Game page on your wiki and displaying the text Third game, and a second one linking to Spin-off (Game) and displaying the text Recently announced spin-off title.
UCP navigation preview

Preview of the navigation

After you make your changes, review your changes and save.

How many links can it contain?

The Navigation menu offers a maximum of 312 links, although it is not necessary to use all of them. The links are grouped as:

  • 4 Level 1 links which combine for a total width of 550px. These are the links that are always visible above the colored menu bar.
  • 7 Level 2 links with a maximum total width of 729px. These are the links that appear on the colored bar when hovering over any of the level 1 links.
  • 10 Level 3 links with a dynamic width and a minimum width of 150px. These appear as dropdown style menus under each of the level 2 links.

It is best to showcase as much relevant content as possible in an organized fashion, without overstuffing your navigation. Include links to those categories and pages that are most important for readers, while leaving out any links that are only useful for editors or that are already built into Fandom's interface. For example, links to contact Fandom staff, create a new page, or access Recent Changes can already be found elsewhere on every page, and links to special pages or editing guidelines are only relevant to editors and shouldn't take up a navigation bar slot.

Auto-populating the menu

You can use magic words to automatically fill in menu items. Note that these are heavily affected by caching, and it may still be better to list out specific pages instead.

Supported magic words:

  • #newlychanged# — lists newly changed pages
  • #topusers# — lists the most active users on the wiki.
  • Please note: the keywords #categoryX# and #category-Y# no longer function as intended. They formerly returned the most popular pages in a category, but the popularity functionality was removed over 10 years ago and is not scheduled to be returned. If used, they will return the first 7 pages created in the category. This list will not change.

Since magic words generate lists of pages, they may only be used as Level 2 menu items; the list they generate will appear as the Level 3 menu items. All of the magic words list a maximum of 7 pages.

Notes:

  • Don't forget to include the # symbols around the magic words you choose to use.
  • Since magic words list at most 7 pages, up to 3 additional level 3 menu items may be added and will appear after the auto-generated list.

Next pages

Further help and feedback