Revision history for WikkaMenus


Revision [2300]

Last edited on 2012-05-20 00:44:11 by BrianKoontz [minor typo]
Additions:
{{image src="http://docs.wikkawiki.org/WikkaMenus/files.xml?action=download&file=options_menu_admin_inc.png"}}
Deletions:
{{image src="http://docs.wikkawiki.org/WikkaMenus/files.xml?action=download&file=option_menu_admin_inc.png"}}

Revision [2299]

Edited on 2012-05-20 00:43:09 by BrianKoontz [added screenshots]
Additions:
Generated navlinks in header for administrators (right below the page title):
{{image src="http://docs.wikkawiki.org/WikkaMenus/files.xml?action=download&file=main_menu_admin_inc.png"}}
Generate action links in footer for administrators only:
{{image src="http://docs.wikkawiki.org/WikkaMenus/files.xml?action=download&file=option_menu_admin_inc.png"}}
Deletions:
Generated navlinks in header for administrators (right below the page title).
Generate action links in footer for administrators only.

Revision [2298]

Edited on 2012-05-20 00:38:31 by BrianKoontz [added new menus as of 1.3]
Additions:
{{since version="1.2" display="inline"}}
{{image src="http://docs.wikkawiki.org/WikkaMenus/files.xml?action=download&file=dashboard_admin_inc.png"}}
===main_menu.admin.inc===
Generated navlinks in header for administrators (right below the page title).
[[UserSettings | Settings]]
You are {{whoami}}
{{logout}}
===main_menu.user.inc===
Generated navlinks in header for non-admin users (right below the page title).
[[UserSettings | Settings]]
You are {{whoami}}
{{logout}}
Generate navlinks for anonymous users (right below the page title).
===options_menu.admin.inc===
Generate action links in footer for administrators only.
{{revertlink}}
{{deletelink}}
{{clonelink}}
{{referrerslink}}
===options_menu.user.inc===
Generate action links in footer for non-admin users.
{{clonelink}}
Generate action links in footer for anonymous users.
Deletions:
{{since version "1.2" display="inline"}}

Revision [2297]

Edited on 2012-05-20 00:31:56 by BrianKoontz [added new menus]
Additions:
{{since version="1.2" display="inline"}}By default two menu templates are bundled with Wikka, ##main_menu## and ##options_menu##.
{{since version="1.3" display="inline"}}Several new menu templates have been added (see below).
{{since version "1.2" display="inline"}}
{{since version="1.3" display="inline"}}
===dashboard.admin.inc===
This menu generates an admin toolbar in the upper right corner, visible to administrators only:
AdminUsers
AdminPages
SysInfo
WikkaConfig
{{files}}
Deletions:
By default two menu templates are bundled with Wikka, ##main_menu## and ##options_menu##.

Revision [2095]

Edited on 2009-09-02 11:43:31 by DarTar [legacy menu settings]
Additions:
==== Legacy navigation links (Wikka 1.1.X) ====
Before Wikka 1.2, menu settings were stored in the [[ConfigurationOptions | config file]] as ##navigation_links## and ##logged_in_navigation_links##. As of 1.2 these settings are obsolete: when [[Installing12 | upgrading to 1.2]], the installer will attempt to parse the existing menu configuration and write it to the corresponding menu template files. The server must have write access to the ##config/## folder to be able to perform this operation.

Revision [2087]

