Functions:pageMenuGet - Revision history

71.163.185.8: added details and examples for using the anchorTag element

2009-03-10T13:35:47Z

added details and examples for using the anchorTag element

71.163.185.8 at 13:27, 10 March 2009

2009-03-10T13:27:49Z

75.68.162.96: /* Paramaters */

2009-02-04T04:22:35Z

‎Paramaters

Root at 14:11, 21 October 2008

2008-10-21T14:11:16Z

Root: EV::pageMenuGet($menuId=NULL) moved to Functions:pageMenuGet

2008-10-02T14:49:29Z

EV::pageMenuGet($menuId=NULL) moved to Functions:pageMenuGet

Root at 15:55, 1 October 2008

2008-10-01T15:55:23Z

Root at 15:29, 1 October 2008

2008-10-01T15:29:41Z

Root at 15:29, 1 October 2008

2008-10-01T15:29:07Z

Root at 15:28, 1 October 2008

2008-10-01T15:28:35Z

Root: New page: == Description == eV::pageMenuGet() retrieves site menu data for use in displaying menus in page template management. == Syntax == $array = eV::pageMenuGet([$menuId]); == Paramaters == ...

2008-10-01T15:27:39Z

New page: == Description == eV::pageMenuGet() retrieves site menu data for use in displaying menus in page template management. == Syntax == $array = eV::pageMenuGet([$menuId]); == Paramaters == ...

New page

== Description ==
eV::pageMenuGet() retrieves site menu data for use in displaying menus in page template management.

== Syntax ==
$array = eV::pageMenuGet([$menuId]);

== Paramaters ==
*$menuId INT (optional)
:: specifies a specific menu to retrieve from the system. If not passed, the menu selected for the current page template will be used. If no menu is specified in the current page template, whichever menu is set as the default menu will be retrieved.

== Return Values ==
Returns a multidimensional array where the first dimension is an associative array for each of the four menu locations (l,r,t,b), the second dimension is an array of the menu item in the location, and the third dimension is an associative array of menu item attributes.
Return array is as follows:

<pre>
Array
(
[l] => Array
(
[0] => Array
(
[location] => String
[id] => Int
[text] => String
[textRaw] => String
[link] => String
[newWindow] => INT
[level] => INT
[target] => String
[display] => Bool
[focus] => Bool
)
[1] => Array
( .. same as above ..)
[2]...
)
[t] => Array
( .. same as above ..)
[b] => Array
( .. same as above ..)
[r] => Array
( .. same as above ..)
)
</pre>

Elements from the menu item associative array are as follows:
{|border=2
|-
|Element
|Description
|Example
|-
|location
|String: Reflects the menu bar location, either 'l' for left, 'r' for right, 't' for top, 'b' for bottom
|r
|-
|id
|Integer: Returns the database unique id for this menu item. Useful to target specific menu items for individual display results or if individual menu items need to be tracked for certain purposes.
|196
|-
|text
|String: The output text of the link. This is what the web site visitors should see as the link. This text is rawurlencoded in the database but rawurldecoded before the value is placed in this element.
|Category X
Specials
Subcategory Y
|-
|textRaw
|String: non-rawurldecoded version of "text"
|Category%20X
Specials
Subcategory%20Y
|-
|link
|String: use as the href value when linking the menu item. It is recommended that you test this element for content before creating the link, so that content managers can leave the content empty for non-linked menu elements (category headers, etc)
|index.php?pageId=125
|http://www.google.com
|-
|newWindow
|Integer: either 1 or 0 to designate if clicking this link should open a new window or place the targetted url in the current window. This element is replaced by the target element.
|1
|-
|level
|Integer: For tiered menus, designates what level of the tier this menu item is on. 0 for the top tier, increasing as the tiers lower. As many designs will have different styles for different tiers in the menu listing (especially for the left menu bar) this is useful to identify the current tier and output the appropriate style.
|2
|-
|target
|String: the actual window the link is targeted towards (_self or _blank). This replaces the newWindow element. Simply place in the 'target' attribute of the href tag.
|_blank
|-
|display
|Boolean: For reactive menus that display elements only as parent elements are selected, this will dignate
(via TRUE or FALSE) if this menu item is slated for display. This will also slate the parent menu item(s) to be displayed when a lower level menu item is selected
|TRUE
|-
|focus
|Boolean: States if this menu item is actually the current page the visitor is on. This is done by URL matching the contents of the 'link' element and the current URL. As some designs call for menu items that are current pages to be styled differently, this will allow identification of such menu items.
|FALSE
|}

