Kama3.5 лет назад6 EN

delete_post_meta() │ WP 1.5.0

Удалят все произвольные поля (метаполя) с указанным ключом у указанной записи (поста).

Используйте delete_post_meta_by_key(), чтобы удалить мета-поля по ключу, у всех постов.

Работает на основе: delete_metadata()
Основа для: update_attached_file(), set_post_thumbnail(), wp_update_attachment_metadata()

Хуков нет.

Возвращает

true|false. true при успешном удалении, false в противном случае.

Использование

delete_post_meta( $post_id, $key, $value );
$post_id(число) (обязательный)
ID поста, произвольные поля которого нужно удалить.
$key(строка) (обязательный)
Ключ произвольного поля, которое нужно удалить.
$value(строка)
Значения произвольного поля, которое нужно удалить. Указание этого параметра может пригодится, когда у поста имеются несколько произвольных полей с одинаковыми ключами. Если оставить поле пустым, то все произвольные поля с указанным ключом будут удалены.
По умолчанию: ''

Примеры

0

#1 Демонстрация удаления метаполей 

// удалим все произвольные поля с ключом `my_key`, у поста 76
delete_post_meta( 76, 'my_key' );

// удалим все произвольные поля `my_key` со значением `Steve`:
delete_post_meta( 76, 'my_key', 'Steve' );
0

#2 Удаление указанных метаполей (произвольных полей)

Предположим, что мы использовали плагин, который добавлял произвольные поля к каждому посту, а теперь мы от этого плагина отказались и нам нужно удалить все произвольные поля, которые были созданы этим плагином.

Плагин создавал поля с ключами: keys related_posts и post_inspiration

Чтобы удалить все эти произвольные поля, можно воспользоваться таким кодом:

$allposts = get_posts( 'numberposts=-1&post_type=post&post_status=any' );

foreach( $allposts as $postinfo) {
	delete_post_meta( $postinfo->ID, 'related_posts' );
	delete_post_meta( $postinfo->ID, 'post_inspiration' );
}
0

#3 Удаление произвольных полей с исключениями

Допустим, нужно удались все произвольные поля post_inspiration, кроме тех, значение которых равно Sherlock Holmes, используем такой код:

$allposts = get_posts( 'numberposts=-1&post_type=post&post_status=any' );

foreach( $allposts as $postinfo ) {
	$inspiration = get_post_meta( $postinfo->ID, 'post_inspiration' );

	foreach( $inspiration as $value ) {
		if( $value != 'Sherlock Holmes' )
			delete_post_meta( $postinfo->ID, 'post_inspiration', $value );
	}
}
0

#4 Пример удаления всех метаполей у определенного поста

Вариант 1:

$post_id = 25;
foreach ( get_post_meta( $post_id ) as $key => $val ) {
	delete_post_meta( $post_id, $key );
}

Вариант 2 (быстрее - одним запросом и без лишних операций):

$post_id = 25;
global $wpdb;
$wpdb->delete( $wpdb->postmeta, [ 'post_id'=>$post_id ] );
clean_post_cache( $post_id );
0

#5 Другие примеры

Еще примеры смотрите здесь.

Список изменений

С версии 1.5.0 Введена.

Код delete_post_meta() WP 6.9

wp-includes/post.php 
function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
	// Make sure meta is deleted from the post, not from a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return delete_metadata( 'post', $post_id, $meta_key, $meta_value );
}

metadata (метаданные)

6 комментариев