get_post_custom_values с версии 1.2.0

Описание

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

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

get_post_custom_values() работает на базе get_post_custom().

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

<?php get_post_custom_values($key, $post_id); ?>

Параметры

$key

(строка) (обязательный) Название произвольного поля (ключ произвольного поля), значения которого нужно получить.
По умолчанию: нет

$post_id

(число) ID поста, произвольные поля которого нужно получить.
По умолчанию: Текущий пост (определяется по переменной $post)

Примеры

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

<?php
  $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'

get_post_custom_values()

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 и Теги Шаблона.