[Traduction] Thèmes Wordpress #4
Logo Wordpress
Si vous êtes arrivés directement sur cette page, le premier article est ici : [Traduction] Thèmes WordPress #1.
Cet article est la traduction d’un article du Codex Wordpress.
Référencer des fichier depuis un template
Le Thème Default de WordPress (basé sur la disposition Kubrick de Michael Heilemann’s pour WordPress 1.2) fournis un bon exemple de la manière dont les requêtes sont utilisées sur les templates.
Le code <?php bloginfo('template_directory'); ?> insère l’URL du dossier des templates dans la sortie template. Vous pouvez ajouter toutes les informations URI additionnelles que vous voulez à cette sortie pour référencer des fichiers dans votre Thème.
Le code <?php bloginfo('stylesheet_directory'); ?> insère l’URL du dossier qui contient la feuille de style courante du Thème dans la sortie template. Vous pouvez ajouter toutes les informations URI additionnelles que vous voulez à cette sortie pour référencer des fichiers dans votre Thème, spécifiquement ceux utilisés par votre feuille de style.
La constante TEMPLATEPATH est une référence sur le chemin absolu vers le dossier des templates pour le Thème courant (Sans le / à la fin).
Notez que les URIs qui sont utilisés dans la feuille de style sont relatifs à la feuille de style, et non à la page qui la référence. Ceci rend nulle la nécessité d’inclure du code php dans le fichier CSS pour des dossiers spécifiques. Par example, si vous incluez un dossier images/ dans votre Thème, vous avez seulement besoin de spécifier son chemin relatif dans les CSS, comme ceci :
h1 { background-image: URL(images/my_background.jpg); }
C’est une bonne pratique d’utiliser les URIs de la manière décrite ci-dessus pour référencer des fichiers depuis l’intérieur d’un template, car ainsi votre template ne dépendra pas de chemins absolus.
Définir des Templates Personnalisés
Il est possible d’utiliser le system de plugins WordPress pour définir des templates additionnels qui seront choisis selont vos propres critères. Cette fonctionnalité avancée peux être mise en oeuvre en utilisant le hook d’actions template_redirect. De plus amples informations sur la création de plugins peuvent être trouvées dans la référence de l’API des Plugins.
Hooks de l’API des Plugins
Quand on développe des thèmes, il est bon de garder à l’esprit le groupe de fonction spécialisées de l’API des Plugins listées ci-dessous. Ces hooks de plugins sont appellés de la même manière que les Template Tags, soit comme paramètre à la fonction do_action() de WordPress :
<?php do_action( 'nom_du_hook' [, second paramètre optionnel] ); ?>
soit comme des fonctions seules (une exception est notée ci-dessous):
<?php nom_du_hook(); ?>
Quand vous incluez les hooks spécifiques aux templates dans votre thème, les plugins seront capable de lancer du code ou d’afficher des données directement à l’intérieur de lui, sans nécessiter que leur propre fonction template tag soit ajoutée. C’est pourquoi il est important d’inclure ces hooks de plugins dans vos templates en particulier si vous prévoyez de redistribuer votre thème. Sinon vous risquez de bloquer des fonctionnalités importantes d’un plugin qui utilise un ou plusieurs d’entre eux. Regardez Current Hooks For Actions pour une liste complète des hooks do_action (notez que la plupart ne sont pas destinés à être des hooks template pour les plugins.
Hooks pour les Plugins et Templates :
wp_head- Va dans l’élément HTML
<head>du thème dans le templateheader.php. Ce hook n’a pas de second paramètre. Exemple d’utilisation par un plugin : adjonction de code javascript.Usage :
<?php do_action( 'wp_head'); ?>ou<?php wp_head(); ?> wp_footer- Vas dans le "pied de page" d'un thème : template
footer.php. Ce hook n'a pas de second paramètre. Example d'utilisation par un plugin : insérer du code PHP qui nécessite d'être lancé après tout le reste.Usage :
<?php do_action( 'wp_footer'); ?>ou<?php wp_footer(); ?> wp_meta- Va typiquement dans la section
<li>Meta</li>du menu ou de la sidebar d'un thème :template.php. Ce hook n'a pas de second paramètre. Exemple d'utilisation par un plugin : inclure une annonce tournante.Usage :
<?php do_action( 'wp_meta' ); ?>ou<?php wp_meta(); ?> comment_form- Va dans
comments.phpetcomments-popup.php, directement avant la balise de fermeture du formulaire (</form>). Son second paramètre doit être$post->ID. Exemple d'utilisation par un plugin : afficher la prévisualisation d'un commentaire.Usage :
<?php do_action( 'comment_form', $post->ID); ?>
Pour un réel exemple d'usage de ces hooks, vous les trouverez inclus dans les templates du thème par défaut.
Laissez un commentaire