Como ejemplo, puede tener un CommentController con un método listAction() que desea invocar para obtener una lista de comentarios para la solicitud actual:

<div id="sidebar right">
    <div class="item">
        <?php echo $this->action('list',
                                 'comment',
                                 null,
                                 array('count' => 10)); ?>
    </div>
</div>

Para usar una instancia registrada, simplemente cree una instancia de Zend_Currency y regístrela dentro de Zend_Registry usando Zend_Currency como su clave.

// our example currency
$currency = new Zend_Currency('de_AT');
Zend_Registry::set('Zend_Currency', $currency);

// within your view
echo $this->currency(1234.56);
// this returns '€ 1.234,56'

Para usar la interfaz fluida, cree una instancia de Zend_Currency, llame al ayudante sin ningún parámetro, y llame al método setCurrency().

// within your view
$currency = new Zend_Currency('de_AT');
$this->currency()->setCurrency($currency)->currency(1234.56);
// this returns '€ 1.234,56'

// our example currency
$currency = new Zend_Currency('de_AT');

// initiate the helper
$helper = new Zend_View_Helper_Currency($currency);
echo $helper->currency(1234.56); // this returns '€ 1.234,56'

// our example currency
$currency = new Zend_Currency('de_AT');

// initiate the helper
$helper = new Zend_View_Helper_Currency($currency);
echo $helper->currency(1234.56); // this returns '€ 1.234,56'
echo $helper->currency(1234.56, array('precision' => 1));
// this returns '€ 1.234,6'

Para añadir elementos al cycle, simplemente especifíquelos en el constructor o use la función assign(array $data)

<?php foreach ($this->books as $book):?>
  <tr style="background-color:<?php echo $this->cycle(array("#F0F0F0",
                                                            "#FFFFFF"))
                                              ->next()?>">
  <td><?php echo $this->escape($book['author']) ?></td>
</tr>
<?php endforeach;?>

// Moving in backwards order and assign function
$this->cycle()->assign(array("#F0F0F0","#FFFFFF"));
$this->cycle()->prev();
?>

La salida

<tr style="background-color:'#F0F0F0'">
   <td>First</td>
</tr>
<tr style="background-color:'#FFFFFF'">
   <td>Second</td>
</tr>

Para usar dos cycles, debe especificar los nombres de los cycles. Simplemente establezca el segundo parámetro en el método cycle. $this->cycle(array("#F0F0F0","#FFFFFF"),'cycle2'). También puede usar la función setName($name).

El uso básico de los parciales es renderizar un fragmento de plantilla en su propio ámbito de vista. Considere el siguiente script parcial:

<?php // partial.phtml ?>
<ul>
    <li>From: <?php echo $this->escape($this->from) ?></li>
    <li>Subject: <?php echo $this->escape($this->subject) ?></li>
</ul>

Luego lo llamaría desde su script de vista usando lo siguiente:

<?php echo $this->partial('partial.phtml', array(
    'from' => 'Team Framework',
    'subject' => 'view partials')); ?>

Lo cual renderizaría:

<ul>
    <li>From: Team Framework</li>
    <li>Subject: view partials</li>
</ul>

Normalmente, querrá usar parciales en un bucle, para renderizar el mismo fragmento de contenido muchas veces; de esta manera puede poner grandes bloques de contenido repetido o lógica de visualización compleja en una única ubicación. Sin embargo, esto tiene un impacto en el rendimiento, ya que el ayudante partial necesita invocarse una vez por cada iteración.

El ayudante de vista PartialLoop ayuda a resolver este problema. Le permite pasar un elemento iterable (array u objeto que implemente Iterator) como modelo. Luego itera sobre este, pasando los elementos al script parcial como el modelo. Los elementos en el iterador pueden ser cualquier modelo que permita el ayudante de vista Partial.

Supongamos el siguiente script de vista parcial:

<?php // partialLoop.phtml ?>
    <dt><?php echo $this->key ?></dt>
    <dd><?php echo $this->value ?></dd>

Y el siguiente "modelo":

$model = array(
    array('key' => 'Mammal', 'value' => 'Camel'),
    array('key' => 'Bird', 'value' => 'Penguin'),
    array('key' => 'Reptile', 'value' => 'Asp'),
    array('key' => 'Fish', 'value' => 'Flounder'),
);

En su script de vista, podría entonces invocar el ayudante PartialLoop:

<dl>
<?php echo $this->partialLoop('partialLoop.phtml', $model) ?>
</dl>

<dl>
    <dt>Mammal</dt>
    <dd>Camel</dd>

    <dt>Bird</dt>
    <dd>Penguin</dd>

    <dt>Reptile</dt>
    <dd>Asp</dd>

    <dt>Fish</dt>
    <dd>Flounder</dd>
