Backboneit navigation - Versionsgeschichte

Toflar: Anpassung Version und ER-Link

2011-08-28T11:20:24Z

Anpassung Version und ER-Link

Backbone am 9. August 2011 um 14:54 Uhr

2011-08-09T14:54:24Z

Psi: /* Navigation per Hook erweitern */

2011-08-09T14:47:26Z

‎Navigation per Hook erweitern

Manitougs: Tracker hinzugefügt

2011-07-11T19:40:41Z

Tracker hinzugefügt

Manitougs: Aufbereitung

2011-07-11T18:56:33Z

Aufbereitung

Backbone am 11. Juli 2011 um 14:40 Uhr

2011-07-11T14:40:26Z

Toflar: Hook-Registrierung in config.php korrigiert

2011-07-07T11:31:23Z

Hook-Registrierung in config.php korrigiert

Backbone: Erste Version

2011-07-06T13:03:58Z

Erste Version

Neue Seite

[[Category:Module]]
{{AppliesTo
|Version=Alle Versionen
|Ext1=backboneit_navigation}}

= backboneit_navigation =

Erweiterung bestehend aus einer Sammlung von Navigationselementen (vorerst nur ein erweitertes Navigationsmodul).

ER: http://www.contao.org/erweiterungsliste/view/backboneit_navigation.10000009.de.html

Anmerkungen zum Bestimmen der Sichtbarkeit einer Seite:
* Der Veröffentlichungsstatus gilt ausschließlich für eine Seite selbst. Das heißt zum Beispiel, dass eine Navigation durchaus dargestellt wird, selbst wenn die Referenzseite nicht veröffentlicht ist.
* Der Seitenschutz für bestimmte Mitgliedergruppen vererbt sich auf alle Unterseiten, außer denjenigen die selbst explizit einen Seitenschutz für Mitgliedergruppen definieren und derren Unterseiten.
* Die Einstellung "Nur Gästen anzeigen" gilt nur für die Seite selbst. Tatsächlich ist die Seite für angemeldete Benutzer auch noch verfügbar, soll nur in keiner Navigation angezeigt werden. (Anders als zum Beispiel Artikel, die nur Gästen angezeigt werden. Diese werden gar nicht mehr gerendert.)
* "Im Menü verstecken" gilt nur für die Seite selbst.

== Navigationsmenü ==

Ein Multitalent: Es ist alles möglich was mit einem Navigationsmenü oder einer Individuellen Navigation möglich ist, Kombinationen aus beiden und noch einiges mehr. Einfach ausprobieren.

Funktionen:
* Kompatibel zu den Templates für das Standard-Navigationsmenü (einziger Unterschied ist, das Seiten die CSS-Klasse "submenu" tatsächlich auch nur dann bekommen, wenn dieses Untermenü gerendert wird)
* Mehrere Referenzseiten (Wurzeln der Navigation)
* Aktuelle Seite als Referenzseite
* Startebene wird relativ zu den Referenzseiten berechnet (negative Startebene möglich)
* Hardlimit flexibel (Anmerkung: Stopebene und Hardlimit beziehen sich relativ zur Startebene &endash; diessollte auch durch die geänderten Labels der Moduleinstellungen hervorgehen.
* Versteckte und geschützte Seiten anzeigen
* Als Sitemap verwendbar
* Optimierte Algorithmen: Zum Beispiel wird pro Navigationsebene nur noch eine Datenbankabfrage durchgeführt, was vorallem bei einer sehr verzweigten Navigation Vorteile bringen sollte.
* Erweiterbar per Hook

=== Navigation per Hook erweitern ===
config.php
<source>
$GLOBALS['TL_HOOKS']['backboneit_navigation_menu'] = array('MyNavigationHook', 'hook');
</source>

MyNavigationHook.php
<source>
class MyNavigationHook {

// ... singleton dummy code ...

public function hook($objThis, $arrRoots) {
$intParentID = 1; // the ID of the parent node, were your new node should be appended/inserted to.

if(!isset($objThis->arrItems[$intParentID])) // test if the parent should be rendered (to avoid my hook, if it is not needed)
return;

$strMyNewNodeID = 'MyNavigationHook' . 1; // to avoid collision do not use plain numbers (reservered for tl_page dataset IDs)
// and prefix the ID with something specific to your hook

$objThis->arrSubpages[$intParentID][] = $strMyNewNodeID; // append the my new node to the end of $intParentIDs childs
$arrRoots[] = $strMyNewNodeID; // additionally add my new node to the end of the first level

$objThis->arrItems[$strMyNewNodeID] = array(
'class' => 'myclass',
'active' => true,
// ... more rendering information for the navigation template ...
);

global $objPage;
$objThis->arrItems[$objPage->id]['active'] = false; // unset active state of current page

return $arrRoots; // return the modified first navigation level (not needed if unmodified)
}

}
</source>

@@ Zeile 3: / Zeile 3: @@
 | Dev=Oliver Hoff
 | DevSite=http://www.hofff.com/
-| ExtVersion=1.0.0
+| ExtVersion=1.1.0
 | Version=ab 2.9
 | TLVersion=2.7.0 - 2.8.4
 | TrackerLink=http://www.contao-forge.org/projects/backboneitnavigation/issues
-| ERLink=http://www.contao.org/erweiterungsliste/view/backboneit_navigation.10000009.de.html
+| ERLink=http://www.contao.org/erweiterungsliste/view/backboneit_navigation.html
 }}

