get_object_subtype( string $object_type, int $object_id )
Retourne le sous-type d'un objet pour un type d'objet et un id d'objet donné.
Paramètres
$object_type
(string)requisType d'objet. Accepte 'post', 'comment', 'term', 'user' ou tout autre type d'objet associé à une table de méta-donnée.
$object_id
(int)requisId de l'objet pour lequel on veut savoir son sous-type.
Retourne
(string) Le sous-type de l'objet ou une chaîne vide si le sous-type n'est pas spécifié.
Déclaration et structure de la fonction get_object_subtype()
get_object_subtype()
est déclarée dans le fichier wp-includes/meta.php
à la ligne 1760 :
function get_object_subtype( $object_type, $object_id ) {
$object_id = (int) $object_id;
$object_subtype = '';
switch ( $object_type ) {
case 'post':
$post_type = get_post_type( $object_id );
if ( ! empty( $post_type ) ) {
$object_subtype = $post_type;
}
break;
case 'term':
$term = get_term( $object_id );
if ( ! $term instanceof WP_Term ) {
break;
}
$object_subtype = $term->taxonomy;
break;
case 'comment':
$comment = get_comment( $object_id );
if ( ! $comment ) {
break;
}
$object_subtype = 'comment';
break;
case 'user':
$user = get_user_by( 'id', $object_id );
if ( ! $user ) {
break;
}
$object_subtype = 'user';
break;
}
/**
* Filters the object subtype identifier for a non-standard object type.
*
* The dynamic portion of the hook name, `$object_type`, refers to the meta object type
* (post, comment, term, user, or any other type with an associated meta table).
*
* Possible hook names include:
*
* - `get_object_subtype_post`
* - `get_object_subtype_comment`
* - `get_object_subtype_term`
* - `get_object_subtype_user`
*
* @since 4.9.8
*
* @param string $object_subtype Empty string to override.
* @param int $object_id ID of the object to get the subtype for.
*/
return apply_filters( "get_object_subtype_{$object_type}", $object_subtype, $object_id );
}
Fonctions utilisées par get_object_subtype()
get_user_by()
Retourne les informations d'un utilisateur par un champ donné.
get_term()
Retourne toutes les données d'un terme en donnant son ID.
apply_filters()
Appel les fonctions qui ont été attaché à un filtre (hook).
get_post_type()
Reçoit le type de poste d'un poste actuel ou d'un post donné.
get_comment()
Reçoit les données d'un commentaire en donnant l'id ou l'objet d'un commentaire.
Hook utilisé par get_object_subtype()
get_object_subtype_object_type
Filtre l'identifiant du sous-type de l'objet pour un type d'objet non standard.
Où est utilisée la fonction get_object_subtype()
dans le CMS WordPress
Sources
Codex WordPress : get_object_subtype()
Autres fonctions dans le même fichier : wp-includes/meta.php