Community Central
Community Central
(Fixing the number of pages retrieved by auto-populating magic words, and some grammar fixes to the explanations)
m (Some minor fixes and, changing tr link, and remove unsupported interlanguage link.)
Tag: Help
(48 intermediate revisions by 30 users not shown)
Line 1: Line 1:
 
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.
{{Uni-vid|Fandom University - Setting Up Your Navigation Menu}}
 
A wiki's local '''navigation''' is the menu that can be found at the top of all pages, in the page header, that 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.
 
   
  +
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.
You can link to any page, and it is important to think about what are the most important places for visitors to see when they come to your community. FANDOM recommends adding links to popular pages in addition to links showing where to find the community.
 
   
  +
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 [[Help:Toolbar|the bottom tool bar]] help editors access the tools they need.
== Overview ==
 
  +
[[File:Wiki nav.png|thumb|center|700px]]
 
  +
== Default navigation bar elements ==
 
[[File:MCU local nav.jpg|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 "Discuss" 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 and "Discuss" button.
* 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: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:Recent changes|Recent Changes]], [[Help:Random page|Random page]], [[Help:Community Page|Community]] (unless disabled), [[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.
  +
* "Discuss" links to your wiki's [[Help:Discussions|Discussions]].
* "Discuss" links to your wiki's [[Help:Discussions|Discussions]]. If Discussions and [[Help:Forum|Forum]] are both enabled, "Discuss" will lead to Discussions while Forum will appear in the "Explore" menu. If Forum is enabled but not Discussions, you will see a "Forum" button instead that leads to the Forum. If neither feature is enabled, "Discuss" will not appear.
 
  +
** '''Note:''' if Discussions are not enabled, "Discuss" will not appear.
  +
* "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.'''
  +
** 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.
 
* On the right, it indicates a cosmetic header image that can be uploaded from [[Help:Theme Designer|Theme Designer]].
 
* On the right, it indicates a cosmetic header image that 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 "Add New Page" button, registered users will see the Wiki Activity button next to it along with the more shortcuts button next to the Wiki Activity button and administrators will also see a button to the [[Help:Admin Dashboard|Admin Dashboard]].
+
* 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 Recent Changes button next to it, along with the more shortcuts button next to the Recent Changes button. Administrators will also see a button for the [[Help:Admin Dashboard|Admin Dashboard]].
* On the left, there is a graphical wordmark, along with the community name, where both can be customized via [[Help:ThemeDesigner|Theme Designer]].
+
* On the left, there is a graphical wordmark, along with the community name. By default, the text adopts the wiki's sitename, but both wordmark and text can be customized via [[Help:Theme Designer|Theme Designer]].
   
  +
== Customizing your navigation ==
== Step-by-step ==
 
=== Editing the 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.
 
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:
 
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:Wiki nav editing.png|center]]
 
  +
[[File:UCP navigation edit.jpg|center|thumb|500px|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 <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>#|</code> in front of it.
+
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
+
For example, a navigation bar set to:
  +
 
<pre>
 
<pre>
* #|Content
+
*#|Movies
** Page One
+
** Prequel trilogy
** Page Two
+
** Sequel trilogy
  +
*#|Video games
* #|Community
 
  +
** First video game
** Blog:Recent posts
 
  +
** Second video game
** #|Policy
 
  +
**#|In Development
*** Project:Policy|Policy
 
  +
*** Untitled Third Video Game|Third game
*** Project:Administrators|Staff
 
  +
*** Spin-off (Game)|Recently announced spin-off title
 
</pre>
 
</pre>
 
will contain:
 
will contain:
* Two Level 1 navigation items, Content and Community, 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 Content and linking to '''Page One''' and '''Page Two''' pages on your wiki, and two being under Community and linking to '''Blog:Recent posts''' and '''Policy''', with Policy one 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 Policy, first linking to '''Project:Policy''' page on your wiki and displaying the text "Policy", and second one linking to '''Project:Administrators''' and displaying the text "Staff".
+
* 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]]
After you make your changes, you will need to Preview the changes before you can Publish them. The Preview button is located beneath the Edit Summary box. The Preview button will show your new navigation and check for errors in the wiki text. For example, it will report an error if you try to use a Magic Word in a Level 1 or Level 3 menu item. It will also run a width validator tool which will inform you if your menu items are too wide to display at the minimum width of the site.
 
[[File:Width validator.png|center|600px]]
 
   
  +
After you make your changes, review your changes and save.
If there are any problems, you will need to return back to the editor to adjust your navigation. When your preview contains no errors, the Publish button will appear in the preview window. Click it and your new navigation will be live.
 
[[File:Wiki nav menu levels.png|thumb|center|600px]]
 
   
 
=== How many links can it contain? ===
 
=== How many links can it contain? ===
Line 51: Line 58:
 
* 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 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.
No additional links or menu levels may be added with custom CSS or JavaScript.
 
  +
  +
<div class="center">
 
'''[[Help:Customization policy|No additional links or menu levels may be added with custom CSS or JavaScript.]]'''
  +
</div>
   
 
=== Auto-populating the menu ===
 
=== 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.
One way to make sure the navigation has dynamic content that highlights the strengths of your community is to use [[Help:Magic words#Wiki Navigation|magic words]] to automatically fill in menu items.
 
  +
* To do this, use # symbols around the magic words you choose to use.
 
 
'''Supported magic words:'''
* 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.
 
  +
* <code>#newlychanged#</code> — lists newly changed pages
* '''Supported Magic Words'''
 
** '''#categoryX#''' — lists the top pages from the Xth-biggest category on a wiki (replace "X" with a number greater than 0)
+
* <code>#categoryX#</code> — lists the top pages from the Xth-biggest category on a wiki (replace "X" with a number greater than 0)
** '''#category-Y#''' — lists the top pages from Category:Y (replace "Y" with the name of your category)
+
* <code>#category-Y#</code> — lists the top pages from Category:Y (replace "Y" with the name of your category)
  +
** '''#visited#''' — lists the top visited pages from [[MediaWiki:Most popular articles]]
 
 
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.
** '''#newlychanged# ''' — lists the pages most recently changed in your wiki's main namespace
 
  +
** '''#topusers#''' — lists the most active users
 
  +
'''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 [[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}}
 
{{Help and feedback section}}
   
  +
[[ca:Ajuda:Navegació]]
 
[[de:Hilfe:Navigation]]
 
[[de:Hilfe:Navigation]]
 
[[es:Ayuda:Navegación]]
 
[[es:Ayuda:Navegación]]
Line 83: Line 98:
 
[[pt:Ajuda:Navegação]]
 
[[pt:Ajuda:Navegação]]
 
[[ru:Справка:Меню вики]]
 
[[ru:Справка:Меню вики]]
  +
[[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 16:48, 5 March 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 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 and "Discuss" button.

  • The "Explore" tab is always present in the navigation and provides important wiki links, including Recent Changes, Random page, Community (unless disabled), 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.
  • "Discuss" links to your wiki's Discussions.
    • Note: if Discussions are not enabled, "Discuss" will not appear.
  • "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.
  • On the right, it indicates a cosmetic header image that 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 "Add New Page" button, and registered users will see the Recent Changes button next to it, along with the more shortcuts button next to the Recent Changes button. Administrators will also see a button for the Admin Dashboard.
  • On the left, there is a graphical wordmark, along with the community name. By default, the text adopts the wiki's sitename, but both wordmark 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
  • #categoryX# — lists the top pages from the Xth-biggest category on a wiki (replace "X" with a number greater than 0)
  • #category-Y# — lists the top pages from Category:Y (replace "Y" with the name of your category)

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