← Nächstältere Version		Version vom 9. August 2011, 14:54 Uhr
Zeile 75:		Zeile 75:

	=== Beispiel ===		=== Beispiel ===
		+
		+	''Danke an Christoph Wiechert a.k.a. psi''
		+
	Folgendes Beispiel fügt einen Level_1 Eintrag und dazu mehrere Level_2 Einträge zum aktuellen Level_0 Eintrag hinzu:		Folgendes Beispiel fügt einen Level_1 Eintrag und dazu mehrere Level_2 Einträge zum aktuellen Level_0 Eintrag hinzu:

← Nächstältere Version		Version vom 9. August 2011, 14:47 Uhr
Zeile 71:		Zeile 71:

	}		}
		+	</source>
		+
		+
		+	=== Beispiel ===
		+	Folgendes Beispiel fügt einen Level_1 Eintrag und dazu mehrere Level_2 Einträge zum aktuellen Level_0 Eintrag hinzu:
		+
		+	- Level_0<br>
		+	-- Level_1 (wird eingefügt)<br>
		+	--- Level_2.0 (wird eingefügt)<br>
		+	--- Level_2.1 (wird eingefügt)<br>
		+	--- Level_2.2 (wird eingefügt)<br>
		+
		+	<source>
		+	<?php
		+
		+	/**
		+	* Helperclass to insert navigation-items
		+	* @author psi
		+	*/
		+	class Brands_BackboneNavi extends Controller
		+	{
		+
		+	public function hook($objNav, $arrRoots)
		+	{
		+	$this->import('Database');
		+
		+	// Eine contao-seite enthält ein modul mit "virtuellen" unterseiten
		+	// Bsp: http://example.com/module-page/item1.html
		+	// Bsp2: http://example.com/module-page/item1/subitem1.html
		+	// herrausschneiden von "item1"
		+	if(!preg_match("~^".preg_quote($GLOBALS['objPage']->alias,'~')."/([a-z0-9_-]+).*\.html$~i",$this->Environment->request,$erg)) return;
		+
		+	// level_1 Eintrag anhand von "item1" einfügen
		+	$objDesigner = $this->Database->prepare('SELECT id,title,alias FROM tl_brand WHERE alias=? AND published=?')->execute($erg[1],'1');
		+	if(!$objDesigner->numRows) return;
		+
		+	// Seite in den Navigations-Pool hinzufügen
		+	$objNav->arrItems[$objDesigner->alias.'-'.$objDesigner->id] = array
		+	(
		+	'link' => $objDesigner->title,
		+	'href' => $this->generateFrontendUrl($GLOBALS['objPage']->row(),'/'.$objDesigner->alias),
		+	// 'isTrail' => (preg_match("~".preg_quote($objDesigner->alias,'~')."\.html$~i",$this->Environment->request))
		+	'isTrail' => true // wir zeigen ohnehin immer nur einen Eintrag des level_1 an, deshalb immer true
		+	);
		+
		+	// als Unterseite von level_0 zuweisen
		+	$objNav->arrSubpages[$GLOBALS['objPage']->id][] = $objDesigner->alias.'-'.$objDesigner->id;
		+
		+
		+	// level_2 Einträge einfügen
		+	$objCats = $this->Database->prepare('SELECT category,categoryAlias FROM tl_brand_product WHERE pid=? AND published=? GROUP BY category')->execute($objDesigner->id,'1');
		+	while($objCats->next())
		+	{
		+	// Seite in den Navigations-Pool hinzufügen
		+	$objNav->arrItems[$objDesigner->id.'-'.$objCats->categoryAlias] = array
		+	(
		+	'link' => $objCats->category,
		+	'href' => $this->generateFrontendUrl($GLOBALS['objPage']->row(),'/'.$objDesigner->alias.'/'.$objCats->categoryAlias),
		+	'isTrail' => (preg_match("~".preg_quote($objCats->categoryAlias,'~')."(/.+\|.html)$~i",$this->Environment->request))
		+	);
		+	// Seite als Unterseite des level_1 Eitnrags zuweisen
		+	$objNav->arrSubpages[$objDesigner->alias.'-'.$objDesigner->id][] = $objDesigner->id.'-'.$objCats->categoryAlias;
		+	}
		+
		+	return $arrRoots;
		+	}
		+	}
		+	?>
	</source>		</source>

