is_single() | Fonctions Wordpress

Description

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.

Paramètre

$post

(int | string | int[] | string[]) (Optionnel) Id , titre, slug ou tableau de ceux-ci à vérifier.

Valeur par défaut : ''

Retourne

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

Structure de la fonction `is_single()`

Définie dans le fichier wp-includes/query.php à la ligne 723 :

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 );
}

Fonctions utilisées par `is_single()`

__(): Retourne la traduction d'un texte.
_doing_it_wrong(): Marque quelque chose comme étant incorrectement appelée.

Où trouver 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