</dl>

A veces un parcial existirá en un módulo diferente. Si conoce el nombre del módulo, puede pasarlo como segundo argumento a partial() o partialLoop(), moviendo el argumento $model a la tercera posición.

Por ejemplo, si hay un parcial de paginador que desea usar que está en el módulo 'list', podría obtenerlo de la siguiente manera:

<?php echo $this->partial('pager.phtml', 'list', $pagerData) ?>

De esta manera, puede reutilizar parciales creados específicamente para otros módulos. Dicho esto, es probable que sea una mejor práctica colocar los parciales reutilizables en rutas de scripts de vista compartidas.

El uso básico de los placeholders es persistir datos de vista. Cada invocación del ayudante Placeholder espera un nombre de placeholder; el ayudante entonces devuelve un objeto contenedor de placeholder que puede manipular o simplemente mostrar con echo.

<?php $this->placeholder('foo')->set("Some text for later") ?>

<?php
    echo $this->placeholder('foo');
    // outputs "Some text for later"
?>

Agregar contenido a través de placeholders también puede ser útil a veces. Por ejemplo, su script de vista puede tener un array de variables del que desea recuperar mensajes para mostrar más tarde; un script de vista posterior puede entonces determinar cómo se renderizarán.

El ayudante de vista Placeholder usa contenedores que extienden ArrayObject, proporcionando un rico conjunto de características para manipular arrays. Además, ofrece una variedad de métodos para dar formato al contenido almacenado en el contenedor:

<!-- first view script -->
<?php $this->placeholder('foo')->exchangeArray($this->data) ?>

<!-- later view script -->
<?php
$this->placeholder('foo')->setPrefix("<ul>\n    <li>")
                         ->setSeparator("</li><li>\n")
                         ->setIndent(4)
                         ->setPostfix("</li></ul>\n");
?>

<?php
    echo $this->placeholder('foo');
    // outputs as unordered list with pretty indentation
?>

Debido a que los objetos contenedores de Placeholder extienden ArrayObject, también puede asignar contenido a una clave específica en el contenedor fácilmente, en lugar de simplemente empujarlo al contenedor. Se puede acceder a las claves ya sea como propiedades de objeto o como claves de array.

<?php $this->placeholder('foo')->bar = $this->data ?>
<?php echo $this->placeholder('foo')->bar ?>

<?php
$foo = $this->placeholder('foo');
echo $foo['bar'];
?>

En ocasiones puede tener contenido para un placeholder en un script de vista que es más fácil de crear como plantilla; el ayudante de vista Placeholder le permite capturar contenido arbitrario para su renderización posterior usando la siguiente API.

<!-- Default capture: append -->
<?php $this->placeholder('foo')->captureStart();
foreach ($this->data as $datum): ?>
<div class="foo">
    <h2><?php echo $datum->title ?></h2>
    <p><?php echo $datum->content ?></p>
</div>
<?php endforeach; ?>
<?php $this->placeholder('foo')->captureEnd() ?>

<?php echo $this->placeholder('foo') ?>

<!-- Capture to key -->
<?php $this->placeholder('foo')->captureStart('SET', 'data');
foreach ($this->data as $datum): ?>
<div class="foo">
    <h2><?php echo $datum->title ?></h2>
    <p><?php echo $datum->content ?></p>
</div>
 <?php endforeach; ?>
<?php $this->placeholder('foo')->captureEnd() ?>

<?php echo $this->placeholder('foo')->data ?>

Puede especificar el doctype en cualquier momento. Sin embargo, los ayudantes que dependen del doctype para su salida solo lo reconocerán después de que lo haya establecido, así que el enfoque más sencillo es especificarlo en su bootstrap:

$doctypeHelper = new Zend_View_Helper_Doctype();
$doctypeHelper->doctype('XHTML1_STRICT');

Y luego imprimirlo en la parte superior de su script de layout:

<?php echo $this->doctype() ?>

Si necesita conocer el doctype, puede hacerlo llamando a getDoctype() sobre el objeto, que se devuelve al invocar el ayudante.

$doctype = $view->doctype()->getDoctype();

Normalmente, simplemente querrá saber si el doctype es XHTML o no; para esto, el método isXhtml() será suficiente:

if ($view->doctype()->isXhtml()) {
    // do something differently
}

También puede comprobar si el doctype representa un documento HTML5.

if ($view->doctype()->isHtml5()) {
    // do something differently
}

