Функция get_post_custom() │ WP 1.2.0

Функция get_post_custom() позволяет получить пользовательские мета-поля поста по его ID.

Эта функция оптимизирована для быстрого получения данных — если она вызывается несколько раз, данные берутся из кэша, если это возможно.

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

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

Возвращаемое значение

Функция возвращает массив значений. Если передан неверный ID поста (например, нечисловой, равный нулю или отрицательный), вернётся значение false. Если же передан корректный, но несуществующий ID поста, функция вернёт пустую строку.

Синтаксис

get_post_custom( $post_id );

• $post_id (int) — ID поста.
• По умолчанию: ID глобального поста $post.

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

Пример 1: Получение мета-полей поста с разными значениями

Предположим, у вас есть пост с ID 72, и у него есть 3 пользовательских поля с ключом my_custom_field, содержащие значения "dogs", "47" и "selfies". Вы можете получить эти значения следующим образом:

$custom_fields = get_post_custom( 72 );
$my_custom_field = $custom_fields['my_custom_field'];

foreach ( $my_custom_field as $key => $value ){
    echo $key . " => " . $value . "
";
}

Результат на экране:

0 => dogs
1 => 47
2 => selfies

Пример 2: Получение всех пользовательских полей поста

Чтобы получить все данные о пользовательских полях текущего поста, используйте следующий код:

$custom_fields = get_post_custom();

Выполнение функции

Вот как фактически реализована get_post_custom() в ядре WordPress:

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 );

}

Связанные функции

Существует множество функций, связанных с метаданными. Вот некоторые из них:

• add_comment_meta()
• add_post_meta()
• delete_post_meta()
• get_post_meta()
• get_comment_meta()

Эти функции помогают управлять пользовательскими мета-полями в WordPress, добавляя, удаляя или получая данные, связанные с постами, комментариями и другими объектами.

Теперь вы знаете, как использовать функцию get_post_custom() для работы с пользовательскими мета-полями в WordPress. Это полезный инструмент, который поможет вам более эффективно управлять вашими постами!