Edited on 2009-09-02 09:34:54 by DarTar [menu templates docs]
Additions:
Wikka [[WhatsNew12 | 1.2]] introduces support for **menu templates** as part of its new [[WikkaMenus | theme functionality]]. Menu template files can contain any kind of text, [[UsingActions | actions]] (including [[InstallingPlugins | custom ones]]) or [[FormattingRules | wiki markup]] and are stored in the ##config/## directory. Different menu items are separated by a new line.
**Menu widgets** (or "[[Menulets | menulets]]") are the most obvious candidates to add content to menu templates. ##""{{homepagelink}}""##, for example, creates a link to the wiki's homepage, ##""{{editlink}}""## creates a link to edit the current page (if the user has sufficient privileges to do so) and so on.
By default two menu templates are bundled with Wikka, ##main_menu## and ##options_menu##.
====Default menu templates====
===main_menu.inc===
##main_menu## controls the content of the main navigation bar, with links to the most important pages and functionality of the wiki.
%%
[[CategoryCategory | Categories]]
PageIndex
RecentChanges
RecentlyCommented
[[UserSettings | Login/Register]]
Your hostname is {{whoami}}
{{searchform}}
%%
===options_menu.inc===
##options_menu## controls the content of the footer toolbar, with links to a variety of [[HandlerInfo | handlers]].
%%
{{editlink}}
{{historylink}}
{{revisionlink}}
{{ownerlink}}
%%
==== ACL and menu templates ====
Menu template files containing the ##.user## and ##.admin## suffix are loaded when the current user is a registered user or an admin, respectively.
This allows you to control the different kinds of content displayed to different users as a function of their [[ACLInfo | privileges]].
==== Creating custom menus ====
You can create an unlimited number of custom menus and navigation bars by storing the corresponding templates in the ##config/## folder. Menu templates are loaded via the ##""MakeMenu()""## method. ##""MakeMenu()""## takes as an argument the name of the template file (without suffixes), e.g.:
%%(php;59;templates/default/header.php)
<?php echo $this->MakeMenu('main_menu'); ?>
%%
##""MakeMenu()""## automatically takes care of displaying the correct template files as a function of the privileges of the current user, so you don't need to use an [[ACLInfo | ACL]] test when using it in a theme. The output of ##""MakeMenu()""## is an unordered list using the menu template name as an ##id## (which can be used to style/position the menu via the stylesheet), e.g.:
%%(html4strict)
<ul id="main_menu">
<li><a class="" href="http://testme/wikka/1.2/wikka.php?wakka=CategoryCategory">Categories</a></li>
<li><a class="" href="http://testme/wikka/1.2/wikka.php?wakka=PageIndex">PageIndex</a></li>
<li><a class="" href="http://testme/wikka/1.2/wikka.php?wakka=RecentChanges">RecentChanges</a></li>
<li><a class="" href="http://testme/wikka/1.2/wikka.php?wakka=RecentlyCommented">RecentlyCommented</a></li>
<li><a class="" href="http://testme/wikka/1.2/wikka.php?wakka=UserSettings">Login/Register</a></li>
<li>Your hostname is <tt>wakka</tt></li>
<li><form action="http://testme/wikka/1.2/wikka.php?wakka=TextSearch" id="form_c2b696fff2">
<fieldset class="hidden">
<input type="hidden" name="wakka" value="TextSearch" />
</fieldset>
<label for="searchbox">Search: </label><input id="searchbox" name="phrase" size="15" class="searchbox" /></form>
</li>
</ul>
%%
Deletions:
//The documentation for this new feature will be uploaded soon//

Revision [2082]

Edited on 2009-09-02 06:22:13 by DarTar [links]
Additions:
~- [[WikkaThemes | Installing themes]]
~- [[Menulets | Menu widgets]]
Deletions:
~- [[Menulets | Menu template widgets]]

Revision [2066]

Edited on 2009-09-02 03:34:43 by DarTar [coming soon]
Additions:
//The documentation for this new feature will be uploaded soon//

Revision [2023]

Edited on 2009-08-19 06:59:55 by DarTar [stub]
Additions:
=====Menu Template Files=====
>>==See also:==
~- [[Menulets | Menu template widgets]]
>>{{since version="1.2" align="left"}}::c::

----
CategoryEN
Deletions:
(stub)

Revision [2013]

The oldest known version of this page was created on 2009-08-19 04:33:38 by DarTar [stub]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki