💎 PREMIUM: Fr:Marqueurs conditionnels

Languages: English • Français • Italiano • Tags 日本語 Türkçe • Português do Brasil • 中文(简体) • (Add your language)

Page d'accueil du Codex en français - Télécharger WordPress en français
Les utilisateurs francophones se retrouvent sur le site WordPress-Francophone, notamment sur son forum d'entraide.

1 Introduction
2 Les Conditions Pour...
3 Exemples
4 Ressources externes

Introduction

Les Marqueurs Conditionnels peuvent être utilisés dans vos Thèmes pour décider du contenu à afficher sur une page spécifique ou comment ce contenu doit être affiché en fonction de conditions que remplit cette page. Par exemple, si vous voulez insérer un texte particulier au-dessus d'une série d'Articles, mais seulement sur la page principale de votre blog, avec le Marqueur Conditionnel is_home(), cela devient facile.

Ces Marqueurs sont en relation étroite avec la Hiérarchie des Modèles de WordPress.

Attention : Vous ne pouvez utiliser les marqueurs conditionnels des requêtes après le hook action post_selection. Le hook action wp est le premier possible. Pour les thèmes cela signifie qu'un marqueur conditionnel ne fonctionnera pas correctement si vous l'utilisez directement dans le corps de functions.php, hors d'une fonction et d'un hook.

Les Conditions Pour...

Tous les marqueurs conditionnels testent si une condition est remplie, et retourne ensuite true ou false. Les conditions selon lesquelles les différents marqueurs renvoient true sont listées ci-dessous. Les paramètres acceptés par certains marqueurs sont également mentionnés.

La page principale

is_home(): Retourne true quand la page principale est affichée. C'est la page qui affiche le contenu de type blog de votre site, donc si vous avez choisi "Page statique" pour l'option "La page d'accueil affiche :", alors cette fonction renverra true seulement sur la page où vous avez sélectionné "Page des articles :" dans Administration > Réglages > Lecture.

La page d'accueil

is_front_page(): Retourne true quand la page d'accueil de votre site est affichée, que ce soit pour des articles ou une Page. Retourne true quand la page principale du blog est affichée et le paramètre 'Réglages > Lecture -> La page d’accueil affiche' réglé sur "Les derniers articles", ou quand 'Réglages > Lecture -> La page d’accueil affiche' réglé sur "Une page statique" et "Page d'accueil" est la Page actuellement affichée.

La page du blog

is_front_page() et is_home()

A l'heure actuelle, il n'existe pas de marqueur conditionnel pour cibler uniquement la page de blog. On utilisera alors les fonctions is_home() et is_front_page() pour la détecter. Elles peuvent être mal utilisées. On peut en effet définir une page statique pour l'accueil et une autre page pour son blog. Cette dernière va renvoyer true avec la fonction is_home() même s'il ne s'agit pas de la page d'accueil du site. Lorsque l'on utilise les fonctions is_home() et is_front_page(), il faut donc les tester dans le bon ordre pour être sûr des données affichées, quelle que soit la configuration choisie par l'utilisateur. Celui-ci peut en effet choisir :

une page d'accueil par défaut avec des articles
une page d'accueil qui utilise une page statique et pas de page de blog
une page d'accueil qui utilise une page statique et une page de blog

Pour faire cela, il faut donc utiliser conjointement les deux fonctions dans l'ordre donné dans cet exemple :

if ( is_front_page() && is_home() ) {
  // La page d'accueil par défaut
} elseif ( is_front_page() ) {
  // La page d'accueil statique
} elseif ( is_home() ) {
  // La page du blog
} else {
  //everyting else
}

Voir les Ressources externes

Les pages de l'administration

is_admin(): Retourne true quand le tableau de bord ou une page de l'administration est affichée.

Attention : la page wp-login.php ne fait pas partie de l'administration. Cette page n'a pas de marqueur conditionnel. Pour vérifier si c'est cette page qui est affichée, utilisez la variable globale d'administration $pagenow.

