get_post_custom_values

Возвращает массив значений произвольных полей с определенным названием у определенного поста.

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

Хуков нет.

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

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’

Код из


wp-includes/post.php

WP 4.7.2

<?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;
}