Edit Navigation lets you add and edit what are essentially 'menu templates' -- they define which pages' Menu Names should be included in a menu, optionally based on where that menu appears.
+The Add/Edit Navigation form allows you to do choose the set of pages, and to choose which +template is used to create the menu.
+Identifier
This is the (unique) label you will later use to specify this Navigation definition in a ^Navigation(); macro.
Base Page
This identifies the spot in the Page Tree where the macro should commence listing pages. The first three choices will create 'absolute' menus -- ones which will display the same pages no matter which page you use the macro from.
The next four create 'relative' menus -- ones in which the items which will be displayed depend on the location in the page tree of the page in which you use the macro.
+Use the 'Add new value' option if you want to specify a custom starting page. You can refer to a starting page by its urlized title or its pageId.
+Return a Loop With
This determines which pages relative to the base page will be included in the menu which the macro creates.
Stop traversing when reaching level
This allows you to prune a menu -- in either direction -- when it reaches a specific level in the page tree. It's slightly different in effect than...
Max Depth
...which allows you to prune a menu -- in either direction -- when it reaches a number of levels in the page tree. 'Stop Traversing' is absolute; 'Max Depth' is relative. Presumably, if you set both, whichever one takes effect first will be the active limit (that is, they're OR'd together).
Show System Pages
Should the menus the macro creates include System pages such as Trash, Clipboard, Page not found, etc.? If you want Admins or Content Managers to be able to see System Pages, then select Yes and use the Navigation Template to hide them.
Show Hidden Pages
Should the menus include pages which are marked as Hidden? Similar to
+System Pages, if you want certain groups to be able to see Hidden Pages, then select Yes and use
+the Navigation Template to determine who can see them in the menu.
Show Unpriviliged Pages
Should the menus the macro creates include pages which the currently logged-in user does not have the privilige to view?
Template
This menu permits you to select a template which is used to style the output created by the macro -- if you need the same collection of pages in multiple formats, you'll need to create multiple Navigation entries with (slightly) different names; the Copy Navigation button is useful for this.
Reverse Output
When this option is switched on, the menu will be in reverse order.
Preview
The Preview button allows you to view a navigation setup without actually saving it.
basepage.menuTitle
The pageId of the base page.
basepage.title
The title of the base page.
basepage.urlizedTitle
The URL of the base page.
basepage.pageId
The pageId of the base page.
basepage.parentId
The parentId of the base page.
basepage.ownerId
The ownerId of the base page.
basepage.synopsis
The synopsis of the base page.
basepage.newWindow
A conditional indicating whether the base page should be opened in a new window.
basepage.encryptLogin
A conditional indicating whether the base page should be served over SSL.
basepage.hasDaughter
A conditional indicating whether the base page has daughters.
page_loop
A loop containing page information in nested, hierarchial order.
unfolded_page_loop
This loop contains the same data as page_loop but the order is different. unfolded_page_loop returns it's pages in an unfolded manner; grouped by parent id. You'll probably need page_loop, but there are (CSS) menus that need unfolded_page_loop to work properly.
Both page_loop and unfolded_page_loop have the following +loop variables:
+++page.menuTitle
+
The menu title of this page.page.title
+
The title of this page.page.urlizedTitle
+
The urlizedTitle of this page.page.url
+
The complete URL to this page.page.pageId
+
The pageId of this page.page.parentId
+
The parentId of this page.page.ownerId
+
The ownerId of this page.page.synopsis
+
The synopsis of this page.page.newWindow
+
A conditional indicating whether this page should be opened in a new window.page.encryptLogin
+
A conditional indicating whether this page should be served over SSL.page.absDepth
+
The absolute depth of this page (relative to nameless root).page.relDepth
+
The relative depth of this page (relative to starting point).page.isHidden
+
A conditional indicating whether this page is a hidden page.
(Note: This variable is only visible if "Show hidden pages" is switched on.)page.isSystem
+
A conditional indicating whether this page is a system page (Trash, Clipboard, etc).
(Note: This variable is only visible if "Show system pages" is switched on.)page.isViewable
+
A conditional indicating whether the user has permission to view it.
(Note: This variable is only visible if "Show unprivileged pages" is switched on.)page.indent
+
A variable containing the indent for the current page. The default indent is three spaces. Use the page.indent_loop if you need a more flexible indent.page.indent_loop
+
A loop that runs page.relDepth times.++indent
A number representing the loop count.page.isRoot
+
A conditional indicating whether this page is a root page.page.isTop
+
A conditional indicating whether this page is a top page (daughter of root).page.inRoot
+
This conditional is true if this page is a descendant of the root page of the base page.page.hasDaughter
+
A conditional indicating whether this page has a daughter. In other words: It evaluates to true if this page is a mother.page.isBasepage
+
A conditional indicating whether this page is the base page.page.isAncestor
+
A conditional indicating whether this page is an ancestor of the base page.page.isDescendent
+
A conditional indicating whether this page is a descendent of the base page.page.isDaughter
+
A conditional indicating whether this page is a daughter of the base page.page.isMother
+
A conditional indicating whether this page is the mother of the base page.page.isSister
+
A conditional indicating whether this page is the sister of the base page.page.inBranch
+
A conditional that is the logical OR of isAncestor, isisSister, isBasepage and isDescendent.page.mother.*
+
These variables will be undefined if the page is a root.page.mother.title
+
The title of the mother of this page.page.mother.urlizedTitle
+
The urlized title of the mother of this page.page.mother.pageId
+
The pageId of the mother of this page.page.mother.parentId
+
The parentId of the mother of this page.page.depthIs1 , page.depthIs2 , page.depthIs3 , page.depthIs4 , page.depthIsN
+
A conditional indicating whether the depth of this page is N. This variable is useful if you want to style a certain level.<tmpl_if page.depthIs1>
+
<img src="level1.gif">
<tmpl_else>
<img src="defaultBullet.gif">
</tmpl_if>page.relativeDepthIs1 , page.relativeDepthIs2 , page.relativeDepthIs3 , page.relativeDepthIsN
+
A conditional indicating whether the relative depth of this page is N.page.isLeftMost
+
This property is true if this page is the first within this level. Ie. has no left sister.page.isRightMost
+
This property is true if this page is the last within this level. Ie. has no right sister.page.depthDiff
+
The difference in depth of this page and the page processed before it. This only has a value when you go up in depth. If you go down, this would be always 1 and going down a level can be detected with page.isLeftMost.page.depthDiffIs1, page.depthDiffIs2, page.depthDiffIs3, page.depthDiffIsN
+
True if the page.depthDiff variable is N.page.depthDiff_loop
A loop that runs page.depthDiff times. This loop contains no loop variables.
|, + lastUpdated => 1097728363 + }, + + '1094' => { + message => q|Navigation, Manage|, + lastUpdated => 1078208044 + }, + + '1095' => { + message => q|
The general idea behind the navigation system is that instead of hardwiring all the various choices you might make into the code, the system manages a 'library' of these styles, just the way it does with Snippets, Images, Templates, Page Styles, and other types of reusable information. You can create a new 'Navgation menu style', give it a name, and then use it anywhere on your site that you like.
+The navigation system consists of two parts:
+To create a new menu for your site, place a ^Navigation(myMenu); macro into a style. An "edit myMenu" link will be displayed if "myMenu" is not defined.
+Note: In this example "myMenu" is used, but you can pick any name, as long as it is unique.
|, + lastUpdated => 1100587054 + }, + }; 1; diff --git a/lib/WebGUI/i18n/English/WebGUI.pm b/lib/WebGUI/i18n/English/WebGUI.pm index b8c32588c..425fd5950 100644 --- a/lib/WebGUI/i18n/English/WebGUI.pm +++ b/lib/WebGUI/i18n/English/WebGUI.pm @@ -3458,11 +3458,6 @@ The translated label for the link to the home page or the text that you supply t lastUpdated => 1036972103 }, - '1098' => { - message => q|Navigation, Add/Edit|, - lastUpdated => 1078208044 - }, - '794' => { message => q|Packages|, lastUpdated => 1036971944 @@ -4805,70 +4800,6 @@ A list of links to the 10 nearest in the paginator relative to the current page. lastUpdated => 1031514049 }, - '1097' => { - message => q|config.buttonbasepage.menuTitle
The pageId of the base page.
basepage.title
The title of the base page.
basepage.urlizedTitle
The URL of the base page.
basepage.pageId
The pageId of the base page.
basepage.parentId
The parentId of the base page.
basepage.ownerId
The ownerId of the base page.
basepage.synopsis
The synopsis of the base page.
basepage.newWindow
A conditional indicating whether the base page should be opened in a new window.
basepage.encryptLogin
A conditional indicating whether the base page should be served over SSL.
basepage.hasDaughter
A conditional indicating whether the base page has daughters.
page_loop
A loop containing page information in nested, hierarchial order.
unfolded_page_loop
This loop contains the same data as page_loop but the order is different. unfolded_page_loop returns it's pages in an unfolded manner; grouped by parent id. You'll probably need page_loop, but there are (CSS) menus that need unfolded_page_loop to work properly.
Both page_loop and unfolded_page_loop have the following -loop variables:
---page.menuTitle
-
The menu title of this page.page.title
-
The title of this page.page.urlizedTitle
-
The urlizedTitle of this page.page.url
-
The complete URL to this page.page.pageId
-
The pageId of this page.page.parentId
-
The parentId of this page.page.ownerId
-
The ownerId of this page.page.synopsis
-
The synopsis of this page.page.newWindow
-
A conditional indicating whether this page should be opened in a new window.page.encryptLogin
-
A conditional indicating whether this page should be served over SSL.page.absDepth
-
The absolute depth of this page (relative to nameless root).page.relDepth
-
The relative depth of this page (relative to starting point).page.isHidden
-
A conditional indicating whether this page is a hidden page.
(Note: This variable is only visible if "Show hidden pages" is switched on.)page.isSystem
-
A conditional indicating whether this page is a system page (Trash, Clipboard, etc).
(Note: This variable is only visible if "Show system pages" is switched on.)page.isViewable
-
A conditional indicating whether the user has permission to view it.
(Note: This variable is only visible if "Show unprivileged pages" is switched on.)page.indent
-
A variable containing the indent for the current page. The default indent is three spaces. Use the page.indent_loop if you need a more flexible indent.page.indent_loop
-
A loop that runs page.relDepth times.--indent
A number representing the loop count.page.isRoot
-
A conditional indicating whether this page is a root page.page.isTop
-
A conditional indicating whether this page is a top page (daughter of root).page.inRoot
-
This conditional is true if this page is a descendant of the root page of the base page.page.hasDaughter
-
A conditional indicating whether this page has a daughter. In other words: It evaluates to true if this page is a mother.page.isBasepage
-
A conditional indicating whether this page is the base page.page.isAncestor
-
A conditional indicating whether this page is an ancestor of the base page.page.isDescendent
-
A conditional indicating whether this page is a descendent of the base page.page.isDaughter
-
A conditional indicating whether this page is a daughter of the base page.page.isMother
-
A conditional indicating whether this page is the mother of the base page.page.isSister
-
A conditional indicating whether this page is the sister of the base page.page.inBranch
-
A conditional that is the logical OR of isAncestor, isisSister, isBasepage and isDescendent.page.mother.*
-
These variables will be undefined if the page is a root.page.mother.title
-
The title of the mother of this page.page.mother.urlizedTitle
-
The urlized title of the mother of this page.page.mother.pageId
-
The pageId of the mother of this page.page.mother.parentId
-
The parentId of the mother of this page.page.depthIs1 , page.depthIs2 , page.depthIs3 , page.depthIs4 , page.depthIsN
-
A conditional indicating whether the depth of this page is N. This variable is useful if you want to style a certain level.<tmpl_if page.depthIs1>
-
<img src="level1.gif">
<tmpl_else>
<img src="defaultBullet.gif">
</tmpl_if>page.relativeDepthIs1 , page.relativeDepthIs2 , page.relativeDepthIs3 , page.relativeDepthIsN
-
A conditional indicating whether the relative depth of this page is N.page.isLeftMost
-
This property is true if this page is the first within this level. Ie. has no left sister.page.isRightMost
-
This property is true if this page is the last within this level. Ie. has no right sister.page.depthDiff
-
The difference in depth of this page and the page processed before it. This only has a value when you go up in depth. If you go down, this would be always 1 and going down a level can be detected with page.isLeftMost.page.depthDiffIs1, page.depthDiffIs2, page.depthDiffIs3, page.depthDiffIsN
-
True if the page.depthDiff variable is N.page.depthDiff_loop
A loop that runs page.depthDiff times. This loop contains no loop variables.
|, - lastUpdated => 1097728363 - }, - '893' => { message => q|Wobject Properties|, lastUpdated => 1046638419 @@ -5373,11 +5304,6 @@ Start typing! Or better yet, copy the snippet from some other electronic documen lastUpdated => 1031514049 }, - '1096' => { - message => q|Navigation Template|, - lastUpdated => 1078207966 - }, - '964' => { message => q|Manage system trash.|, lastUpdated => 1052850265 @@ -5393,40 +5319,6 @@ Start typing! Or better yet, copy the snippet from some other electronic documen lastUpdated => 1050431137 }, - '1093' => { - message => q|
Edit Navigation lets you add and edit what are essentially 'menu templates' -- they define which pages' Menu Names should be included in a menu, optionally based on where that menu appears.
-The Add/Edit Navigation form allows you to do choose the set of pages, and to choose which -template is used to create the menu.
-Identifier
This is the (unique) label you will later use to specify this Navigation definition in a ^Navigation(); macro.
Base Page
This identifies the spot in the Page Tree where the macro should commence listing pages. The first three choices will create 'absolute' menus -- ones which will display the same pages no matter which page you use the macro from.
The next four create 'relative' menus -- ones in which the items which will be displayed depend on the location in the page tree of the page in which you use the macro.
-Use the 'Add new value' option if you want to specify a custom starting page. You can refer to a starting page by its urlized title or its pageId.
-Return a Loop With
This determines which pages relative to the base page will be included in the menu which the macro creates.
Stop traversing when reaching level
This allows you to prune a menu -- in either direction -- when it reaches a specific level in the page tree. It's slightly different in effect than...
Max Depth
...which allows you to prune a menu -- in either direction -- when it reaches a number of levels in the page tree. 'Stop Traversing' is absolute; 'Max Depth' is relative. Presumably, if you set both, whichever one takes effect first will be the active limit (that is, they're OR'd together).
Show System Pages
Should the menus the macro creates include System pages such as Trash, Clipboard, Page not found, etc.? If you want Admins or Content Managers to be able to see System Pages, then select Yes and use the Navigation Template to hide them.
Show Hidden Pages
Should the menus include pages which are marked as Hidden? Similar to
-System Pages, if you want certain groups to be able to see Hidden Pages, then select Yes and use
-the Navigation Template to determine who can see them in the menu.
Show Unpriviliged Pages
Should the menus the macro creates include pages which the currently logged-in user does not have the privilige to view?
Template
This menu permits you to select a template which is used to style the output created by the macro -- if you need the same collection of pages in multiple formats, you'll need to create multiple Navigation entries with (slightly) different names; the Copy Navigation button is useful for this.
Reverse Output
When this option is switched on, the menu will be in reverse order.
Preview
The Preview button allows you to view a navigation setup without actually saving it.
The general idea behind the navigation system is that instead of hardwiring all the various choices you might make into the code, the system manages a 'library' of these styles, just the way it does with Snippets, Images, Templates, Page Styles, and other types of reusable information. You can create a new 'Navgation menu style', give it a name, and then use it anywhere on your site that you like.
-The navigation system consists of two parts:
-To create a new menu for your site, place a ^Navigation(myMenu); macro into a style. An "edit myMenu" link will be displayed if "myMenu" is not defined.
-Note: In this example "myMenu" is used, but you can pick any name, as long as it is unique.
|, - lastUpdated => 1100587054 - }, - '505' => { message => q|Add a new template.|, lastUpdated => 1031514049 @@ -5974,11 +5853,6 @@ Privileges and styles assigned to pages in the package will not be copied when t lastUpdated => 1038871530 }, - '1094' => { - message => q|Navigation, Manage|, - lastUpdated => 1078208044 - }, - '929' => { message => q|Import!|, lastUpdated => 1050265357