La barre d'outils (Admin Bar)

is_admin_bar_showing(): Retourne true si la barre d'outils sera affichée.

Note : Pour afficher ou non cette barre, utilisez show_admin_bar(), cette function doit être appelée immediatement après le hook plugins_loaded ou placée dans le fichier functions.php du thème.

Une page d'article unique (single post)

Concerne les articles qui sont affichés à l'unité (en général, utilise le fichier single.php du thème).

is_single(): Retourne true quand un article (ou attachement ou type de contenu personnalisé (custom post type)) est affiché. (Faux pour une Page)
is_single( '17' ): Retourne true quand l'article avec l'ID 17 est affiché.
is_single( 'Pain et Fromage' ): Retourne true quand l'article dont le titre est "Pain et Fromage" est affiché.
is_single( 'pain-fromage' ): Retourne true quand l'article dont le nom (post_name, ou slug utilisé dans les permaliens) est "pain-fromage" est affiché.
is_single( array( 17, 'pain-fromage', 'Pain et Camembert' ) ): Retourne true quand l'article affiché a l'ID 17, ou son post_name valant "pain-fromage", ou son post_title valant "Pain et Camembert".
is_single( array( 17, 19, 1, 11 ) ): Retourne true quand l'article affiché a son ID valant 17, ou son ID valant 19, ou son ID valant 1, ou son ID valant 11.
is_single( array( 'pain-fromage', 'pain-camembert', 'quiche-maroilles' ) ): Retourne true quand l'article affiché a son post_name valant "pain-fromage", ou son post_name valant "pain-camembert", ou son post_name valant "quiche-maroilles".
is_single( array( 'Pain et Fromage', 'Pain et Camembert', 'Quiche au Maroilles' ) ): Retourne true quand l'article affiché a son post_title valant "Pain et Fromage", ou son post_title valant "Pain et Camembert", ou son post_title valant "Quiche au Maroilles".

Note : Cette function ne fait pas la distinction en l'ID de l'article (ID), le title de l'article (post_title), ou le nom de l'article (post_name). Un article appelé "17" retournera true si l'ID 17 a été demandé. Même chose si le nom (slug) de l'article valant "17".

Les articles à la une (Sticky Post)

is_sticky(): Retourne true si la case à cocher "Mettre cet article en avant sur la page d’accueil" est cochée pour l'article en cours d'affichage. Dans cet exemple aucun ID d'article n'est donné, ce sera alors l'ID de l'article en cours d'itération dans la Boucle qui sera utilisé.
is_sticky( '17' ): Retourne true quand l'article avec l'ID 17 est mis en avant.

Un type de contenu est hiérarchique

is_post_type_hierarchical( $post_type ): Retourne true si le type d'article (CPT) $post_type supporte le format hiérarchique.
is_post_type_hierarchical( 'vignoble' ): Retourne true si le type d'article (CPT) "vignoble" supporte le format hiérarchique.

Un type de contenu archive (Post Type Archive)

is_post_type_archive(): Retourne true si la page en cours d'affichage est une archive, tout types de contenu (CPT) confondus.
is_post_type_archive( $post_type ): Retourne true si la page d'archives affichée correspond à $post_type.
is_post_type_archive( array( 'truc', 'machin', 'bidule' ) ): Retourne true si la page d'archives affichée correspond au type de contenu (CPT) "truc", "machin", ou "bidule".

Note : Pour activer les archives sur un type d'article, utilisez 'has_archive' => true quand vous enregistrez votre type de contenu.

Les commentaires en Popup

is_comments_popup(): Retourne true quand la fenêtre affichée est celle des commentaires en Popup.

Toute page contenant des articles

comments_open(): Retourne true quand les commentaires sont autorisés pour l'article en cours d'affichage dans la Boucle.
pings_open(): Retourne true quand les pings sont autorisés pour l'article en cours d'affichage dans la Boucle .

