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).

Description

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 :

Paramètre

$post_types

(string | string[]) (Optionnel) Type de poste ou tableau de types de poste à vérifier.

Valeur par défaut : ''

Retourne

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

Structure de la fonction is_singular()

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

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

Fonctions utilisées par is_singular()

__()

Retourne la traduction d'un texte.

_doing_it_wrong()

Marque quelque chose comme étant incorrectement appelée.

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