Comment hook_theme ()?

Il offre une place pour un module pour définir son thèmes, qui peuvent alors être remplacés par tout autre module ou d'un thème. Il sera aussi l'occasion pour n'importe quel module utiliser un crochet comme mymodule_preprocess_theme_name à changer les variables passées à l'éventuel thème de fonction ou de fichier de modèle.

Il y a essentiellement deux façons d'initialiser un thème de fonction:

theme('poll_results', array('raw_title' => 'title', 'results' => $results, etc...));

et

$build = array(
  '#theme' => 'poll_results',
  '#raw_title' => 'title',
  '#results' => $results,
  etc...
); //Note the '#' at the beginning of the argument name, this tells Drupal's `render` function that this is an argument, not a child element that needs to be rendered.

$content = render($build); //Exact equivalent of calling the previous example now that you have a render array.

Veuillez garder à l'esprit, vous devriez éviter d'appeler thème() directement (par la documentation dans le thème.inc) depuis:

• Contourne mise en cache.
• Contourne les valeurs par défaut des types définis dans hook_element_info(), dont ci-joint actifs
• Contourne le pre_render et post_render étapes.
• Contourne JavaScript etats de l'information.

Dans Drupal 8, thème de la() est une fonction privée, _theme(). Pour plus de détails, veuillez voir http://www.drupal.org/node/2173655.

Lorsque vous comparez les deux de ces le poll_results élément dans l'exemple que vous donnez ci-dessus, vous pouvez probablement ce qui se passe...depuis PHP n'est pas un langage fortement typé de Drupal est de fournir des "arguments nommés' par le biais d'un tableau à clé transmise à la theme fonction, ou haché clés dans le rendu d'une matrice.

"Rendu d'élément", raconte essentiellement le système de thème que ce thème de la fonction sera appelée à l'aide d'un rendu de tableau, avec un argument nommé (dans ce cas form). Le code devrait ressembler à quelque chose comme ceci:

$build = array(
  '#theme' => 'poll_choices',
  '#form' => $form
);

Cela va passer quoi que dans le $form variable pour le thème de fonctionner comme il le seul argument.

Concernant la template clés:

'poll_vote' => array(
  'template' => 'poll-vote',
  'render element' => 'form',
)

définit un thème appelé poll_vote qui utilise un fichier de modèle (d'où le template clé) avec un nom de "poll-vote.tpl.php" (c'est, par convention). Le chemin d'accès à ce fichier de modèle va être trouvés en utilisant le chemin d'accès du module qui la met en œuvre (p. ex. modules/poll/poll-vote.tpl.php), donc c'est bien de mettre les fichiers de modèle dans les sous-dossiers du module principal dossier.

Il y a deux façons de le renvoyer en fait la sortie pour un thème de fonction, par la mise en œuvre de la fonction physique nom (dans ce cas, il serait theme_poll_vote) ou à l'aide d'un fichier de modèle. Si le template clé est vide Drupal suppose que vous avez mis en œuvre une fonction physique et va essayer de l'appeler.

Fichiers de modèle sont préférables si vous avez juste un peu de code HTML à la sortie d'un thème, ou tout simplement vous n'aimez pas l'écriture de code HTML dans les chaînes de caractères à l'intérieur de PHP (personnellement je n'en ai pas). Mais dans les deux cas, les variables passées lorsque vous appelez le thème (que ce soit à l'aide de theme() ou un rendu de tableau comme décrit ci-dessus) sont eux-mêmes passés par le fichier de modèle ou un thème en fonction. Donc:

function theme_poll_results(&$vars) {
  $raw_title = $vars['raw_title'];
  $results = $vars['results'];
  //etc...
}

Si vous utilisez un fichier de modèle au lieu de la même méthode, les variables seraient disponibles comme $raw_title, $results, etc, que Drupal fonctionne extract sur le $vars avant l'analyse, le fichier de modèle.

Je suis sûr qu'il y a beaucoup de choses que j'ai manqué ici, mais si vous avez des questions plus spécifiques posez-vous la question et je vais essayer de les aider.

OriginalL'auteur Clive

Il y a encore une autre façon: (peut être trouvé dans le thème Bartik)

Le scénario est ici que nous avons créé notre propre module et souhaitez remplacer la sortie par défaut pour disons un nœud avec le titre 'zzz'.
Nous ne savons pas et ne prête pas vraiment attention à la manière de la sortie par défaut est généré. Tous nous avons besoin est d'indiquer à Drupal d'utiliser notre propre modèle personnalisé (fichier node--custom--name.tpl.php pour rendre cette nœud spécifique.

Voici les étapes:

1. Dire Drupal où notre fichier de modèle de vie. (Gardez à l'esprit que cette fonction ne pourra prendre effet qu'une fois et après compensation de Drupal cache):

   //Implements hook_theme()
   function mymodulename_theme() { 
     $theme = array();
     $theme['node__custom__name'] = array(
       'render element' => 'node',
       'template' => 'path_from_mymodule_root/node__custom__name',
       );
     return $theme;
   }

2. Dire Drupal où et quand l'utiliser

   //Implements hook_preprocess_node()
   function mymodulename_preprocess_node($vars) {
       if($vars['node']->title == 'zzzz') {
           $vars['theme_hook_suggestions'][] = 'node__custom__name';
           ... your other code ...
        }
    }

   Maintenant Drupal va utiliser notre modèle de fichier pour ce cas précis uniquement, à condition que 'node--custom--name.tpl.php' le fichier est dans la déclaration de chemin, sinon il va continuer à chercher, selon les suggestions des conventions de nommage pour un secours modèle.

OriginalL'auteur Grigoreas P.