Para implementar el protocolo Open Graph, puede especificar el doctype XHTML1_RDFA. Este doctype permite a un desarrollador usar el Resource Description Framework dentro de un documento XHTML.

$doctypeHelper = new Zend_View_Helper_Doctype();
$doctypeHelper->doctype('XHTML1_RDFA');

El doctype RDFa permite que XHTML se valide cuando se usa el atributo de meta tag 'property' según la especificación del protocolo Open Graph. Ejemplo dentro de un script de vista:

<?php echo $this->doctype('XHTML1_RDFA'); ?>
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:og="http://opengraphprotocol.org/schema/">
<head>
   <meta property="og:type" content="musician" />

En el ejemplo anterior, establecimos la propiedad a og:type. El og hace referencia al espacio de nombres Open Graph que especificamos en la etiqueta html. El contenido identifica la página como perteneciente a un músico. Vea la documentación del protocolo Open Graph para las propiedades admitidas. El ayudante HeadMeta puede usarse para establecer estas meta tags del protocolo Open Graph de forma programática.

Así es como puede comprobar si el doctype está establecido a XHTML1_RDFA:

<?php echo $this->doctype() ?>
<html xmlns="http://www.w3.org/1999/xhtml"
      <?php if ($view->doctype()->isRdfa()): ?>
      xmlns:og="http://opengraphprotocol.org/schema/"
      xmlns:fb="http://www.facebook.com/2008/fbml"
      <?php endif; ?>
>

// From a view script (using XHTML DOCTYPE):
echo $this->gravatar('example@example.com');

/* results in the following output:
    <img src="http://www.gravatar.com/avatar/23463b99b62a72f26ed677cc556c44e8?s=80&d=mm&r=g" />
 */

Hay varias formas de configurar el gravatar devuelto. En la mayoría de los casos, puede pasar un array de opciones como segundo argumento al ayudante, o llamar a métodos sobre el objeto devuelto para configurarlo.

// Within the view script (using HTML DOCTYPE)
echo $this->gravatar('example@example.com',
    array('imgSize' => 90, 'defaultImg' => 'monsterid', 'secure' => true),
    array('class' => 'avatar', 'title' => 'Title for this image')
);

// Or use mutator methods
$this->gravatar()
     ->setEmail('example@example.com')
     ->setImgSize(90)
     ->setDefaultImg(Zend_View_Helper_Gravatar::DEFAULT_MONSTERID)
     ->setSecure(true)
     ->setAttribs(array('class' => 'avatar', 'title' => 'Title for this image'));

/* Both generate the following output:
<img class="avatar" title="Title for this image"
    src="https://secure.gravatar.com/avatar/23463b99b62a72f26ed677cc556c44e8?s=90&d=monsterid&r=g" >
 */

Puede especificar un headLink en cualquier momento. Normalmente, especificará enlaces globales en su script de layout, y enlaces específicos de la aplicación en sus scripts de vista de la aplicación. En su script de layout, en la sección <head>, mostrará entonces el ayudante con echo para generar su salida.

<?php // setting links in a view script:
$this->headLink()->appendStylesheet('/styles/basic.css')
                 ->headLink(array('rel' => 'icon',
                                  'href' => '/img/favicon.ico'),
                                  'PREPEND')
                 ->prependStylesheet('/styles/moz.css',
                                     'screen',
                                     true,
                                     array('id' => 'my_stylesheet'));
?>
<?php // rendering the links: ?>
<?php echo $this->headLink() ?>

Puede especificar una nueva meta tag en cualquier momento. Normalmente, especificará reglas de caché del lado del cliente o palabras clave SEO.

Por ejemplo, si desea especificar palabras clave SEO, estaría creando una meta tag name con el nombre 'keywords' y el contenido las palabras clave que desea asociar con su página:

// setting meta keywords
$this->headMeta()->appendName('keywords', 'framework, PHP, productivity');

Si deseara establecer algunas reglas de caché del lado del cliente, establecería etiquetas http-equiv con las reglas que desea aplicar:

// disabling client-side cache
$this->headMeta()->appendHttpEquiv('expires',
                                   'Wed, 26 Feb 1997 08:21:57 GMT')
                 ->appendHttpEquiv('pragma', 'no-cache')
                 ->appendHttpEquiv('Cache-Control', 'no-cache');

Otro uso popular de las meta tags es establecer el tipo de contenido, el juego de caracteres y el idioma:

// setting content type and character set
$this->headMeta()->appendHttpEquiv('Content-Type',
                                   'text/html; charset=UTF-8')
                 ->appendHttpEquiv('Content-Language', 'en-US');

Si está sirviendo un documento HTML5, debería proporcionar el juego de caracteres así:

// setting character set in HTML5
$this->headMeta()->setCharset('UTF-8'); // Will look like <meta charset="UTF-8">

Como ejemplo final, una manera fácil de mostrar un mensaje de transición antes de una redirección es usando un "meta refresh":

// setting a meta refresh for 3 seconds to a new url:
$this->headMeta()->appendHttpEquiv('Refresh',
                                   '3;URL=http://www.some.org/some.html');

Cuando esté listo para colocar sus meta tags en el layout, simplemente muestre el ayudante con echo:

<?php echo $this->headMeta() ?>

Habilitar el doctype RDFa con el ayudante Doctype habilita el uso del atributo 'property' (además de los estándar 'name' y 'http-equiv') con HeadMeta. Esto se usa comúnmente con el protocolo Open Graph de Facebook.

Por ejemplo, puede especificar un título de página y tipo de open graph de la siguiente manera:

$this->doctype(Zend_View_Helper_Doctype::XHTML1_RDFA);
$this->headMeta()->setProperty('og:title', 'my article title');
$this->headMeta()->setProperty('og:type', 'article');
echo $this->headMeta();

// output is:
//   <meta property="og:title" content="my article title" />
//   <meta property="og:type" content="article" />

Puede especificar una nueva etiqueta script en cualquier momento. Como se señaló anteriormente, estos pueden ser enlaces a archivos de recursos externos o los propios scripts.

// adding scripts
$this->headScript()->appendFile('/js/prototype.js')
                   ->appendScript($onloadScript);

El orden a menudo es importante con la escritura de scripts del lado del cliente; puede que necesite garantizar que las bibliotecas se cargan en un orden específico debido a las dependencias que cada una tiene; use las diversas directivas append, prepend y offsetSet para ayudar en esta tarea:

// Putting scripts in order

// place at a particular offset to ensure loaded last
$this->headScript()->offsetSetFile(100, '/js/myfuncs.js');

// use scriptaculous effects (append uses next index, 101)
$this->headScript()->appendFile('/js/scriptaculous.js');

// but always have base prototype script load first:
$this->headScript()->prependFile('/js/prototype.js');

Cuando finalmente esté listo para generar la salida de todos los scripts en su script de layout, simplemente muestre el ayudante con echo:

<?php echo $this->headScript() ?>

A veces necesita generar scripts del lado del cliente de forma programática. Aunque podría usar concatenación de cadenas, heredocs, y similares, a menudo es más fácil simplemente hacerlo creando el script e intercalando etiquetas PHP. HeadScript le permite hacer exactamente eso, capturándolo a la pila:

<?php $this->headScript()->captureStart() ?>
var action = '<?php echo $this->baseUrl ?>';
$('foo_form').action = action;
<?php $this->headScript()->captureEnd() ?>

Se hacen las siguientes suposiciones:

Puede especificar una nueva etiqueta style en cualquier momento:

// adding styles
$this->headStyle()->appendStyle($styles);

El orden es muy importante con CSS; puede que necesite garantizar que las declaraciones se cargan en un orden específico debido al orden de la cascada; use las diversas directivas append, prepend y offsetSet para ayudar en esta tarea:

// Putting styles in order

// place at a particular offset:
$this->headStyle()->offsetSetStyle(100, $customStyles);

// place at end:
$this->headStyle()->appendStyle($finalStyles);

// place at beginning
$this->headStyle()->prependStyle($firstStyles);

Cuando finalmente esté listo para generar la salida de todas las declaraciones de estilo en su script de layout, simplemente muestre el ayudante con echo:

<?php echo $this->headStyle() ?>

A veces necesita generar declaraciones de estilo CSS de forma programática. Aunque podría usar concatenación de cadenas, heredocs, y similares, a menudo es más fácil simplemente hacerlo creando los estilos e intercalando etiquetas PHP. HeadStyle le permite hacer exactamente eso, capturándolo a la pila:

<?php $this->headStyle()->captureStart() ?>
body {
    background-color: <?php echo $this->bgColor ?>;
}
<?php $this->headStyle()->captureEnd() ?>

Se hacen las siguientes suposiciones:

Puede especificar una etiqueta title en cualquier momento. Un uso típico tendría que establecer segmentos de título para cada nivel de profundidad en su aplicación: sitio, controlador, acción y potencialmente recurso.

 // 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(' / ');

Cuando finalmente esté listo para renderizar el título en su script de layout, simplemente muestre el ayudante con echo:

<!-- renders <action> / <controller> / Zend Framework -->
<?php echo $this->headTitle() ?>

Incrustar Flash en su página usando el ayudante es bastante sencillo. El único argumento requerido es la URI del recurso.

