<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17172 -->
<!-- Reviewed: no -->
<sect1 id="zend.navigation.migration">
    <title>Migration von vorhergehenden Versionen</title>

    <para>
        Dieses Kapitel beschreibt primär Brüche in der Abwärtskompatibilität von
        <classname>Zend_Navigation</classname> und
        <classname>Zend_View_Helper_Navigation</classname> und sollte als Hilfe bei der Migration
        von vorhergehenden Versionen dienen.
    </para>

    <sect2 id="zend.view.navigation.zf7341">
        <title>Migration von Versionen vor 1.9</title>

        <para>
            Vor dem Release 1.9 hat der Menü Helfer
            (<classname>Zend_View_Helper_Navigation_Menu</classname>) Untermenüs nicht richtig
            dargestellt. Wenn <code>onlyActiveBranch</code> <constant>TRUE</constant> war und die
            Option <code>renderParents</code> <constant>FALSE</constant> wurde nichts dargestellt
            wenn die tiefste aktive Seite auf einer geringeren Tiele als die <code>minDepth</code>
            Option war.
        </para>

        <para>
            In einfacheren Worten; Wenn <code>minDepth</code> auf <code>1</code> gesetzt war und
            die aktive Seite eine der Seiten am Anfangs-Level, wurde nichts dargestellt wie das
            folgende Beispiel zeigt.
        </para>

        <para>
            Das folgende Container Setup wird angenommen:
        </para>

        <programlisting language="php"><![CDATA[
<?php
$container = new Zend_Navigation(array(
    array(
        'label' => 'Home',
        'uri'   => '#'
    ),
    array(
        'label'  => 'Products',
        'uri'    => '#',
        'active' => true,
        'pages'  => array(
            array(
                'label' => 'Server',
                'uri'   => '#'
            ),
            array(
                'label' => 'Studio',
                'uri'   => '#'
            )
        )
    ),
    array(
        'label' => 'Solutions',
        'uri'   => '#'
    )
));
]]></programlisting>

        <para>
            Der folgende Code wird in einem View Script verwendet:
        </para>

        <programlisting language="php"><![CDATA[
<?php echo $this->navigation()->menu()->renderMenu($container, array(
    'minDepth'         => 1,
    'onlyActiveBranch' => true,
    'renderParents'    => false
)); ?>
]]></programlisting>

        <para>
            Vor dem Release 1.9 würde der obige Codeabschnitt nichts ausgeben.
        </para>

        <para>
            Seit dem Release 1.9 akzeptiert die <methodname>_renderDeepestMenu()</methodname>
            Methode in <classname>Zend_View_Helper_Navigation_Menu</classname> aktive Seiten die ein
            Level unter <code>minDepth</code> sind, solange diese Seite Kinder hat.
        </para>

        <para>
            Der gleiche Codeabschnitt zeigt jetzt die folgende Ausgabe:
        </para>

        <programlisting language="html"><![CDATA[
<ul class="navigation">
    <li>
        <a href="#">Server</a>
    </li>
    <li>
        <a href="#">Studio</a>
    </li>
</ul>
]]></programlisting>
    </sect2>
</sect1>