Une PAGE

Cette section concerne les Pages WordPress, et pas n'importe quelle page générique de votre blog ou en d'autres terme il s'agit du type de contenu post_type='page'.

is_page(): Retourne true quand n'importe quelle page est affichée.
is_page( '42' ): Retourne true quand la page avec l'ID 42 est affichée.
is_page( 'À propos de moi' ): Retourne true quand la page dont le titre (post_title) est "À propos de moi" est affichée.
is_page( 'about-me' ): Retourne true quand la page dont le nom (ou slug contenu dans le permalien, le post_name) est "about-me" est affichée.

Note : Il n'existe pas de fonction pour tester si une page est une sous-page. On peut cependant, contourner ce problème :

if ( is_page() && $post->post_parent > 0 ) { 
    echo "Ceci est une page enfant";
}

Les modèles de page (Custom Page Template)

Afin de déterminer si oui ou non la page affichée utilise un template personnalisé. Que ce soit un modèle de page que l'on retrouve dans la boite des propriétés d'une page, ou qu'elle dépende de la hiérarchie de modèles.

is_page_template(): Retourne true dès qu'un modèle de page est utilisé.
is_page_template( 'about.php' ): Retourne true si le fichier 'about.php' est utilisé en modèle.

Note : Si vous rangez vos fichiers de modèles de page dans un sous-dossier (bonne pratique) dans votre thème, vous devrez spécifier son chemin complet à partir de la racine du thème, par exemple is_page_template( 'pages-template/about.php' ).

Une page de catégorie

is_category( $category ): Retourne true quand la page en cours d'affichage est associée à la catégorie d'archive $category est affichée (peut être un entier, un nom, un identifiant).
is_category( '6' ): Retourne true quand la page de catégorie d'archive dont le term_ID est "6" est affichée.
is_category( 'Des fromages' ): Retourne true quand la page de catégorie d'archive avec le nom (name) "Des fromages" est affichée.
is_category( 'des-fromages' ): Retourne true quand la page de catégorie d'archive avec l'identifiant (slug) "des-fromages" est affichée.
is_category( array( 9, 'fromage-bleu', 'Fromages qui puent' ) ): Retourne true quand la page d'archive a le term_ID à "9", ou son identifiant (slug) sur "fromage-bleu", ou son nom (name) sur "Fromages qui puent".

in_category( '5' ): Retourne true si l'article en cours d'affichage fait partie de la catégorie dont l'ID est "5". Voir aussi in_category()
in_category( array( 1, 2, 3 ) ): Retourne true quand l'article (tout type de contenus (CPT) confondus) fait parti d'une des categories "1", "2", ou "3".
! in_category( array( 4, 5, 6 ) ): Même chose à l'envers : ne fait pas parti des catégories "4", "5", et "6".

Attention : Soyez sûr de votre orthographe entre "is" et "in", la différence est grande.

Voir aussi is_archive() et Category Templates.

Une page de mot-clés (Tag)

is_tag(): Retourne true quand n'importe quelle page d'archive de mot-clés est affichée.
is_tag( 'moyenne' ): Retourne true quand la page d'archive du mot-clé 'moyenne' est affichée.
is_tag( array( 'petite', 'moyenne', 'grande' ) ): Retourne true quand la page d'archive du mot-clé 'petite', 'moyenne', ou 'grande' est affichée.

has_tag(): Retourne true quand l'article en court d'affichage contient le mot-clé spécifié.

Note : Avant WordPress 2.7, cette fonction n'est utilisable que dans la Boucle.

has_tag( 'moyenne' ): Retourne true quand l'article en court d'affichage contient le mot-clé 'moyenne'.
has_tag( array( 'petite', 'moyenne', 'grande' ) ): Retourne true quand l'article en court d'affichage contient le mot-clé 'petite', 'moyenne', ou 'grande'.

