WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/get post custom

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Описание

Возвращает многомерный массив, содержащий все произвольные поля конкретной записи или страницы. См. так же get_post_custom_keys() and get_post_custom_values()

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

 <?php get_post_custom($post_id); ?> 

Параметры

$post_id
(integer) (optional) ID записи, пользовательские поля которой должны возвращаться.
Default: Текущая запись

Примеры

Стандартное применение

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

<?php $custom_fields = get_post_custom(); ?>

Получение данных из массива

Возвращает все значения произвольных полей с ключом my_custom_field, принадлежащих записи с ID 72 (предполагая, что существует три произвольных полей с этим ключом, а их значения - "собаки", "47" и "Это другое значение").

<?php

  $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 => собаки
1 => 47
2 => Это другое значение

Примечание: not only does the function return a multi-dimensional array (ie: always be prepared to deal with an array of arrays, even if expecting array of single values), but if also returns serialized values of any arrays stored as meta values. If you expect that possibly an array may be stored as a metavalue, then be prepared to 'maybe_unserialize'.

Исходный файл

get_post_custom() объявляется в wp-includes/post.php

История изменений

  • появилась в версии 1.5.0

Схожее

Custom Fields: the_meta(), get_post_meta(), add_post_meta(), update_post_meta(), delete_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys() (See Also: post_meta Function Examples)

See also index of Function Reference and index of Template Tags.