delete_metadata_by_mid( string $meta_type, int $meta_id )
Supprime une méta-donnée en passant son id.
Paramètres
$meta_type(string)requisType d'objet. Accepte 'post', 'comment', 'term', 'user' ou tout autre type d'objet associé à une table de méta-donnée.
$meta_id(int)requisId de la méta-donnée.
Retourne
(bool) True si supprimée avec succès, false sinon.
Déclaration et structure de la fonction delete_metadata_by_mid()
delete_metadata_by_mid() est déclarée dans le fichier wp-includes/meta.php à la ligne 984 :
function delete_metadata_by_mid( $meta_type, $meta_id ) {
global $wpdb;
// Make sure everything is valid.
if ( ! $meta_type || ! is_numeric( $meta_id ) || floor( $meta_id ) != $meta_id ) {
return false;
}
$meta_id = (int) $meta_id;
if ( $meta_id <= 0 ) {
return false;
}
$table = _get_meta_table( $meta_type );
if ( ! $table ) {
return false;
}
// Object and ID columns.
$column = sanitize_key( $meta_type . '_id' );
$id_column = ( 'user' === $meta_type ) ? 'umeta_id' : 'meta_id';
/**
* Short-circuits deleting metadata of a specific type by meta ID.
*
* The dynamic portion of the hook name, `$meta_type`, refers to the meta object type
* (post, comment, term, user, or any other type with an associated meta table).
* Returning a non-null value will effectively short-circuit the function.
*
* Possible hook names include:
*
* - `delete_post_metadata_by_mid`
* - `delete_comment_metadata_by_mid`
* - `delete_term_metadata_by_mid`
* - `delete_user_metadata_by_mid`
*
* @since 5.0.0
*
* @param null|bool $delete Whether to allow metadata deletion of the given type.
* @param int $meta_id Meta ID.
*/
$check = apply_filters( "delete_{$meta_type}_metadata_by_mid", null, $meta_id );
if ( null !== $check ) {
return (bool) $check;
}
// Fetch the meta and go on if it's found.
$meta = get_metadata_by_mid( $meta_type, $meta_id );
if ( $meta ) {
$object_id = (int) $meta->{$column};
/** This action is documented in wp-includes/meta.php */
do_action( "delete_{$meta_type}_meta", (array) $meta_id, $object_id, $meta->meta_key, $meta->meta_value );
// Old-style action.
if ( 'post' === $meta_type || 'comment' === $meta_type ) {
/**
* Fires immediately before deleting post or comment metadata of a specific type.
*
* The dynamic portion of the hook name, `$meta_type`, refers to the meta
* object type (post or comment).
*
* Possible hook names include:
*
* - `delete_postmeta`
* - `delete_commentmeta`
* - `delete_termmeta`
* - `delete_usermeta`
*
* @since 3.4.0
*
* @param int $meta_id ID of the metadata entry to delete.
*/
do_action( "delete_{$meta_type}meta", $meta_id );
}
// Run the query, will return true if deleted, false otherwise.
$result = (bool) $wpdb->delete( $table, array( $id_column => $meta_id ) );
// Clear the caches.
wp_cache_delete( $object_id, $meta_type . '_meta' );
/** This action is documented in wp-includes/meta.php */
do_action( "deleted_{$meta_type}_meta", (array) $meta_id, $object_id, $meta->meta_key, $meta->meta_value );
// Old-style action.
if ( 'post' === $meta_type || 'comment' === $meta_type ) {
/**
* Fires immediately after deleting post or comment metadata of a specific type.
*
* The dynamic portion of the hook name, `$meta_type`, refers to the meta
* object type (post or comment).
*
* Possible hook names include:
*
* - `deleted_postmeta`
* - `deleted_commentmeta`
* - `deleted_termmeta`
* - `deleted_usermeta`
*
* @since 3.4.0
*
* @param int $meta_id Deleted metadata entry ID.
*/
do_action( "deleted_{$meta_type}meta", $meta_id );
}
return $result;
}
// Meta ID was not found.
return false;
}
Fonctions utilisées par delete_metadata_by_mid()
wp_cache_delete()Supprime les contenus du cache correspondant à la clé et au groupe.
sanitize_key()Nettoie une clé de type chaîne.
apply_filters()Appel les fonctions qui ont été attaché à un filtre (hook).
do_action()Exécute des fonctions attachées à un hook spécifique.
_get_meta_table()Retourne le nom d'une table de méta-donnée pour un type d'objet spécifié.
get_metadata_by_mid()Retourne un objet de méta-donnée par son id.
Hooks utilisés par delete_metadata_by_mid()
delete_meta_type_metadata_by_midCourt-circuite la méta-donnée à supprimer d'un type spécifique par son id.
delete_meta_type_metaSe lance immédiatement avant la méta-donnée d'un type spécifique à supprimer.
delete_meta_typemetaSe lance immédiatement avant une méta-donnée de poste ou de commentaire à supprimer.
deleted_meta_type_metaSe lance immédiatement après qu'une méta-donnée d'un type spécifique soit supprimée.
deleted_meta_typemetaSe lance immédiatement après qu'une méta-donnée de poste ou de commentaire soit supprimée.
Où est utilisée la fonction delete_metadata_by_mid()
dans le CMS WordPress
Sources
Codex WordPress : delete_metadata_by_mid()
Autres fonctions dans le même fichier : wp-includes/meta.php