<sect3 id="zend.view.helpers.initial.headtitle">
    <title>תוסף העזרה HeadTitle</title>

    <para>
        אלמנט תגית <code>&lt;title&gt;</code> ב HTML נועד להצגת כותרת העמוד שכרגע מוצג.
        תוסף העזרה  <code>HeadTitle</code> מאפשר ליצור ולשמור את הכותרת לשימוש ותצוגה בשלב מאוחר יותר.
    </para>

    <para>
        תוסף העזרה <code>HeadTitle</code> הוא יישום משמעותי של <link linkend="zend.view.helpers.initial.placeholder">Placeholder</link>.
        הוא דורש את המתודה  <code>toString()</code> כדי להכפות יצירת תג <code>&lt;title&gt;</code>, ומוסיף אותו למתודת ה <code>headTitle()</code> לשמירה מהירה ופשוטה ולהתקבצות של כל האלמנטים.
        השימוש במתודה זו היא <code>headTitle($title, $setType = 'APPEND')</code>; כברירת מחדל, הערך שנוסף מצורף לקבוצת האלמנטים שכבר קיימים, אבל ניתן להגדיר או 'PREPEND' כדי להוסיף בראש הרשימה או 'SET' לשכתב את כל הרשימה בערך זה.
    </para>

    <example id="zend.view.helpers.initial.headtitle.basicusage">
        <title>שימוש בסיסי בתוסף</title>

        <para>
            תוכל להגדיר תג כותרת בכל שלב. שימוש נכון בדרך כלל הוא לשמור כותרת בכל שלב במערכת: אתר, קונטרולר, מתודה ולפעמים גם דברים נוספים.
        </para>

        <programlisting role="php"><![CDATA[
 // setting the controller and action name as title segments:
$request = Zend_Controller_Front::getInstance()->getRequest();
$this->headTitle($request->getActionName())
     ->headTitle($request->getControllerName());

// setting the site in the title; possibly in the layout script:
$this->headTitle('Zend Framework');

// setting a separator string for segments:
$this->headTitle()->setSeparator(' / ');
]]>
        </programlisting>

        <para>
            ברגע שהינך מוכן להציג את הכותרת בתבנית התצוגה, פשוט יש להדפיס את התוסף:
        </para>

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