Функция GET_POST_PARENT() │ WP 5.7.0

Функция get_post_parent() возвращает объект родительского поста для указанного поста в WordPress.

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

Функция полагается на get_post().

Возврат

• Возвращает объект родительского поста типа WP_Post, или null, если родительского поста нет.

Синтаксис

get_post_parent( $post );

Параметры

• $post (int|WP_Post|null) — ID поста или объект WP_Post.
  • По умолчанию: используется глобальная переменная $post.

Примеры

Пример 1: Вывод заголовка родительского поста

$child_post_id = 5; // ID дочернего поста, например 5
$parent_post = get_post_parent( $child_post_id );

if ( $parent_post ) {
    echo 'Заголовок родительского поста: ' . get_the_title( $parent_post );
} else {
    echo 'У указанного поста нет родительского поста.';
}

Примечание

Если у поста нет родителя, функция get_post_parent() вернет null.

Изменения

• С версии 5.7.0 — Введена функция get_post_parent().

Код функции GET_POST_PARENT()

Файл wp-includes/post-template.php

function get_post_parent( $post = null ) {
    $wp_post = get_post( $post );
    return ! empty( $wp_post->post_parent ) ? get_post( $wp_post->post_parent ) : null;
}

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

• comments_open()
• get_extended()
• get_lastpostdate()
• get_lastpostmodified()
• get_post_embed_html()
• get_post_embed_url()
• get_post_stati()
• get_post_status_object()
• get_post_statuses()
• get_post_timestamp()
• has_post_parent()
• is_sticky()
• pings_open()
• post_exists()
• sanitize_post()
• the_shortlink()
• url_to_postid()
• wp_embed_register_handler()
• WP_Embed::delete_oembed_caches()
• wp_get_canonical_url()
• wp_get_shortlink()
• wp_oembed_add_provider()
• wp_transition_post_status()

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