@@ Zeile 6: / Zeile 6: @@
 | Version=ab 2.9
 | TLVersion=2.7.0 - 2.8.4
 | ERLink=http://www.contao.org/erweiterungsliste/view/backboneit_navigation.10000009.de.html
 }}

@@ Zeile 1: / Zeile 1: @@
-[[Category:Module]]
+[[Category:Extensions]]
-{{AppliesTo
+{{ExtInfo
-|Version=Alle Versionen
+| Dev=Oliver Hoff
-|Ext1=backboneit_navigation}}
+| DevSite=http://www.hofff.com/
 = backboneit_navigation =
 Erweiterung bestehend aus einer Sammlung von Navigationselementen (vorerst nur ein erweitertes Navigationsmodul).
 Anmerkungen zum Bestimmen der Sichtbarkeit einer Seite:
 * Der Veröffentlichungsstatus gilt ausschließlich für eine Seite selbst. Das heißt zum Beispiel, dass eine Navigation durchaus dargestellt wird, selbst wenn die Referenzseite nicht veröffentlicht ist.
-* Der Seitenschutz für bestimmte Mitgliedergruppen vererbt sich auf alle Unterseiten, außer denjenigen die selbst explizit einen Seitenschutz für Mitgliedergruppen definieren und derren Unterseiten.
+* Der Seitenschutz für bestimmte Mitgliedergruppen vererbt sich auf alle Unterseiten, außer denjenigen die selbst explizit einen Seitenschutz für Mitgliedergruppen definieren und deren Unterseiten.
 * Die Einstellung "Nur Gästen anzeigen" gilt nur für die Seite selbst. Tatsächlich ist die Seite für angemeldete Benutzer auch noch verfügbar, soll nur in keiner Navigation angezeigt werden. (Anders als zum Beispiel Artikel, die nur Gästen angezeigt werden. Diese werden gar nicht mehr gerendert.)
 * "Im Menü verstecken" gilt nur für die Seite selbst.

@@ Zeile 51: / Zeile 51: @@
      $strMyNewNodeID = 'MyNavigationHook' . 1; // to avoid collision do not use plain numbers (reservered for tl_page dataset IDs)
      // and prefix the ID with something specific to your hook
      $objThis->arrSubpages[$intParentID][] = $strMyNewNodeID; // append the my new node to the end of $intParentIDs childs
@@ Zeile 57: / Zeile 59: @@
      $objThis->arrItems[$strMyNewNodeID] = array(
        'class' => 'myclass',
-       'active' => true,
+       'isTrail' => true, // whether this node is in the trail path of the active page
-       // ... more rendering information for the navigation template ...
+       // ... more rendering information for the navigation template (see class AbstractNavigationMenu for all fields) ...
      );
      return $arrRoots; // return the modified first navigation level (not needed if unmodified)

@@ Zeile 34: / Zeile 34: @@
 config.php
 <source>
-$GLOBALS['TL_HOOKS']['backboneit_navigation_menu'] = array('MyNavigationHook', 'hook');
+$GLOBALS['TL_HOOKS']['backboneit_navigation_menu'][] = array('MyNavigationHook', 'hook');
 </source>