get_post_custom_values()
Получает массив значений произвольных полей с указанным названием у указанной записи (поста).
Эта функция может пригодится, если нужно получить значение произвольного поля, когда у поста имеются несколько полей с одинаковыми названиями ключей и разными значениями. В противном случае, удобнее использовать функцию get_post_meta().
Работает на основе: get_post_custom()
Хуков нет.
Возвращает
Массив|null
. Массив значений мета-полей.
Использование
get_post_custom_values( $key, $post_id );
- $key(строка) (обязательный)
- Название произвольного поля (ключ произвольного поля), значения которого нужно получить.
- $post_id(число)
- ID поста, произвольные поля которого нужно получить.
По умолчанию: Текущий пост (определяется по переменной $post)
Примеры
#1 Выведем значения произвольных полей на экран
Предположим, что текущий пост имеет 3 произвольных поля с одинаковым ключом my_key
, давайте выведем их на экран используя get_post_custom_values
:
$mykey_values = get_post_custom_values('my_key'); foreach( $mykey_values as $key => $value ) { echo "$key => $value ('my_key')<br />"; }
В результате на экране мы увидим:
0 => первое значение ключа 'my_key'
1 => второе значение ключа 'my_key'
2 => третье значение ключа 'my_key'
Список изменений
С версии 1.2.0 | Введена. |
Код get_post_custom_values() get post custom values WP 6.4.3
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; }