<?php echo $this->htmlFlash('/path/to/flash.swf'); ?>

Esto genera el siguiente HTML:

<object data="/path/to/flash.swf"
        type="application/x-shockwave-flash"
        classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
        codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
</object>

El primer argumento en los ayudantes de objeto siempre es obligatorio. Es la URI del recurso que desea incrustar. El segundo argumento solo es requerido en el ayudante htmlObject(). Los demás ayudantes ya contienen el valor correcto para este argumento. El tercer argumento se usa para pasar atributos al elemento object. Solo acepta un array con pares clave-valor. classid y codebase son ejemplos de tales atributos. El cuarto argumento también solo toma un array clave-valor y los usa para crear elementos <param>. Verá un ejemplo de esto en breve. Por último, está la opción de proporcionar contenido adicional al objeto. Ahora un ejemplo que utiliza todos los argumentos.

echo $this->htmlObject(
    '/path/to/file.ext',
    'mime/type',
    array(
        'attr1' => 'aval1',
        'attr2' => 'aval2'
    ),
    array(
        'param1' => 'pval1',
        'param2' => 'pval2'
    ),
    'some content'
);

/*
This would output:

<object data="/path/to/file.ext" type="mime/type"
    attr1="aval1" attr2="aval2">
    <param name="param1" value="pval1" />
    <param name="param2" value="pval2" />
    some content
</object>
*/

<?php
// View script (backlink.phtml):
echo sprintf(
    '<p class="older"><a href="%s">Older posts</a></p>',
    $this->url(array('controller' => 'index', 'action' => 'index'))
)
?>

<?php
// Usage:
$this->renderToPlaceholder('backlink.phtml', 'link');
?>

<?php
echo $this->placeholder('link');
// Output: <p class="older"><a href="index/index">Older posts</a></p>
?>

Los ayudantes de vista de navegación usan el método mágico __call() para delegar llamadas a métodos al contenedor de navegación que está registrado en el ayudante de vista.

$this->navigation()->addPage(array(
    'type' => 'uri',
    'label' => 'New page'));

La llamada anterior añadirá una página al contenedor en el ayudante Navigation.

Para usar una instancia registrada, simplemente cree una instancia de Zend_Translate o Zend_Translate_Adapter y regístrela dentro de Zend_Registry usando Zend_Translate como su clave.

// our example adapter
$adapter = new Zend_Translate(
    array(
        'adapter' => 'array',
        'content' => array('simple' => 'einfach'),
        'locale'  => 'de'
    )
);
Zend_Registry::set('Zend_Translate', $adapter);

// within your view
echo $this->translate('simple');
// this returns 'einfach'

Para usar la interfaz fluida, cree una instancia de Zend_Translate o Zend_Translate_Adapter, llame al ayudante sin ningún parámetro, y llame al método setTranslator().

// within your view
$adapter = new Zend_Translate(
    array(
        'adapter' => 'array',
        'content' => array('simple' => 'einfach'),
        'locale'  => 'de'
    )
);
$this->translate()->setTranslator($adapter)->translate('simple');
// this returns 'einfach'

// our example adapter
$adapter = new Zend_Translate(
    array(
        'adapter' => 'array',
        'content' => array('simple' => 'einfach'),
        'locale'  => 'de'
    )
);

// initiate the adapter
$translate = new Zend_View_Helper_Translate($adapter);
print $translate->translate('simple'); // this returns 'einfach'

Usaría esta forma si no está trabajando con Zend_View y necesita crear salida traducida.

Para usar un único parámetro, simplemente añádalo al método.

// within your view
$date = "Monday";
$this->translate("Today is %1\$s", $date);
// could return 'Heute ist Monday'

O use una lista de parámetros y añádala al método.

// within your view
$date = "Monday";
$month = "April";
$time = "11:20:55";
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s",
                 $date,
                 $month,
                 $time);
// Could return 'Heute ist Monday in April. Aktuelle Zeit: 11:20:55'

O use un array de parámetros y añádalo al método.

// within your view
$date = array("Monday", "April", "11:20:55");
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);
// Could return 'Heute ist Monday in April. Aktuelle Zeit: 11:20:55'

// within your view
$date = array("Monday", "April", "11:20:55");
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date, 'it');

// within your view
$date = array("Monday", "April", "11:20:55");
$this->translate()->setLocale('it');
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);

// within your view
$date = array("Monday", "April", "11:20:55");

// returns 'de' as set default locale from our above examples
$this->translate()->getLocale();

$this->translate()->setLocale('it');
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);

// returns 'it' as new set default locale
$this->translate()->getLocale();