Cómo obtener todos los hijos y nietos de un tipo de contenido personalizado jerárquico

Tuve un requisito similar pero necesitaba preservar la jerarquía, así que la respuesta de Tom me dio un buen punto de partida:

function get_post_offspring($post)
{
    // Función para recorrer programáticamente los descendientes de un post

    // Obtener hijos directos del post actual
    // y agregarlos a un nuevo elemento del objeto llamado children
    $post->children = get_children(array("post_parent" => $post->ID, "post_type" => "page", "post_status" => "publish"));
    
    // si el post no tiene hijos, simplemente retornar el post con
    // children como un array vacío
    if (empty($post->children)) {
        return $post;
    }
    foreach ($post->children as $child) {
        // Por cada hijo de este post... obtener sus hijos
        $children = get_children(array("post_parent" => $child->ID, "post_type" => "page", "post_status" => "publish"));
        if (!empty($children)) {
            // si este post tiene hijos... entonces llamar esta función nuevamente
            // para asignar el elemento children a este post y seguir bajando
            // en la descendencia de este post

            $child = get_post_offspring($child);
        }
    }

    return $post;
}

También necesitaba recorrer la lista con un manteniendo el orden y nivel.

function render_list_items($children)
{
    foreach ($children as $child) {
        $has_children = !empty($child->children);

        echo "<li>";
        echo "<a href='" . get_permalink($child) . "'>" . $child->post_title . "</a";
        if ($has_children) {
            // Si el post tiene hijos, crear un nuevo <ul> dentro del
            // <li> actual y llamar la función nuevamente
            echo "<ul>";
            echo render_list_items($child->children);
            echo "</ul>";
        }

        echo "</li>";
    }

}

Entonces, para unirlo todo, tengo algo como:

global $post;

$post_id = $post->ID;

// Obtener ancestros del post actual donde el último elemento del array
// es el padre superior
$ancestors = get_post_ancestors($post->ID);

$root_id = array_pop($ancestors);
// Ahora tenemos el post raíz de este post y descendemos para obtener toda su descendencia
$root_post = get_post($root_id);

$root_children = get_post_offspring($root_post);

Simplemente usa get_page_children(). Funciona para cualquier tipo de publicación (no solo páginas) y es básicamente lo que @TomJNowell mostró en la otra pregunta, pero ya implementado por el núcleo de WordPress.

$children = get_page_children( $post->ID, $GLOBALS['wp_query'] );

El ejemplo anterior es como aparece en el Codex. Por eso puedes simplemente tomar el objeto de consulta global (o cualquier otro objeto de consulta) para usarlo como base de búsqueda.

Utiliza el siguiente shortcode para mostrar todos los hijos y nietos en una vista jerárquica. Uso: [my_children_list] o [my_children_list page_id=123]

function my_children_list_func($atts, $content = null) {
    global $post;

    $a = shortcode_atts( array(
            'page_id' => ''
    ), $atts );

    $args = array( 
            'numberposts' => -1, 
            'post_status' => 'publish', 
            'post_type' => 'microsite', 
            'post_parent' => (isset($a['page_id']) && $a['page_id']) ? $a['page_id'] : $post->ID,
            'suppress_filters' => false 
    );

    $parent = new WP_Query( $args );

    ob_start();

    if ( $parent->have_posts() ) :?>
            <ul>
            <?php while ( $parent->have_posts() ) : $parent->the_post(); ?>
                    <li><a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>"><?php the_title(); ?></a>
                    <?php echo do_shortcode('[tadam_children_list page_id='.get_the_ID().']') ?>
                    </li>
            <?php endwhile;?>
            </ul>
    <?php endif; wp_reset_postdata();

    return ob_get_clean();
}
add_shortcode( 'my_children_list', 'my_children_list_func' );

Por si alguien se encuentra con esto y decide implementar la respuesta elegida, get_pages() funciona con páginas y tipos de post jerárquicos. Por lo tanto, puedes usar get_pages() con el parámetro child_of.