|
|
@@ -1,5 +1,5 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
-<!-- EN-Revision: 17134 -->
|
|
|
+<!-- EN-Revision: 17143 -->
|
|
|
<!-- Reviewed: no -->
|
|
|
<sect3 id="zend.view.helpers.initial.navigation">
|
|
|
<title>Navigations Helfer</title>
|
|
|
@@ -12,183 +12,188 @@
|
|
|
|
|
|
<para>
|
|
|
Es gibt 2 eingebaute Helfer:
|
|
|
+ </para>
|
|
|
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <link
|
|
|
- linkend="zend.view.helpers.initial.navigation.breadcrumbs">Breadcrumbs</link>,
|
|
|
- wird für die Darstellung des Pfades der aktuell aktiven Seite verwendet.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <link linkend="zend.view.helpers.initial.navigation.links">Links</link>,
|
|
|
- wird für die Darstellung von Navigations Header Links (z.B.
|
|
|
- <code><link rel="next" href="..." /></code>) verwendet.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <link linkend="zend.view.helpers.initial.navigation.menu">Menu</link>,
|
|
|
- wird für die Darstellung von Menüs verwendet.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <link linkend="zend.view.helpers.initial.navigation.sitemap">Sitemap</link>,
|
|
|
- wird für die Darstellung von Sitemaps verwendet die dem
|
|
|
- <ulink url="http://www.sitemaps.org/protocol.php">Sitemaps XML Format</ulink>
|
|
|
- entsprechen.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <link
|
|
|
- linkend="zend.view.helpers.initial.navigation.navigation">Navigation</link>,
|
|
|
- wird für die Weiterleitung von Aufrufen zu anderen Navigations Helfern
|
|
|
- verwendet.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <link
|
|
|
+ linkend="zend.view.helpers.initial.navigation.breadcrumbs">Breadcrumbs</link>,
|
|
|
+ wird für die Darstellung des Pfades der aktuell aktiven Seite verwendet.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <link linkend="zend.view.helpers.initial.navigation.links">Links</link>,
|
|
|
+ wird für die Darstellung von Navigations Header Links (z.B.
|
|
|
+ <code><link rel="next" href="..." /></code>) verwendet.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <link linkend="zend.view.helpers.initial.navigation.menu">Menu</link>,
|
|
|
+ wird für die Darstellung von Menüs verwendet.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <link linkend="zend.view.helpers.initial.navigation.sitemap">Sitemap</link>,
|
|
|
+ wird für die Darstellung von Sitemaps verwendet die dem
|
|
|
+ <ulink url="http://www.sitemaps.org/protocol.php">Sitemaps XML Format</ulink>
|
|
|
+ entsprechen.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <link
|
|
|
+ linkend="zend.view.helpers.initial.navigation.navigation">Navigation</link>,
|
|
|
+ wird für die Weiterleitung von Aufrufen zu anderen Navigations Helfern
|
|
|
+ verwendet.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
|
|
|
+ <para>
|
|
|
Alle eingebauten Helfer erweitern
|
|
|
<classname>Zend_View_Helper_Navigation_HelperAbstract</classname>, welches die Integration
|
|
|
von <link linkend="zend.acl">ACL</link> und <link
|
|
|
linkend="zend.translate">Übersetzung</link> hinzufügt. Die abstrakte Klasse
|
|
|
implementiert das Interface <classname>Zend_View_Helper_Navigation_Helper</classname>
|
|
|
welches die folgenden Methoden definiert:
|
|
|
+ </para>
|
|
|
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}Container()</code> empfängt/setzt den Navigations Container
|
|
|
- mit dem der Helfer standardmäßig arbeiten soll, und
|
|
|
- <methodname>hasContainer()</methodname> prüft ob der Helfer Container
|
|
|
- registriert hat.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}Translator()</code> empfängt/setzt den Übersetzer der für die
|
|
|
- Übersetzung von Überschriften und Titelm verwendet wird, und
|
|
|
- <code>{get|set}UseTranslator()</code> kontrolliert ob der Übersetzer aktiviert
|
|
|
- werden soll. Die Methode <methodname>hasTranslator()</methodname> prüft ob der
|
|
|
- Helfer einen Übersetzer registriert hat.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}Acl()</code>, <code>{get|set}Role()</code>,
|
|
|
- empfängt/setzt ACL (<classname>Zend_Acl</classname>) Instanzen und Rollen
|
|
|
- (<type>String</type> oder <classname>Zend_Acl_Role_Interface</classname>)
|
|
|
- die bei der Darstellung für das Filtern von Seiten verwendet werden, und
|
|
|
- <code>{get|set}UseAcl()</code> kontrolliert ob ACL aktiviert werden soll.
|
|
|
- Die Methoden <methodname>hasAcl()</methodname> und
|
|
|
- <methodname>hasRole()</methodname> prüfen ob der Helfer eine ACL Instanz oder
|
|
|
- Rolle registriert hat.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>__toString()</methodname>, die magische Methode stellt sicher das
|
|
|
- der Helfer, durch den direkten Aufruf von <code>echo</code> an der Instanz des
|
|
|
- Helfers, dargestellt werden kann.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>render()</methodname>, muß von konkreten Helfern implementiert
|
|
|
- werden um die Darstellung durchzuführen.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}Container()</code> empfängt/setzt den Navigations Container
|
|
|
+ mit dem der Helfer standardmäßig arbeiten soll, und
|
|
|
+ <methodname>hasContainer()</methodname> prüft ob der Helfer Container
|
|
|
+ registriert hat.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}Translator()</code> empfängt/setzt den Übersetzer der für die
|
|
|
+ Übersetzung von Überschriften und Titelm verwendet wird, und
|
|
|
+ <code>{get|set}UseTranslator()</code> kontrolliert ob der Übersetzer aktiviert
|
|
|
+ werden soll. Die Methode <methodname>hasTranslator()</methodname> prüft ob der
|
|
|
+ Helfer einen Übersetzer registriert hat.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}Acl()</code>, <code>{get|set}Role()</code>,
|
|
|
+ empfängt/setzt ACL (<classname>Zend_Acl</classname>) Instanzen und Rollen
|
|
|
+ (<type>String</type> oder <classname>Zend_Acl_Role_Interface</classname>)
|
|
|
+ die bei der Darstellung für das Filtern von Seiten verwendet werden, und
|
|
|
+ <code>{get|set}UseAcl()</code> kontrolliert ob ACL aktiviert werden soll.
|
|
|
+ Die Methoden <methodname>hasAcl()</methodname> und
|
|
|
+ <methodname>hasRole()</methodname> prüfen ob der Helfer eine ACL Instanz oder
|
|
|
+ Rolle registriert hat.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>__toString()</methodname>, die magische Methode stellt sicher das
|
|
|
+ der Helfer, durch den direkten Aufruf von <code>echo</code> an der Instanz des
|
|
|
+ Helfers, dargestellt werden kann.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>render()</methodname>, muß von konkreten Helfern implementiert
|
|
|
+ werden um die Darstellung durchzuführen.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
|
|
|
- Zusätzlich zu den Methoden die vom Interface kommen, implementiert die abstrakte Klasse
|
|
|
- die folgenden Methoden:
|
|
|
+ <para>
|
|
|
+ Zusätzlich zu den Methoden die vom Interface kommen, implementiert die abstrakte Klasse
|
|
|
+ die folgenden Methoden:
|
|
|
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}Indent()</code> empfängt/setzt die Einrückung. Der Setzer
|
|
|
- akzeptiert einen <type>String</type> oder ein <code>int</code>. Im
|
|
|
- Fall eines <code>int</code>'s verwendet der Helfer die angegebene Zahl
|
|
|
- als Leerzeichen für die Einrückung. Z.B. bedeutet
|
|
|
- <methodname>setIndent(4)</methodname> eine Einrückung von initial 4 Leerzeichen.
|
|
|
- Die Einrückung kann für alle Helfer außer dem Sitemap Helfer spezifiziert
|
|
|
- werden.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}MinDepth()</code> empfängt/setzt die minimale Tiefe die eine
|
|
|
- Seite haben muß um vom Helfer eingefügt zu werden. Das Setzen von
|
|
|
- <constant>NULL</constant> bedeutet keine minimale Tiefe.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}MaxDepth()</code> empfängt/setzt die maximale Tiefe die eine
|
|
|
- Seite haben muß um vom Helfer eingefügt zu werden. Das Setzen von
|
|
|
- <constant>NULL</constant> bedeutet keine maximale Tiefe.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>{get|set}RenderInvisible()</code> empfängt/setzt ob Elemente die als
|
|
|
- unsichtbar markiert sind, dargestellt werden oder nicht.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>__call()</methodname> wird verwendet um Aufrufe zum Container, der
|
|
|
- im Helfer registriert ist, weiterzuleiten, was bedeutet das man Methoden in
|
|
|
- einem Helfer aufrufen kann wie wenn Sie im Container wären. Siehe das folgende
|
|
|
- <link
|
|
|
- linkend="zend.view.helpers.initial.navigation.proxy.example">Beispiel</link>.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>findActive($container, $minDepth, $maxDepth)</methodname> wird
|
|
|
- verwendet um die tiefste aktive Seite im angegebenen Container zu finden. Wenn
|
|
|
- keine Tiefe angegeben wird, verwendet diese Methode die Werte die sie von
|
|
|
- <methodname>getMinDepth()</methodname> und
|
|
|
- <methodname>getMaxDepth()</methodname> erhält. Die tiefste aktive Seite muß
|
|
|
- zwischen <varname>$minDepth</varname> und <varname>$maxDepth</varname> inklusive
|
|
|
- liegen. Gibt ein Array zurück das Referenzen zu der gefundenen Instanz der Seite
|
|
|
- enthält, und die Tiefe bei der die Seite gefunden wurde.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>htmlify()</methodname> stellt ein <code>a</code> HTML Element von
|
|
|
- einer <classname>Zend_Navigation_Page</classname> Instanz dar.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <methodname>accept()</methodname> wird verwendet um zu erkennen ub eine Seite
|
|
|
- akzeptiert werden soll wenn durch Container iteriert wird. Diese Methode prüft
|
|
|
- die Sichtbarkeit der Seite und verifiziert das die Rolle des Helfers auf die
|
|
|
- Ressource/Privilegien der Seite zugreifen darf.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>static setDefaultAcl()</code> wird für das Setzen des standardmäßigen
|
|
|
- ACL Objekts verwendet, das dann von Helfern verwendet wird.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- <code>static setDefaultRole()</code> wird für das Setzen der standardmäßigen
|
|
|
- Rolle verwendet, die dann von Helfern verwendet wird.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
</para>
|
|
|
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}Indent()</code> empfängt/setzt die Einrückung. Der Setzer
|
|
|
+ akzeptiert einen <type>String</type> oder ein <code>int</code>. Im
|
|
|
+ Fall eines <code>int</code>'s verwendet der Helfer die angegebene Zahl
|
|
|
+ als Leerzeichen für die Einrückung. Z.B. bedeutet
|
|
|
+ <methodname>setIndent(4)</methodname> eine Einrückung von initial 4 Leerzeichen.
|
|
|
+ Die Einrückung kann für alle Helfer außer dem Sitemap Helfer spezifiziert
|
|
|
+ werden.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}MinDepth()</code> empfängt/setzt die minimale Tiefe die eine
|
|
|
+ Seite haben muß um vom Helfer eingefügt zu werden. Das Setzen von
|
|
|
+ <constant>NULL</constant> bedeutet keine minimale Tiefe.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}MaxDepth()</code> empfängt/setzt die maximale Tiefe die eine
|
|
|
+ Seite haben muß um vom Helfer eingefügt zu werden. Das Setzen von
|
|
|
+ <constant>NULL</constant> bedeutet keine maximale Tiefe.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>{get|set}RenderInvisible()</code> empfängt/setzt ob Elemente die als
|
|
|
+ unsichtbar markiert sind, dargestellt werden oder nicht.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>__call()</methodname> wird verwendet um Aufrufe zum Container, der
|
|
|
+ im Helfer registriert ist, weiterzuleiten, was bedeutet das man Methoden in
|
|
|
+ einem Helfer aufrufen kann wie wenn Sie im Container wären. Siehe das folgende
|
|
|
+ <link
|
|
|
+ linkend="zend.view.helpers.initial.navigation.proxy.example">Beispiel</link>.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>findActive($container, $minDepth, $maxDepth)</methodname> wird
|
|
|
+ verwendet um die tiefste aktive Seite im angegebenen Container zu finden. Wenn
|
|
|
+ keine Tiefe angegeben wird, verwendet diese Methode die Werte die sie von
|
|
|
+ <methodname>getMinDepth()</methodname> und
|
|
|
+ <methodname>getMaxDepth()</methodname> erhält. Die tiefste aktive Seite muß
|
|
|
+ zwischen <varname>$minDepth</varname> und <varname>$maxDepth</varname> inklusive
|
|
|
+ liegen. Gibt ein Array zurück das Referenzen zu der gefundenen Instanz der Seite
|
|
|
+ enthält, und die Tiefe bei der die Seite gefunden wurde.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>htmlify()</methodname> stellt ein <code>a</code> HTML Element von
|
|
|
+ einer <classname>Zend_Navigation_Page</classname> Instanz dar.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <methodname>accept()</methodname> wird verwendet um zu erkennen ub eine Seite
|
|
|
+ akzeptiert werden soll wenn durch Container iteriert wird. Diese Methode prüft
|
|
|
+ die Sichtbarkeit der Seite und verifiziert das die Rolle des Helfers auf die
|
|
|
+ Ressource/Privilegien der Seite zugreifen darf.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>static setDefaultAcl()</code> wird für das Setzen des standardmäßigen
|
|
|
+ ACL Objekts verwendet, das dann von Helfern verwendet wird.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>static setDefaultRole()</code> wird für das Setzen der standardmäßigen
|
|
|
+ Rolle verwendet, die dann von Helfern verwendet wird.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+
|
|
|
<para>
|
|
|
Wenn ein Navigations Container nicht explizit in einem Helfer durch Verwendung von
|
|
|
<code>$helper->setContainer($nav)</code> gesetzt ist, schaut der Helfer in
|
|
|
@@ -244,14 +249,12 @@ $this->navigation()->addPage(array(
|
|
|
weitergeleitete Helfer nicht bereits einen Übersetzer hat.
|
|
|
</para>
|
|
|
|
|
|
- <para>
|
|
|
- <note>
|
|
|
- <para>
|
|
|
- Es gibt keinen Übersetzer im Sitemap Helfer, da keine SeitenLabels oder
|
|
|
- Überschriften in einer XML Sitemap enthalten sind.
|
|
|
- </para>
|
|
|
- </note>
|
|
|
- </para>
|
|
|
+ <note>
|
|
|
+ <para>
|
|
|
+ Es gibt keinen Übersetzer im Sitemap Helfer, da keine SeitenLabels oder
|
|
|
+ Überschriften in einer XML Sitemap enthalten sind.
|
|
|
+ </para>
|
|
|
+ </note>
|
|
|
</sect4>
|
|
|
|
|
|
<sect4 id="zend.view.helpers.initial.navigation.acl">
|
|
|
@@ -297,33 +300,34 @@ $this->navigation()->addPage(array(
|
|
|
|
|
|
<para>
|
|
|
Notizen zum Setup:
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Die Domain der Site ist <code>www.example.com</code>.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Interessante Eigenschaften der Seite sind mit einem Kommentar markiert.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Solange im Beispiel nicht anders erwähnt, fragt der Benutzer nach der URL
|
|
|
- <code>http://www.example.com/products/server/faq/</code>, welche auf die
|
|
|
- Seite mit dem Label <code>FAQ</code> unter <code>Foo Server</code>
|
|
|
- übersetzt wird.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Das angenommene ACL und Route Setup wird unter dem Container Setup gezeigt.
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
</para>
|
|
|
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Die Domain der Site ist <code>www.example.com</code>.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Interessante Eigenschaften der Seite sind mit einem Kommentar markiert.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Solange im Beispiel nicht anders erwähnt, fragt der Benutzer nach der URL
|
|
|
+ <code>http://www.example.com/products/server/faq/</code>, welche auf die
|
|
|
+ Seite mit dem Label <code>FAQ</code> unter <code>Foo Server</code>
|
|
|
+ übersetzt wird.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Das angenommene ACL und Route Setup wird unter dem Container Setup gezeigt.
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+
|
|
|
<programlisting language="php"><
thomas