Assistants¶

Utiliser les Assistants¶

Vous utilisez les assistants (helpers) dans CakePHP, en faisant « prendre conscience » à un contrôleur qu’ils existent. Chaque contrôleur a une propriété $helpers, qui liste les assistants disponibles dans la vue. Pour activer un assistant dans votre vue, ajoutez son nom au tableau $helpers du contrôleur.

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

Vous pouvez aussi ajoutez les assistants depuis une action, dans ce cas, ils seront uniquement accessibles pour cette action et aucune autre dans le contrôleur. Ceci économise de la puissance de calcul pour les autres actions qui n’utilisent pas l’assistant, tout en permettant de conserver le contrôleur mieux organisé.

<?php
class BoulangeriesController extends AppController {
    function cuire {
        $this->helpers[] = 'Time';
    }
    function melange {
        // L'assistant Time n'est pas chargé ici et par conséquent non disponible
    }
}
?>

Si vous avez besoin d’activer un assistant pour tous les contrôleurs, ajoutez son nom dans le tableau $helpers du fichier /app/app_controller.php (à créer si pas présent). Souvenez-vous d’inclure les assistants par défaut Html et Form.

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

Créer des Assistants¶

Si un assistant du cœur (ou l’un de ceux présentés sur Cakeforge ou dans la Boulangerie) ne répond pas à vos attentes, il est facile de créer des assistants.

Mettons que nous voulions créer un assistant, qui pourrait être utilisé pour produire un lien CSS, façonné spécialement selon vos besoins, à différents endroits de votre application. Afin de trouver une place à votre logique dans la structure d’assistant existante dans CakePHP, vous devrez créer une nouvelle classe dans /app/views/helpers. Appelons notre assistant LienHelper. Le fichier de la classe PHP devrait ressembler à quelque chose comme ceci :

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

class LienHelper extends AppHelper {
    function lancerEdition($titre, $url) {
        // La logique pour créer le lien spécialement formaté se place ici...
    }
}

?>

Il y a quelques méthodes incluent dans la classe Helper de CakePHP, dont vous pourriez tirer avantage :

output(string $string)

Utilisez cette fonction pour transmettre toutes données à votre vue.

<?php
function lancerEdition($titre, $url) {
    // Utilisez la fonction output de la classe Helper
    // pour transmettre des données formatées à votre vue :
    return $this->output(
        "<div class=\"contourEdition\">
         <a href=\"$url\" class=\"editer\">$titre</a>
         </div>"
    );
}
?>

<?php
/* /app/views/helpers/lien.php (utilisant d'autres assistants) */
class LienHelper extends AppHelper {
    var $helpers = array('Html');

    function lancerEdition($titre, $url) {
        // Utilisez l'assistant HTML pour transmettre
        // les données formatées :

        $lien = $this->Html->link($titre, $url, array('class' => 'editer'));

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

<!-- créer un lien en utilisant le nouvel assistant -->
<?php echo $lien->lancerEdition('Changer cette Recette', '/recettes/editer/5') ?>

Créer des Fonctionnalités pour Tous les Assistants¶

Tous les assistants étendent une classe spéciale, AppHelper (tout comme les modèles étendent AppModel et les contrôleurs étendent AppController). Pour créer une fonctionnalité qui devrait être disponible pour tous les assistants, créez /app/app_helper.php.

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

Assistants intégrés¶

CakePHP fournit bon nombre d’assistants (helpers) qui vous aideront dans la création de vues. Ils vous assistent à la création de marquage bien formaté (dont les formulaires), vous aident à formater du texte, des heures et des nombres, et peuvent même accélérer les fonctionnalités Ajax. Voici un résumé de assistants livrés de base. Pour plus d’informations, rendez-vous sur Assistants intégrés.