== Examples ==
;example 1
example 1 goes here
;example 2
example 2 goes here

== See Also ==
:*[[tag:1|tag 1]]
:*[[tag:2|tag 2]]
:*[[tag:3|tag 3]]

@@ Line 101: / Line 101: @@
 |anchorTag
 |String: A complete anchor tag containing the link, target and text for the link
-|&tl;a href="index.php?pageId=123" target="_self"&gt;Category X&lt;/a&gt;
+|&lt;a href="index.php?pageId=123" target="_self"&gt;Category X&lt;/a&gt;
 |}
@@ Line 115: / Line 115: @@
 // output top menu as a list
 echo "<ul>";
-foreach($arrTopMenu as $menuItem) echo "<li><a href=\"" . $menuItem['link'] . "\" target=\"" . $menuItem['target'] . "\">" . $menuItem['text'] . "</a></li>";
+foreach($arrTopMenu as $menuItem) echo "<li>" . $menuItem['anchorTag'] . "</li>";
 echo "</ul>";
 // output bottom menu as &middot; separated links
 $tempArr = Array();
-foreach($arrBottomMenu as $menuItem) $tempArr[] = "<a href=\"" . $menuItem['link'] . "\" target=\"" . $menuItem['target'] . "\">" . $menuItem['text'] . "</a>";
+foreach($arrBottomMenu as $menuItem) $tempArr[] = "<a href=\"" . $menuItem['link'] . "\" target=\"" . $menuItem['target'] . "\" class=\"someCSSclass\">" . $menuItem['text'] . "</a>";
 echo implode(" &middot; ", $tempArr);

← Older revision		Revision as of 14:11, 21 October 2008
Line 1:		Line 1:
		+	{{Page Template Functions Shortcuts}}
	== Description ==		== Description ==
	eV::pageMenuGet() retrieves site menu data for use in displaying menus in page template management.		eV::pageMenuGet() retrieves site menu data for use in displaying menus in page template management.

@@ Line 66: / Line 66: @@
 |-
 |textRaw
-|String: non-rawurldecoded version of "text"
+|String: non-rawurldecoded version of "text" used for debugging.
 |Category%20X<br>
 Specials<br>
@@ Line 99: / Line 99: @@
 == Examples ==
-;example 1
+;Simple listed menu output for the top and bottom menu
-example 1 goes here
+<source lang="php">
-;example 2
+// get the menus
-example 2 goes here
+$arrMenus = eV::pageMenuGet();
-== See Also ==
+// shortcut the applicable menus
-:*[[tag:1|tag 1]]
+$arrTopMenu = $arrMenus['t'];
-:*[[tag:2|tag 2]]
+$arrBottomMenu = $arrMenus['b'];
-:*[[tag:3|tag 3]]

@@ Line 31: / Line 31: @@
                          [display] => Bool
                          [focus] => Bool
+                 )
              [1] => Array
@@ Line 97: / Line 98: @@
 |Boolean: States if this menu item is actually the current page the visitor is on. This is done by URL matching the contents of the 'link' element and the current URL. As some designs call for menu items that are current pages to be styled differently, this will allow identification of such menu items.
 |FALSE
 |}

@@ Line 6: / Line 6: @@
 $array = eV::pageMenuGet([$menuId]);
-== Paramaters ==
+== Parameters ==
 *$menuId INT (optional)
 :: specifies a specific menu to retrieve from the system. If not passed, the menu selected for the current page template will be used. If no menu is specified in the current page template, whichever menu is set as the default menu will be retrieved.

← Older revision	Revision as of 14:49, 2 October 2008
(No difference)

@@ Line 74: / Line 74: @@
 |String: use as the href value when linking the menu item. It is recommended that you test this element for content before creating the link, so that content managers can leave the content empty for non-linked menu elements (category headers, etc)
 |index.php?pageId=125
-|http://www.google.com
+http://www.google.com
 |-
 |newWindow