Introduction à PHP pour la conception de thèmes

Publié ou traduit par kolossaldrupal, le mer, 15/04/2009 - 07:00
in

Traduction de la page http://drupal.org/node/348916
publiée / actualisée le 29 Janvier 2011 sur drupal.org

Vous enseigner le PHP sort largement du cadre de ce document, mais voici quelques-unes des techniques élémentaires qu'il est important de connaître pour travailler avec les thèmes.

Découvrir vos données

Utiliser le module Devel

La façon la plus facile pour voir les variables utilisées par un fichier gabarit est d'utiliser le module Devel. Il vous donnera non seulement accès direct, intéractif aux variables utilisées dans la création des pages, mais il dispose également de nombreuses fonctions pour débogguer les données pendant que vous travaillez.

Coder en dur

Si pour une quelconque raison vous ne pouvez (ou ne voulez pas) utiliser le module Devel, il est possible d'utiliser une fonction PHP pour voir toutes les variables passées à votre fichier gabarit.

Pour cela, ajoutez le code suivant à n'importe quel fichier gabarit (tpl.php) de votre thème :

<?php
$vars = get_defined_vars();
print_r($vars);
?>

les deux techniques précédentes utilisent beaucoup de ressources etpeuvent dévoiler des informations sensibles aux internautes. Aussi, vous ne devriez jamais les utiliser sur un site en exploitation.

Utiliser l'information dont vous disposez

Une fois que vous avez utilisé une des techniques précédentes, vous verrez de nombreuses variables et tableaux. Si vous le souhaitez, vous pouvez spécifier l'une de ces variables dans le fichier gabarit.

Par exemple, pour afficher le titre, vous pourrez ajouter le code suivant à votre fichier tpl.php :

<?php
print $title;
?>

Pour afficher le titre du node, avec un lien pointant sur ce node et un peu de balisage, ajoutez le code suivant :

<h2 class="title">
      <a href="<?php print $node_url; ?>" title="<?php print $title; ?>"><?php print $title; ?></a>
    </h2>
[/HTML]


<h3>Tableaux</h3>

<p>La technique du <span class="codeinline">print_r</span> montr&eacute;e ci-dessus affichera probablement un certain nombre de tableaux. </p>

<p>Par exemple, si vous utilisez une taxonomie, vous pourriez obtenir quelque chose comme ceci :</p>

[html]
[taxonomy] => Array

Un tableau permet le regroupement organisé de données ayant un rapport entre elles. Si vous voulez n'afficher qu'un item d'un tableau, vous spécifierez cet item en utilisant sa clé.

Par exemple, supposons que print_r vous affiche le tableau suivant :

[location] => Array
        (
            [lid] => 3
            [name] => My Place
            [street] => 235 King Edward Avenue
            [additional] =>
            [city] => Ottawa
            [province] => ON
            [postal_code] => K1N 7L8
            [country] => ca
            [latitude] => 45.431993
            [longitude] => -75.688390
            [source] => 3
            [is_primary] => 0
            [province_name] => Ontario
            [country_name] => Canada
        )

Si vous ne voulez afficher que la ville, ajoutez le code suivant à votre fichier .tpl.php :

<?php print $location['city'] ?>

Il y a d'autres façons de manipuler votre contenu avec PHP. Pour plus d'informations à ce sujet, consultez un des manuels de référence PHP disponibles sur le web.