Drupal: Comment appeler un modèle dans un module?

Question

J'ai quelques non-nœud données dans un module personnalisé de mon et je voudrais invoquer un modèle pour afficher les données. Ce modèle peut être réutilisé pour la sortie de courrier électronique, et je voudrais essentiellement simplement amorcer Drupal et utiliser le modèle si nécessaire.

Je pensais que je pouvais faire quelque chose comme:

$html = theme('verysmallsnippet', $my_fancy_data_structure); 

... puis créez un fichier verysmallsnippet.tpl.php dans le dossier thème actif et attendent ensuite Drupal pour trouver le fichier de modèle et d'évaluer le modèle avec les arguments passés à la fonction de thème. Est-ce une vaste interprétation trop simpliste du fonctionnement du moteur de gabarit - ou dois-je d'abord configurer le registre de thèmes? Ou quoi? J'ai regardé this question, ainsi que la documentation theme, et je suis un peu perdu.

Answer 1

Eh oui, un peu trop simpliste;)

Pour une meilleure introduction que la doc API vous LIÉ, commencez par le Theming Guide, et pour vos besoins spécifiques, vérifier Using the theme layer (Drupal 6.x).

Pour que votre exemple fonctionne, vous devez dire le registre thématique de votre modèle en mettant en œuvre hook_theme():

function yourModule_theme($existing, $type, $theme, $path) { 
    $items = array(); 
    $items['verysmallsnippet'] = array(
    'arguments' => array('my_fancy_data_structure' => array()), // Change array() to a fitting default 
    'template' => 'verysmallsnippet', 
); 

    return $items; 
} 

Vous pouvez définir plus de détails dans ce crochet, mais c'est le minimum dont vous avez besoin pour obtenir un fichier modèle utilisé (le moteur ajoutera la partie 'tpl.php' pour votre recherche du fichier).

REMARQUE: Vous devez déclencher une reconstruction du registre de thème chaque fois que vous ajoutez ou modifiez une implémentation hook_theme(), sinon vos modifications ne prendront pas effet.