wp_update_attachment_metadata()
Оновлює метадані вкладення (медіафайл).
Для кожного медіафайлу записуються метадані. Розташовані вони у таблиці wp_postmeta
під ключем _wp_attachment_metadata
у вигляді серіалізованого масиву.
Оновлені дані – це масив даних про файл. Якщо вам потрібно оновити якийсь конкретний елемент масиву, спочатку отримаєте наявні дані за допомогою wp_get_attachment_metadata() , змініть отриманий масив і збережіть дані.
Основа для:
wp_maybe_generate_attachment_metadata() ,
media_handle_sideload() ,
media_handle_upload()
wp_maybe_generate_attachment_metadata() ,
media_handle_sideload() ,
media_handle_upload()
Хуки з функції
wp_update_attachment_metadata($post_id, $data);
-
$post_id
(число) (обов’язковий) - ID медіафайлу (вкладення), метадані якого потрібно оновити.
-
$data
(масив) (обов’язковий) - Дані, які будуть записані замість наявних.
Приклади
#1 Оновимо підпис картинки
Давайте додамо свої дані до зображення з ID 656. Для цього спочатку отримаємо метадані, змінимо їх (додамо свої дані) і збережемо:
$attach_id = 656;
// Отримуємо дані
$data = wp_get_attachment_metadata( $attach_id );
// встановлюємо підпис
$data['image_meta']['my_data'] = 'Цей рядок даних, який мені буде потрібний';
// оновлюємо дані
if( wp_update_attachment_metadata( $attach_id, $data ) )
echo "Оновлено";
else
echo "Не оновлено";
Тут при отриманні даних $data дорівнював:
Array
(
[width] => 356
[height] => 299
[file] => 2011/05/dinamic-archives.png
[sizes] => Array
(
[thumbnail] => Array
(
[file] => dinamic-archives-80x80.png
[width] => 80
[height] => 80
[mime-type] => image/png
)
[medium] => Array
(
[file] => dinamic-archives-120x100.png
[width] => 120
[height] => 100
[mime-type] => image/png
)
)
[image_meta] => Array
(
[aperture] => 0
[credit] =>
[camera] =>
=>
[created_timestamp] => 0
[copyright] =>
[focal_length] => 0
[iso] => 0
[shutter_speed] => 0
[title] =>
)
)
список змін
З версії 2.1.0 | Введено. |