WordPress自定义最新文章函数问题求助：内容HTML标签为空

Hey there! Let's dig into why your last_article() function is only spitting out featured images and leaving that .content div empty. I’ve run into this exact issue a few times—here are the most likely culprits and how to fix them:

1. 文章查询参数限制了字段返回 #

If you’re using WP_Query with a fields parameter (like fields => 'ids') to only fetch post IDs, WordPress won’t pull in the title, content, or other metadata you need for the .content section. This is a super easy mistake to make!

Fix: Remove any restrictive fields parameters from your query, or explicitly include the fields you need. Here’s a clean, complete example of the function:

function last_article() {
    // Set up query for the latest published post
    $args = array(
        'posts_per_page' => 1,
        'post_status' => 'publish',
        'orderby' => 'date',
        'order' => 'DESC'
    );
    $latest_post = new WP_Query($args);

    if ($latest_post->have_posts()) {
        // Use output buffering to capture all HTML
        ob_start();
        while ($latest_post->have_posts()) {
            $latest_post->the_post(); // Critical: sets up global post data
            ?>
            <div class="latest-article">
                <?php if (has_post_thumbnail()) : ?>
                    <div class="featured-image">
                        <?php the_post_thumbnail('medium'); ?>
                    </div>
                <?php endif; ?>
                <div class="content">
                    <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
                    <div class="article-excerpt"><?php the_excerpt(); ?></div>
                    <p><a href="<?php the_permalink(); ?>" class="read-more">Read Full Article</a></p>
                </div>
            </div>
            <?php
        }
        $output = ob_get_clean();
        wp_reset_postdata(); // Reset global post data to avoid conflicts
        return $output;
    } else {
        return '<p>No recent articles found.</p>';
    }
}

2. You’re not using WordPress template tags correctly #

If you tried manually building the .content HTML without using functions like the_title() or get_the_excerpt(), you might have forgotten to actually fetch the content data. For example, writing <div class="content"><?php echo $content; ?></div> when $content was never defined will leave the div empty.

Fix: Use WordPress’s built-in template tags to pull post data, or use the get_* variants if you want to store values in variables:

// Example: Storing values in variables for manual HTML building
$post_title = get_the_title();
$post_excerpt = get_the_excerpt();
$post_link = get_permalink();

$output .= '<div class="content">';
$output .= "<h3><a href='$post_link'>$post_title</a></h3>";
$output .= "<div class='excerpt'>$post_excerpt</div>";
$output .= '</div>';

3. 输出缓冲或返回值处理错误 #

If your function was directly echoing HTML instead of capturing it and returning it, calling echo last_article() could cause partial output or empty sections. WordPress relies on proper output handling to avoid conflicts with other template code.

Fix: Use ob_start() and ob_get_clean() (like in the first example) to capture all generated HTML, then return that captured string. This ensures everything gets output correctly when you call echo last_article().

4. 忘记重置全局文章查询 #

If you skip calling wp_reset_postdata() after your custom query, it can mess up WordPress’s global $post variable, leading to missing content in subsequent template tags.

Fix: Always add wp_reset_postdata() right after your loop finishes, as shown in the first code example.

Quick Debugging Tip #

If you’re still stuck, add var_dump($latest_post->posts[0]); inside your function right after the query. This will show you exactly what data WordPress is returning. If the title, content, or excerpt fields are missing, your query parameters are the problem.

内容的提问来源于stack exchange，提问作者omid mirzaei