Processwire Module: MarkupSimpleNavigation - Versionsgeschichte

149.172.225.28: /* Selektoren und Filter */

2018-02-27T08:22:13Z

Selektoren und Filter

149.172.225.28: /* More Examples */

2018-02-26T18:46:14Z

More Examples

149.172.225.28 am 26. Februar 2018 um 11:02 Uhr

2018-02-26T11:02:54Z

149.172.225.28 am 26. Februar 2018 um 10:54 Uhr

2018-02-26T10:54:31Z

Steff: /* Quickstart */

2017-04-25T05:34:07Z

Quickstart

Steff am 25. April 2017 um 05:32 Uhr

2017-04-25T05:32:36Z

Steff: /* Quickstart */

2017-04-19T18:47:35Z

Quickstart

37.49.32.84: Die Seite wurde neu angelegt: „== MarkupSimpleNavigation == Bekanntestes Navigation Modul http://modules.processwire.com/modules/markup-simple-navigation/ == Quickstart ==

 $treeMenu =…“

2017-01-16T15:58:24Z

Die Seite wurde neu angelegt: „== MarkupSimpleNavigation == Bekanntestes Navigation Modul http://modules.processwire.com/modules/markup-simple-navigation/ == Quickstart == <pre> $treeMenu =…“

Neue Seite

== MarkupSimpleNavigation ==
Bekanntestes Navigation Modul http://modules.processwire.com/modules/markup-simple-navigation/
== Quickstart ==
<pre>
$treeMenu = $modules->get("MarkupSimpleNavigation"); // load the module
echo $treeMenu->render(); // render default menu
</pre>
Wobei die render Funktion einige Optionen erlaubt.

== Funktionen und Anwendung ==
render($options, $page, $rootPage)
* $options, is an array of options
* $page, is a page object for the current page
* $rootPage, is a page object for the root of the menu

=== Default options ===
<syntaxhighlight lang="php">
$options = array(
'parent_class' => 'parent',
'current_class' => 'current',
'has_children_class' => 'has_children',
'levels' => true,
'levels_prefix' => 'level-',
'max_levels' => null,
'firstlast' => false,
'collapsed' => false,
'show_root' => false,
'selector' => '',
'selector_field' => 'nav_selector',
'outer_tpl' => '<ul>||</ul>',
'inner_tpl' => '<ul>||</ul>',
'list_tpl' => '<li%s>||</li>',
'list_field_class' => '',
'item_tpl' => '<a href="{url}">{title}</a>',
'item_current_tpl' => '<a href="{url}">{title}</a>',
'xtemplates' => '',
'xitem_tpl' => '<a href="{url}">{title}</a>',
'xitem_current_tpl' => '<span>{title}</span>',
'date_format' => 'Y/m/d',
'code_formatting' => false,
'debug' => false
);
echo $treeMenu->render($options);
</syntaxhighlight>
Same with comments
<syntaxhighlight lang="php">
$options = array(
'parent_class' => 'parent',
// overwrite class name for current parent levels

'current_class' => 'current',
// overwrite current class

'has_children_class' => 'has_children',
// overwrite class name for entries with children

'levels' => true,
// wether to output "level-1, level-2, ..." as css class in links

'levels_prefix' => 'level-',
// prefix string that will be used for level class

'max_levels' => null,
// set the max level rendered

'firstlast' => false,
// puts last,first class to link items

'collapsed' => false,
// if you want to auto-collapse the tree you set this to true

'show_root' => false,
// set this to true if you want to rootPage to get prepended to the menu

'selector' => '',
// define custom PW selector, you may sanitize values from user input

'selector_field' => 'nav_selector',
// string (default 'nav_selector') define custom PW selector by using a property or field on a page. Use this setting if you want to overwrite the default nav_selector

'outer_tpl' => '<ul>||</ul>',
// template string for the outer most wrapper. || will contain entries

'inner_tpl' => '<ul>||</ul>',
// template string for inner wrappers. || will contain entries

'list_tpl' => '<li%s>||</li>',
// template string for the items. || will contain entries, %s will replaced with class="..." string

'list_field_class' => '', // string (default '') add custom classes to each list_tpl using tags like {field} i.e. {template} p_{id}

'item_tpl' => '<a href="{url}">{title}</a>',
// template string for the inner items. Use {anyfield} and {url}, i.e. {headline|title}, if field is of type image it will return url to image (first image if multiple)

'item_current_tpl' => '<a href="{url}">{title}</a>',
// template string for the active inner items.

'xtemplates' => '',
// specify one or more templates separated with a pipe | to use the xitem_tpl and xitem_current_tpl markup

'xitem_tpl' => '<a href="{url}">{title}</a>',
// same as 'item_tpl' but for xtemplates pages, can be used to define placeholders

'xitem_current_tpl' => '<span>{title}</span>',
// same as 'item_current_tpl' but for xtemplates pages

'date_format' => 'Y/m/d',
// default date formatting for Datetime fields and native created/modified

'code_formatting' => false,
// enable or disable code indentations and newslines in markup output

'debug' => false,
// show some inline information about rendertime and selectors used as html comments

);
echo $treeMenu->render($options);
</syntaxhighlight>

