GET_POST_CUSTOM_VALUES() │ WP 1.2.0

Функция для получения значений пользовательского поля поста.

Описание

Эта функция позволяет вам получить значения для заданного поля метаданных поста (пользовательского поля). Параметры функции обязательны к указанию, и она возвращает только значения ключей метаполей.

Использует: get_post_custom()

Не использует хуки.

Возвращаемое значение

Функция возвращает массив или null. В случае, если значения для указанного ключа нет, вернется null.

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

get_post_custom_values( $key, $post_id );

• $key (строка) — ключ метаполя.
  • По умолчанию: ''
• $post_id (число) — ID поста.
  • По умолчанию: ID глобального $post

Примеры

Пример 1: Вывод значений пользовательских полей на экран

Предположим, текущий пост имеет 3 пользовательских поля с одинаковым ключом my_key. Выведем их значения на экран:

$mykey_values = get_post_custom_values('my_key');

foreach( $mykey_values as $key => $value ) {
    echo "$key  => $value ('my_key')
";
}

В результате мы увидим на экране:

0 => первое значение 'my_key'
1 => второе значение 'my_key'
2 => третье значение 'my_key'

Добавьте свой собственный пример

Вы можете дополнить этот раздел собственными примерами ис��ользования функции.

Изменения

• С версии 1.2.0 — Функция была добавлена в WordPress.

Код функции

Вот как выглядит код функции get_post_custom_values в файле wp-includes/post.php:

function get_post_custom_values( $key = '', $post_id = 0 ) {
if ( ! $key ) {
return null;
}

$custom = get_post_custom( $post_id );

return isset( $custom[ $key ] ) ? $custom[ $key ] : null;

}

Связанные функции

Большое количество функций для работы с метаданными в WordPress:

• add_comment_meta()
• add_metadata()
• add_post_meta()
• add_term_meta()
• add_user_meta()
• delete_comment_meta()
• delete_metadata()
• delete_post_meta()
• delete_post_meta_by_key()
• delete_term_meta()
• delete_user_meta()
• get_comment_meta()
• get_metadata()
• get_post_custom()
• get_post_custom_keys()
• get_post_meta()
• get_site_meta()
• get_term_meta()
• get_the_author_meta()
• get_user_meta()
• has_term_meta()
• is_protected_meta()
• register_meta()
• register_post_meta()
• register_term_meta()
• sanitize_meta()
• the_author_meta()
• update_comment_meta()
• update_metadata()
• update_post_meta()
• update_term_meta()
• update_user_meta()
• wp_read_image_metadata()

Эти функции помогут вам эффективно работать с метаданными вашего поста.