is_single( int|string|int[]|string[] $post = '' )

Détermine si la requête est pour un poste unique existant.

Paramètre

$post(int|string|int[]|string[])optionnel

Id , titre, slug ou tableau de ceux-ci à vérifier.

Valeur par défaut : ''

Description / Informations supplémentaires

Fonctionne pour tous types de poste, sauf les attachements et les postes.

Si le paramètre $post est spécifié, la fonction vérifiera en plus si la requête est pour un des postes spécifiés.

Pour plus d'informations sur cette fonction ou d'autres similaires, voir l'article Conditional Tags sur le Manuel du développeur de thème.

Retourne

(bool) True si la requête est pour un poste unique existant.

Déclaration et structure de la fonction is_single()

function is_single( $post = '' ) {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_single( $post );
}
__()

Retourne la traduction d'un texte.

_doing_it_wrong()

Marque quelque chose comme étant incorrectement appelée.

Où est utilisée la fonction is_single() dans le CMS WordPress

Exemples

Vérifier que la page affichée est un poste unique :
if( is_single() ){
    // Code ici ...
}
Vérifier que la page affichée est un poste unique et qui a un identifiant spécifique :
if( is_single(16) ){
    // Code ici ...
}
Vérifier que la page affichée est un poste unique et de type de poste 'post' :
if ( is_single() && 'post' == get_post_type() ) {
   // code ici ...
}

Sources

Codex WordPress : is_single()

Autres fonctions dans le même fichier : wp-includes/query.php

Retour