Helpers¶

Usando Helpers¶

Tú usas helpers en CakePHP haciendo que un controlador sepa de su existencia. Cada controlador tiene una propiedad $helpers que lista los helpers que estarán disponibles en la vista. Para habilitar un helper en tu vista, agrega el nombre del helper en el arreglo $helpers del controlador.

<?php
class BakeriesController extends AppController {
    var $helpers = array('Form', 'Html', 'Javascript', 'Time');
}
?>

También pueden agregar helpers desde dentro de una acción, de esta forma sólo estarán disponibles para esa acción y no para las demás acciones que permanezcan a ese controlador. Esto ahorra poder de procesamiento para las demás acciones que no usan el helper, y mantinen al controlador mejor organizado.

<?php
class BakeriesController extends AppController {
    function bake {
        $this->helpers[] = 'Time';
    }
    function mix {
        // El helper Time no es cargado aquí, no estará disponible.
    }
}
?>

Creando Helpers¶

Si un helper del core (o alguno mostrado en Cakeforge o en la Bakery) no se ajusta a tus necesidades, los helpers son fáciles de crear.

Digamos que quisieramos crear un helper que pudiera ser usado para mostrar como salida un link específicamente creado con CSS que lo necesitas en diferentes partes de tu aplicación. Para poder ajustar tu lógica dentro de la estructura existente de helpers de CakePHP, necesitarás crear una nueva clase en /app/views/helpers. Llamemos a nuestro helper LinkHelper. El archivo de clase se verá algo como esto:

<?php
/* /app/views/helpers/link.php */

class LinkHelper extends AppHelper {
    function makeEdit($title, $url) {
        // Lógica para crear un link con un formato específico va aqui...
    }
}

?>

Existen algunos métodos incluidos en la clase de Helper en CakePHP de la cual quisieras sacar ventaja:

output(string $string)

Usa esta función para enviar cualquier información de regreso a tu vista.

<?php
function makeEdit($title, $url) {
    // Usa la función de salida del helper para enviar
    // datos con formato de regreso a la vista:
    return $this->output(
        "<div class=\"editOuter\">
         <a href=\"$url\" class=\"edit\">$title</a>
         </div>"
    );
}
?>

<?php
/* /app/views/helpers/link.php (usando otros helpers) */
class LinkHelper extends AppHelper {
    var $helpers = array('Html');

    function makeEdit($title, $url) {
        // Usa el helper de HTML para mostrar
        // información con formato:

        $link = $this->Html->link($title, $url, array('class' => 'edit'));

        return $this->output("<div class=\"editOuter\">$link</div>");
    }
}
?>

<!-- crear un link usando el nuevo helper -->
<?php echo $link->makeEdit('Change this Recipe', '/recipes/edit/5') ?>

Creando Funcionalidad para todos los Helpers¶

Todos los helpers extienden a una clase especial, AppHelper (así como los modelos extienden AppModel y los controladores extienden AppController). Para crear funcionalidad que podría estar disponible para todos los helpers, crea /app/app_helper.php.

<?php
class AppHelper extends Helper {
    function customMethod () {
    }
}
?>

Helpers del Core¶

CakePHP contiene un buen número de helpers que ayudan en la creación de la vista. Ellos asisten en crear notación (markup) con buen formato (incluyendo formas), ayudan a dar formato a texto, tiempo y números, y también pueden acelerar la funcionalidad de Ajax. Aquí está un resumen de los helpers disponibles por defecto. Para más imformación revisa Helpers del Core.