WordPress模板中复用父文章子文章展示代码的最优方案咨询

不需要重复编写代码，只需要对现有功能进行参数化改造或封装可复用函数，就能在模板多处调用不同父ID的子文章展示功能。以下是两种可行方案：

方案一：参数化现有短代码函数 #

修改你的vd_list_child_pages短代码，让它支持接收parent_id参数，同时保留默认逻辑（比如默认显示当前页面的子文章）。这样在模板不同位置调用时，只需传入不同的父ID即可。

改造后的短代码示例： #

function vd_list_child_pages($atts) {
    // 处理短代码参数，设置默认值
    $args = shortcode_atts( array(
        'parent_id' => get_the_ID(), // 默认当前页面ID，可改成固定值
        'posts_per_page' => 5 // 固定显示5条，匹配需求
    ), $atts );

    // 查询子文章
    $child_pages = new WP_Query(array(
        'post_type' => 'page', // 如果是文章类型改成'post'
        'post_parent' => $args['parent_id'],
        'posts_per_page' => $args['posts_per_page'],
        'orderby' => 'menu_order', // 可按需调整排序方式
        'order' => 'ASC'
    ));

    // 生成输出HTML
    $output = '';
    if ($child_pages->have_posts()) {
        $output .= '<ul class="child-pages-list">';
        while ($child_pages->have_posts()) {
            $child_pages->the_post();
            $output .= sprintf(
                '<li><a href="%s">%s</a></li>',
                get_permalink(),
                get_the_title()
            );
        }
        $output .= '</ul>';
        wp_reset_postdata(); // 重置查询，避免影响后续内容
    }

    return $output;
}
add_shortcode('vd_list_child_pages', 'vd_list_child_pages');

模板中调用方式： #

在需要展示的位置，通过do_shortcode传入不同的parent_id参数：

// 展示父ID为10的子文章
echo do_shortcode('[vd_list_child_pages parent_id="10"]');

// 展示父ID为25的子文章
echo do_shortcode('[vd_list_child_pages parent_id="25"]');

方案二：封装独立可复用函数（更高效） #

如果仅在模板文件中调用，可跳过短代码解析的开销，直接封装一个接收参数的函数，在模板中直接调用：

封装函数示例： #

function vd_get_child_pages($parent_id, $posts_per_page = 5) {
    $child_pages = new WP_Query(array(
        'post_type' => 'page',
        'post_parent' => $parent_id,
        'posts_per_page' => $posts_per_page,
        'orderby' => 'menu_order',
        'order' => 'ASC'
    ));

    $output = '';
    if ($child_pages->have_posts()) {
        $output .= '<ul class="child-pages-list">';
        while ($child_pages->have_posts()) {
            $child_pages->the_post();
            $output .= sprintf(
                '<li><a href="%s">%s</a></li>',
                get_permalink(),
                get_the_title()
            );
        }
        $output .= '</ul>';
        wp_reset_postdata();
    }

    return $output;
}

模板中调用方式： #

直接传入父ID调用函数即可：

// 展示父ID为10的子文章
echo vd_get_child_pages(10);

// 展示父ID为25的子文章，也可自定义条数（可选）
echo vd_get_child_pages(25, 3);

方案优势 #

两种方案都实现了一次编写、多处复用，后续如果需要调整展示逻辑（比如修改HTML结构、调整排序方式），只需修改这一个函数即可，无需在多个模板位置重复修改，极大提升维护效率。

内容的提问来源于stack exchange，提问作者itsme.vitali