Функция update_post_meta()
в WordPress используется для добавления или обновления метаданных поста. Метаданные поста — это дополнительная информация, связанная с постом, такая как произвольные поля.
update_post_meta( int $post_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' )
$post_id
(int): ID поста, для которого обновляются метаданные.$meta_key
(string): Ключ метаданных, который вы хотите добавить или обновить.$meta_value
(mixed): Новое значение метаданных.$prev_value
(optional, mixed): Предыдущее значение метаданных, если вы хотите обновить только если текущее значение совпадает с этим значением. По умолчанию пусто.
Возвращаемое значение
- (int|bool): ID метаданных, если успешно добавлено,
true
в случае успешного обновления,false
в случае ошибки.
Пример
$post_id = 123;
$meta_key = 'my_custom_field';
$meta_value = 'This is my custom value';
update_post_meta( $post_id, $meta_key, $meta_value );
Заключение:
Функция update_post_meta()
является мощным инструментом для работы с метаданными постов в WordPress. Она позволяет легко добавлять или обновлять произвольные сведения, связанные с постами, что открывает широкие возможности для расширения функциональности сайта.