repo_zf1/documentation/manual/de/module_specs/Zend_View-Helpers-HeadTitle.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 14978 -->
<!-- Reviewed: no -->
<sect3 id="zend.view.helpers.initial.headtitle">
    <title>HeadTitle Helfer</title>

    <para>
        Das HTML <code>&lt;title&gt;</code> Element wird verwendet um einen Titel für ein HTML Dokument anzubieten.
        Der <code>HeadTitle</code> Helfer erlaubt es Titel für späteren Empfang und Ausgabe programmtechnisch
        zu Erstellen und zu Speichern.
    </para>

    <para>
        Der <code>HeadTitle</code> Helfer ist eine konkrete Implementation des
        <link linkend="zend.view.helpers.initial.placeholder">Plaltzhalter Helfer</link>. Er überschreibt die
        <code>toString()</code> Methode um die erstellung des <code>&lt;title&gt;</code> Elements zu erzwingen,
        und fgt eine <code>headTitle()</code> Methode für das schnelle und einfache Einstellen und Ändern von
        Titel Elementen hinzu. Die Signatur dieser Methode ist
        <code>headTitle($title, $setType = 'APPEND')</code>; standardmäßig, wird der Wert dem Stack angefügt
        (Anhäufen von Title Segmenten), aber es kann auch 'PREPEND' (Platzierung am Anfang des Stacks) oder
        'SET' (Stack überschreiben) spezifiziert werden.
    </para>

    <example id="zend.view.helpers.initial.headtitle.basicusage">
        <title>Grundsätzliche Verwendung des HeadTitle Helfers</title>

        <para>
            Es kann jederzeit ein Titel Tag spezifiziert werden. Die typische Verwendung besteht darin das
            Titel Segment bei jedem Level an Tiefe in der Anwendung: Site, Kontroller, Aktion und potentiell
            Ressourcen.
        </para>

        <programlisting role="php"><![CDATA[
// Setzen des Kontroller und Aktion Namens als Titel Segment:
$request = Zend_Controller_Front::getInstance()->getRequest();
$this->headTitle($request->getActionName())
     ->headTitle($request->getControllerName());

// Setzen der Site im Titel; möglicherweise das Layout Skript:
$this->headTitle('Zend Framework');

// Setzen eines Separator Strings für Segmente:
$this->headTitle()->setSeparator(' / ');
]]>
        </programlisting>

        <para>
            Wenn man letztendlich damit fertig ist den Titel im Layoutskript darzustellen, muß dieser
            einfach ausgegeben werden:
        </para>

        <programlisting role="php"><![CDATA[
<!-- Darstellung <action> / <controller> / Zend Framework -->
<?php echo $this->headTitle() ?>
]]>
        </programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->