← Nächstältere Version		Version vom 27. Februar 2018, 08:22 Uhr
Zeile 215:		Zeile 215:
	echo $nav->render($options);		echo $nav->render($options);
	</pre>		</pre>
		+
		+	==== Beispiel - Menüauswahl ====
		+	Todo Funktionalität genauer checken
		+	<syntaxhighlight lang="php">
		+	$treeMenu = $modules->get("MarkupSimpleNavigation"); // load the module
		+	$homepage->my_selector = "menus.id=1";
		+	$options = array(
		+	//...
		+	'max_levels' => 3,
		+	'show_root' => true,
		+	'selector' => '',
		+	'selector_field' => 'my_selector',
		+	'selector_level2' => 'menus.id=1',
		+	'selector_level3' => 'menus.id=1',
		+	'selector_level4' => 'menus.id=1'
		+
		+	);
		+	$menu = $treeMenu->render($options);
		+	</syntaxhighlight>

@@ Zeile 183: / Zeile 183: @@
   $rootPage = $pages->get("/en/");
   echo $treeMenu->render(null, $currentPage, $rootPage);
 '''Build a menu using a PageArray instead of a single root page'''
@@ Zeile 191: / Zeile 194: @@
   $entries = $pages->get("/")->navigation_entries;
   echo $treeMenu->render(null, null, $entries);
-=== Variable im Template ===
   'inner_tpl' => "<ul id='{name}' class='drop-down'>||</ul>",
 === Selektoren und Filter ===
 Man kann die Menüpunkte z.B. anhand von einem Backend-Feld oder Templates Filtern. Man kann sogar für einzelne Level Filter vergeben.

← Nächstältere Version		Version vom 26. Februar 2018, 11:02 Uhr
Zeile 191:		Zeile 191:
	$entries = $pages->get("/")->navigation_entries;		$entries = $pages->get("/")->navigation_entries;
	echo $treeMenu->render(null, null, $entries);		echo $treeMenu->render(null, null, $entries);
		+	=== Variable im Template ===
		+	'inner_tpl' => "<ul id='{name}' class='drop-down'>\|\|</ul>",
		+	=== Selektoren und Filter ===
		+	Man kann die Menüpunkte z.B. anhand von einem Backend-Feld oder Templates Filtern. Man kann sogar für einzelne Level Filter vergeben.
		+
		+	<pre>
		+	$pages->get(1001)->my_selector = "template=projects";
		+
		+	$options = array(
		+	"selector_level1" => "template=ressort",
		+	"selector_level2" => "start=0, limit=10",
		+	"selector_level3" => "template=news\|events, sort=-created",
		+	"selector_field" => "my_selector"
		+	);
		+
		+	echo $nav->render($options);
		+	</pre>

← Nächstältere Version		Version vom 26. Februar 2018, 10:54 Uhr
Zeile 170:		Zeile 170:
	echo $treeMenu->render($options);		echo $treeMenu->render($options);
	</syntaxhighlight>		</syntaxhighlight>
		+	== More Examples ==
		+	=== Aktive Seite oder Root Seite überschreiben ===
		+
		+	If you want to overwrite starting point for the root page to be another page you could do it like this:
		+
		+	$rootPage = $pages->get("/en/"); // or any other page that has subpages
		+	echo $treeMenu->render(null, null, $rootPage); // null at first is to not have to specify options, just use default
		+
		+	'''Or to even overwrite the current active page'''
		+
		+	$currentPage = $pages->get(1242);
		+	$rootPage = $pages->get("/en/");
		+	echo $treeMenu->render(null, $currentPage, $rootPage);
		+
		+	'''Build a menu using a PageArray instead of a single root page'''
		+
		+	Define a PageArray as the root page argument. Instead of a root it will take the PageArray as the first level entries. This can be used to '''build a menu from a page select field for example'''.
		+
		+	Assuming you have a page field "navigation_entries" on your home root page:
		+	$entries = $pages->get("/")->navigation_entries;
		+	echo $treeMenu->render(null, null, $entries);

@@ Zeile 7: / Zeile 7: @@
 // needs Plugin MarkupSimpleNavigation
 // use $treeMenu = $modules->get("MarkupSimpleNavigation");
-// load module in _init.php or here...
+// load module in _init.php or heren like...
 $treeMenu = $modules->get("MarkupSimpleNavigation");
 $options = array(
@@ Zeile 17: / Zeile 17: @@
      'max_levels' => null,
      'firstlast' => false,
-     'collapsed' => false,
+     'collapsed' => true,
      'show_root' => true,
      'selector' => '',

← Nächstältere Version		Version vom 25. April 2017, 05:32 Uhr
Zeile 48:		Zeile 48:

	</syntaxhighlight>		</syntaxhighlight>
		+
		+	== Nur einen Level rendern ==
		+	Top root menu
		+	<pre>
		+	// default root is "/"
		+	echo $treeMenu->render(array("max_levels" => 1));
		+	</pre>
		+	Submenu
		+	<pre>
		+	$root = $page->rootParent; // top root parent of current page
		+	echo $treeMenu->render(array("max_levels" => 1), null, $root);
		+	</pre>

	== Funktionen und Anwendung ==		== Funktionen und Anwendung ==

@@ Zeile 2: / Zeile 2: @@
 Bekanntestes Navigation Modul http://modules.processwire.com/modules/markup-simple-navigation/
 == Quickstart ==
-<pre>
+nav-simpleTreeMenu.inc
-$treeMenu = $modules->get("MarkupSimpleNavigation"); // load the module
+<syntaxhighlight lang="php">
-echo $treeMenu->render(); // render default menu
+<?php namespace ProcessWire;
-</pre>
+// needs Plugin MarkupSimpleNavigation
-Wobei die render Funktion einige Optionen erlaubt.
+// use $treeMenu = $modules->get("MarkupSimpleNavigation");
 == Funktionen und Anwendung ==