is_singular( string|string[] $post_types = '' )

Détermine si la requête est pour un poste unique existant de n'importe quel type de poste (poste, attachement, page, types de poste personnalisés).

Paramètre

$post_types(string|string[])optionnel

Type de poste ou tableau de types de poste à vérifier.

Valeur par défaut : ''

Description / Informations supplémentaires

Si le paramètre $post_types est précisé, cette fonction vérifiera en plus si la requête est pour un type de poste spécifié.

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.

Voir aussi :

Retourne

(bool) True si la requête est pour un poste unique existant ou un des types de poste spécifiés.

Déclaration et structure de la fonction is_singular()

function is_singular( $post_types = '' ) {
    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_singular( $post_types );
}
__()

Retourne la traduction d'un texte.

_doing_it_wrong()

Marque quelque chose comme étant incorrectement appelée.

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

Exemples

$singular = is_singular( 'post' );
// Retourne true quand on se trouve sur la page d'un poste.
Utilisation avec un hook :
function votre_function() {
    if ( is_singular() ) {
        echo 'Salut tout le monde !';
    }
}
add_action( 'loop_start', 'votre_function' );

Sources

Codex WordPress : is_singular()

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

Retour