get_post_custom() │ WP 1.2.0

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

Вместо этой функции можно использовать get_post_meta( $post_id ). Разница между ними в том, что get_post_meta() нужно передавать ID записи, а эта функция получит ID текущей записи автоматически, если не передать $post_id.

Работает на основе: get_post_meta()
Основа для: get_post_custom_values(), get_post_custom_keys()

Хуков нет.

Возвращает

Разное. Метаданные поста.

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

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

Примеры

0

#1 Получим все произвольные поля записи

Используйте следующий пример, чтобы передать в переменную $custom_fields все данные о произвольных полях текущего поста.

$custom_fields = get_post_custom();
0

#2 Получим одинаковые метаполя записи с разными значениями

Получим значения произвольных полей с ключом my_custom_field у поста 72 (подразумевается что у поста таких полей 3 со значениями "dogs", "47" и "селфи" )

$custom_fields = get_post_custom(72);
$my_custom_field = $custom_fields['my_custom_field'];
foreach ( $my_custom_field as $key => $value ){
	echo $key . " => " . $value . "<br />";
}

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

0 => dogs
1 => 47
2 => селфи
0

#3 Еще примеры

Смотрите здесь.

Список изменений

С версии 1.2.0 Введена.

Код get_post_custom() WP 6.5.2

wp-includes/post.php 
function get_post_custom( $post_id = 0 ) {
	$post_id = absint( $post_id );

	if ( ! $post_id ) {
		$post_id = get_the_ID();
	}

	return get_post_meta( $post_id );
}

metadata (метаданные)