Difference between revisions of "Navigation"
(30 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
[[Category:Components]] | [[Category:Components]] | ||
+ | |||
+ | see also [[Navigation examples]] | ||
+ | |||
+ | |||
=== Navigational Sections === | === Navigational Sections === | ||
You can change the content of these via system [[Messages|messages]] and control the visibility via the <code><nowiki>{{#tweekihide:}}</nowiki></code> [[Parser Functions#Tweekihide parser function|parser function]] and [[Configuration_Options#Hiding_Page_Elements|configuration options]]. | You can change the content of these via system [[Messages|messages]] and control the visibility via the <code><nowiki>{{#tweekihide:}}</nowiki></code> [[Parser Functions#Tweekihide parser function|parser function]] and [[Configuration_Options#Hiding_Page_Elements|configuration options]]. | ||
+ | ''Example:'' If you want to change the content of the right sidebar edit [[MediaWiki:tweeki-sidebar-right]]. | ||
{| style="border-spacing:3px;border-collapse:separate; width:100%" | {| style="border-spacing:3px;border-collapse:separate; width:100%" | ||
Line 24: | Line 29: | ||
The main navigation on the top of the page. In this demo installation it is hidden for anonymous users. It can scroll with the page or it can be fixed and always visible (configure it via [[MediaWiki:Tweeki-navbar-class]]). | The main navigation on the top of the page. In this demo installation it is hidden for anonymous users. It can scroll with the page or it can be fixed and always visible (configure it via [[MediaWiki:Tweeki-navbar-class]]). | ||
− | It consists of three parts whose contents can be changed via system messages: navbar-brand, navbar-left, and navbar-right | + | It consists of three parts whose contents can be changed via system messages: <code>navbar-brand</code>, <code>navbar-left</code>, and <code>navbar-right</code> |
− | <div class="navbar navbar-default"> | + | <div class="navbar navbar-default navbar-light navbar-expand-sm"> |
<div class="container-fluid"> | <div class="container-fluid"> | ||
<div class="navbar-header"><btn class="navbar-brand">navbar-brand</btn></div> | <div class="navbar-header"><btn class="navbar-brand">navbar-brand</btn></div> | ||
− | <ul class=" | + | <div class="navbar-collapse collapse> |
− | <btn wrapper="li" wrapperclass="" class=""> | + | <ul class="navbar-nav mr-auto" style="margin:0"> |
+ | <btn wrapper="li" wrapperclass="nav-item" class="nav-link"> | ||
navbar-left | navbar-left | ||
*navbar-left | *navbar-left | ||
</btn> | </btn> | ||
</ul> | </ul> | ||
− | <ul class=" | + | <ul class="navbar-nav" style="margin:0"> |
− | <btn wrapper="li" wrapperclass="" class=""> | + | <btn wrapper="li" wrapperclass="nav-item" class="nav-link"> |
navbar-right | navbar-right | ||
*navbar-right | *navbar-right | ||
Line 42: | Line 48: | ||
</btn> | </btn> | ||
</ul> | </ul> | ||
+ | </div> | ||
</div> | </div> | ||
</div> | </div> | ||
Line 54: | Line 61: | ||
<ul class="nav nav-pills"> | <ul class="nav nav-pills"> | ||
− | <btn class="" wrapper="li" wrapperclass=" | + | <btn class="nav-link active" wrapper="li" wrapperclass="nav-item"> |
#|Link | #|Link | ||
</btn> | </btn> | ||
− | <btn class="" wrapper="li" wrapperclass=""> | + | <btn class="nav-link" wrapper="li" wrapperclass="nav-item"> |
#|Link | #|Link | ||
Link | Link | ||
Line 68: | Line 75: | ||
<ul class="nav nav-tabs"> | <ul class="nav nav-tabs"> | ||
− | <btn class="" wrapper="li" wrapperclass=" | + | <btn class="nav-link active" wrapper="li" wrapperclass="nav-item"> |
#|Link | #|Link | ||
</btn> | </btn> | ||
− | <btn class="" wrapper="li" wrapperclass=""> | + | <btn class="nav-link" wrapper="li" wrapperclass="nav-item"> |
#|Link | #|Link | ||
Link | Link | ||
Line 79: | Line 86: | ||
|- | |- | ||
− | !<span class="fa fa-cubes"></span> sidebar | + | !<span class="fa fa-cubes"></span> sidebar-left |
| | | | ||
Line 85: | Line 92: | ||
|- | |- | ||
− | !<span class="fa fa-cubes"></span> sidebar | + | !<span class="fa fa-cubes"></span> sidebar-right |
| | | | ||
Line 94: | Line 101: | ||
| | | | ||
− | + | The footer is fully customizable. See [[Footer Examples]] for an overview. It's default contents are | |
+ | * <code>footer-info</code> („This page was last modified at … by …“, „This page was viewed … times“), | ||
+ | * <code>footer-places</code> (Privacy policy, About, Disclaimers), | ||
+ | * <code>footer-custom</code>, and | ||
+ | * <code>footer-icons</code> (MediaWiki etc.). | ||
|} | |} | ||
Line 106: | Line 117: | ||
|footer-info | |footer-info | ||
| | | | ||
− | footer-info-lastmod, footer-info-viewcount | + | <code>footer-info-lastmod</code>, <code>footer-info-viewcount</code> |
|- | |- | ||
|footer-places | |footer-places | ||
| | | | ||
− | footer-places-privacy, footer-places-about, footer-places-disclaimer | + | <code>footer-places-privacy</code>, <code>footer-places-about</code>, <code>footer-places-disclaimer</code> |
+ | |- | ||
+ | |footer-custom | ||
+ | | | ||
+ | fully customizable via [[MediaWiki:Tweeki-footer-custom]] – Shows a login link by default and is hidden for logged-in users. | ||
|- | |- | ||
|footer-icons | |footer-icons | ||
| | | | ||
− | footer-poweredbyico | + | <code>footer-poweredbyico</code> |
|} | |} | ||
=== Navigational Elements === | === Navigational Elements === | ||
− | These are some standard building blocks for the navigation. Use these elements to define content for the navigational sections above and add your own custom items using [[Buttons|button markup]]. You can also define your own building blocks, so called [[Configuration_Options#Special_Navigational_Elements|Special Navigational Elements]]. | + | These are some standard building blocks for the navigation. Use these elements to define content for the navigational sections above and add your own custom items using [[Buttons|button markup]]. You can also define your own building blocks, so called [[Configuration_Options#Special_Navigational_Elements|Special Navigational Elements]]. |
+ | |||
+ | And you can always link to internal or external pages or build semantic dropdowns using [[Buttons|Tweeki's Button syntax]]. | ||
{| class="table table-bordered" | {| class="table table-bordered" | ||
! style="min-width:150px" | <span class="fa fa-cube"></span> EDIT | ! style="min-width:150px" | <span class="fa fa-cube"></span> EDIT | ||
| | | | ||
− | <btn icon=" | + | <btn icon="pen" class="btn-primary"> |
#|Edit | #|Edit | ||
</btn> | </btn> | ||
Line 134: | Line 151: | ||
| | | | ||
<btn class="btn-primary"> | <btn class="btn-primary"> | ||
− | #|<span class=" | + | #|<span class="fa fa-pen"></span> Edit |
*#|History | *#|History | ||
* | * | ||
Line 142: | Line 159: | ||
*#|Move | *#|Move | ||
*#|Delete | *#|Delete | ||
− | </btn> <span class="fa fa-arrows-h"></span> <btn icon=" | + | </btn> <span class="fa fa-arrows-alt-h mr-2"></span> <btn icon="pen" class="btn-primary"> |
#|Edit | #|Edit | ||
</btn> | </btn> | ||
A split dropdown with "Edit Page" and the other ACTIONS in the dropdown menu. For users or contexts in which <code>EDIT-EXT-special</code> is hidden via configuration setting, hook or parser function the button will be reduced to the appearance of EDIT. | A split dropdown with "Edit Page" and the other ACTIONS in the dropdown menu. For users or contexts in which <code>EDIT-EXT-special</code> is hidden via configuration setting, hook or parser function the button will be reduced to the appearance of EDIT. | ||
+ | |||
+ | ''Note that the standard configuration hides EDIT-EXT for users who don't explicitly opt in to see „advanced features“ (see the [[Configuration_Options#Hiding_Page_Elements|$wgTweekiSkinHideNonAdvanced]] configuration parameter).'' | ||
+ | |||
+ | ''Also note: in order to completely hide the edit button for non-advanced users (e.g. anonymous users) you have to use <code>EDIT-EXT</code> in the respective parser function or configuration option.'' | ||
|- | |- | ||
! <span class="fa fa-cube"></span> TALK | ! <span class="fa fa-cube"></span> TALK | ||
| | | | ||
− | <btn> | + | <btn icon="comments"> |
Talk | Talk | ||
− | </btn> <span class="fa fa-arrows-h"></span> <btn> | + | </btn> <span class="fa fa-arrows-alt-h mr-2"></span> <btn> |
Page | Page | ||
</btn> | </btn> | ||
− | A link to the talk page or the | + | A link to the talk page or the page itself if you already are on it's talk page. |
|- | |- | ||
Line 170: | Line 191: | ||
</btn> | </btn> | ||
The tools (depending on context): page information, special pages, upload file, related changes, what links here | The tools (depending on context): page information, special pages, upload file, related changes, what links here | ||
+ | |- | ||
+ | ! <span class="fa fa-cube"></span> TOOLBOX-EXT | ||
+ | | | ||
+ | <btn> | ||
+ | Tools | ||
+ | *Page information | ||
+ | *Special pages | ||
+ | *Upload file | ||
+ | *Related changes | ||
+ | *What links here | ||
+ | * | ||
+ | *Recent changes | ||
+ | </btn> | ||
+ | The tools (depending on context): page information, special pages, upload file, related changes, what links here PLUS recent changes (for the whole site) | ||
|- | |- | ||
! <span class="fa fa-cube"></span> VIEWS | ! <span class="fa fa-cube"></span> VIEWS | ||
Line 180: | Line 215: | ||
</btn> | </btn> | ||
MediaWiki standard views: read, edit, history. | MediaWiki standard views: read, edit, history. | ||
+ | |||
+ | |- | ||
+ | ! <span class="fa fa-cube"></span> HISTORY | ||
+ | | | ||
+ | <btn icon="history"> | ||
+ | History | ||
+ | </btn> <span class="fa fa-arrows-alt-h mr-2"></span> <btn> | ||
+ | Page | ||
+ | </btn> | ||
+ | A link to the page history or the page itself if you already are on the history page. | ||
+ | |||
|- | |- | ||
Line 192: | Line 238: | ||
</btn> | </btn> | ||
MediaWiki standard actions like purge, watch, move, delete. | MediaWiki standard actions like purge, watch, move, delete. | ||
+ | |||
+ | |- | ||
+ | ! <span class="fa fa-cube"></span> WATCH | ||
+ | | | ||
+ | <btn> | ||
+ | {{FULLPAGENAME}}?action=watch|Watch | ||
+ | </btn> | ||
+ | Link to watch/unwatch page. | ||
+ | |||
+ | |- | ||
+ | ! <span class="fa fa-cube"></span> ICONWATCH | ||
+ | | | ||
+ | [[{{FULLPAGENAME}}|<span class="fa fa-star"></span>]] | ||
+ | |||
+ | Icon to watch/unwatch page. | ||
+ | |||
+ | ''Note that the [[Configuration_Options#Use Star Icon for Watchlist|$wgTweekiSkinUseIconWatch]] configuration parameter has to be set to true for this to work.'' | ||
|- | |- | ||
Line 198: | Line 261: | ||
<btn> | <btn> | ||
Log in | Log in | ||
− | </btn> <span class="fa fa-arrows-h"></span> <btn> | + | </btn> <span class="fa fa-arrows-alt-h mr-2"></span> <btn> |
− | #|<span class=" | + | #|<span class="fa fa-user"></span> User |
*User | *User | ||
*Discussion | *Discussion | ||
Line 209: | Line 272: | ||
A link to the log in form for anonymous users, a dropdown with the personal tools if already logged in. | A link to the log in form for anonymous users, a dropdown with the personal tools if already logged in. | ||
+ | ''Note: PERSONAL by default is hidden via configuration settings. If you want the link to the log in form to show up, you need to add the following line to LocalSettings.php:<br> <code>$wgTweekiSkinHideAnon['PERSONAL'] = false;</code>'' | ||
|- | |- | ||
! <span class="fa fa-cube"></span> PERSONAL-EXT | ! <span class="fa fa-cube"></span> PERSONAL-EXT | ||
Line 256: | Line 320: | ||
| | | | ||
the Logo as set via <code>$wgLogo</code> in LocalSettings.php. Use <code>#p-logo</code> to adapt the styling. | the Logo as set via <code>$wgLogo</code> in LocalSettings.php. Use <code>#p-logo</code> to adapt the styling. | ||
+ | |||
+ | ''Note: This is to place the logo in one of the navigational sections. To put a logo in <code>navbar-brand</code> follow the [[How-Tos#Logo|How-To]].'' | ||
|} | |} |
Latest revision as of 18:20, 7 September 2023
see also Navigation examples
You can change the content of these via system messages and control the visibility via the {{#tweekihide:}}
parser function and configuration options.
Example: If you want to change the content of the right sidebar edit MediaWiki:tweeki-sidebar-right.
navbar | ||
sidebar- left |
subnav | sidebar- right |
main content (including firstHeading) | ||
footer |
navbar |
The main navigation on the top of the page. In this demo installation it is hidden for anonymous users. It can scroll with the page or it can be fixed and always visible (configure it via MediaWiki:Tweeki-navbar-class). It consists of three parts whose contents can be changed via system messages: |
---|---|
subnav |
The subnavigation, using Bootstrap's Pills
|
sidebar-left |
The left sidebar is empty by default. |
sidebar-right |
The right sidebar contains the edit button and the table of contents by default. |
footer |
The footer is fully customizable. See Footer Examples for an overview. It's default contents are
|
firstHeading |
This element's content can not be changed directly but it can be hidden on certain pages or for certain users. |
footer-info |
|
footer-places |
|
footer-custom |
fully customizable via MediaWiki:Tweeki-footer-custom – Shows a login link by default and is hidden for logged-in users. |
footer-icons |
|
These are some standard building blocks for the navigation. Use these elements to define content for the navigational sections above and add your own custom items using button markup. You can also define your own building blocks, so called Special Navigational Elements.
And you can always link to internal or external pages or build semantic dropdowns using Tweeki's Button syntax.
EDIT |
A simple "Edit" button for the current page |
---|---|
EDIT-EXT |
A split dropdown with "Edit Page" and the other ACTIONS in the dropdown menu. For users or contexts in which Note that the standard configuration hides EDIT-EXT for users who don't explicitly opt in to see „advanced features“ (see the $wgTweekiSkinHideNonAdvanced configuration parameter). Also note: in order to completely hide the edit button for non-advanced users (e.g. anonymous users) you have to use |
TALK |
A link to the talk page or the page itself if you already are on it's talk page. |
TOOLBOX |
The tools (depending on context): page information, special pages, upload file, related changes, what links here |
TOOLBOX-EXT |
The tools (depending on context): page information, special pages, upload file, related changes, what links here PLUS recent changes (for the whole site) |
VIEWS |
MediaWiki standard views: read, edit, history. |
HISTORY |
A link to the page history or the page itself if you already are on the history page.
|
ACTIONS |
MediaWiki standard actions like purge, watch, move, delete. |
WATCH |
Link to watch/unwatch page. |
ICONWATCH |
Icon to watch/unwatch page. Note that the $wgTweekiSkinUseIconWatch configuration parameter has to be set to true for this to work. |
PERSONAL |
A link to the log in form for anonymous users, a dropdown with the personal tools if already logged in. Note: PERSONAL by default is hidden via configuration settings. If you want the link to the log in form to show up, you need to add the following line to LocalSettings.php: |
PERSONAL-EXT |
Same as PERSONAL but using LOGIN-EXT's dropdown. |
LOGIN |
A link to the log in form for anonymous users, empty if already logged in. |
LOGIN-EXT |
A dropdown to allow logging in while staying on the same page. |
SIDEBAR |
The original content of the sidebar for Mediawiki's standard skins as defined in Mediawiki:Sidebar. |
LANGUAGES |
Select different languages if your wiki supports it. |
SEARCH |
The standard search box including autocomplete. |
FIRSTHEADING |
You can place the first heading in any navigational section. Note that you can control the visibility of this element with |
TOC |
Table of contents, if placed in the sidebar it makes use of Bootstrap's scrollspy feature. |
LOGO |
the Logo as set via Note: This is to place the logo in one of the navigational sections. To put a logo in |