Voir aussi is_archive() etTag Templates.

Une page de taxonomie (et associées)

is_tax

is_tax(): Retourne true quand la page affichée est une taxonomie.

Note : Retourne false sur une page de catégorie et de mot-clé, utilisez is_category() et is_tag;

is_tax( 'taille' ): Retourne true quand la page d'archives de la taxonomie 'taille' est affichée.
is_tax( 'taille', 'moyenne' ): Retourne true quand la page d'archives fait partie de la taxonomie 'taille' ou 'moyenne'.
is_tax( 'taille', array( 'petite', 'moyenne', 'grande' ) ): Retourne true quand la page d'archives fait partie de la taxonomie 'taille', 'petite', 'moyenne' ou 'grande'.

has_term

has_term(): Retourne true si l'article (tout type de contenus (CPT) confondus) est associé à n'importe quel termes parmis ceux demandés. Le premier paramètre doit être une chaîne vide. Le second doit être le nom (name) ou l'identifiant (slug) d'une taxonomie.
has_term( 'couleur', 'bleue' ): Retourne true quand l'article en cours d'affichage est associé au terme 'couleur' ou 'bleue'.
has_term( array( 'bleue', 'blanche', 'rouge' ), 'couleur' ): Retourne true quand l'article en cours d'affichage est associé au terme 'bleue', 'blanche', 'rouge', ou 'couleur'.

term_exists

term_exists( $term, $taxonomy, $parent ): Retourne true si $term existe dans n'importe quelle taxonomie. Si $taxonomy est renseigné, le terme doit alors exister dans celle-ci. Le 3ème paramètre $parent est lui aussi optionnel, si renseigné, le terme demandé doit être un enfant de ce parent, la taxonomie doit alors être hiérarchique.

is_taxonomy_hierarchical

is_taxonomy_hierarchical( $taxonomy ): Retourne true si la taxonomie demandée $taxonomy est de type hiérarchique. Pour déclarer une taxonomie hiérarchique utilisez 'hierarchical' => true lors de l'utilisation de register_taxonomy().

taxonomy_exists

taxonomy_exists( $taxonomy ): Retourne true si $taxonomy a été enregistrée pour ce site avec register_taxonomy().

Voir aussi is_archive().

Une page d'auteur

is_author(): Retourne true quand la page d'archive de de n'importe quel un auteur est affichée.
is_author( '2112' ): Retourne true quand la page d'archive d'auteur pour le numéro d'auteur (ID) 2112 est affichée.
is_author( 'Jonathan Buttigieg' ): Retourne true quand la page d'archive d'auteur avec le surnom⁽¹⁾ "Jonathan Buttigieg" est affichée.
is_author( 'julio-potier' ): Retourne true quand la page d'archive d'auteur avec l'identifiant⁽²⁾ "julio-potier" est affichée.
is_author( array( 79, 'julio-potier', 'Greg' ) ): Retourne true quand la page d'archive d'auteur avec l'ID "79", l'identifiant⁽²⁾ "julio-potier" ou le surnom⁽¹⁾ "Greg" est affichée.

⁽¹⁾ La donnée meta utilisateur nickname

⁽²⁾ user_nicename et non la donnée meta utilisateur nickname !

Voir aussi is_archive() et Author Templates.

Un site multi-auteur

is_multi_author(): Retourne true quand plus d'un auteur a déjà publié du contenu sur le site.

Note : Disponible depuis WordPress Version 3.2.

Une page de date

is_date(): Retourne true quand n'importe quelle page d'archive basée sur le temps est affichée (c.a.d une archive mensuelle, annuelle, quotidienne ou basée sur l'heure).
is_year(): Retourne true quand une archive annuelle est affichée.
is_month(): Retourne true quand une archive mensuelle est affichée.
is_day(): Retourne true quand une archive quotidienne est affichée.
is_time(): Retourne true quand une archive à l'heure, la minute ou la seconde est affichée.