WordPress文章附件文件获取完整路径及下载链接问题

Hey there, the problem here is that get_attachment_link() doesn’t return a direct file download URL—it generates the permalink to the attachment’s own dedicated page (like a standard post page for your file). That’s why you’re not getting the full path needed to let users download the file directly.

Here’s a revised version of your code that fixes this by grabbing the actual file URL from the post’s attached media:

<?php 
$reports = array( 
    'post_type' => 'post', 
    'posts_per_page' => 3, 
    'category_name' => 'reports'
); 
$q_reports = new WP_Query($reports); 

if($q_reports->have_posts()){ 
    while($q_reports->have_posts()){ 
        $q_reports->the_post();
        
        // Fetch all file attachments linked to the current post
        $attachments = get_attached_media('file', get_the_ID());
        $download_url = '';
        
        // If there are attachments, grab the first one's direct URL
        if (!empty($attachments)) {
            $first_attachment = reset($attachments);
            $download_url = wp_get_attachment_url($first_attachment->ID);
        }
        ?> 
        <li>
            <?php if ($download_url): ?>
                <!-- Use esc_url() for security, add 'download' to trigger file download -->
                <a href="<?php echo esc_url($download_url); ?>" download><?php the_title(); ?></a>
            <?php else: ?>
                <?php the_title(); ?> (No file attached)
            <?php endif; ?>
            Published: <?php the_date(); ?>
        </li>
    <?php } 
    // Reset post data to restore original query context
    wp_reset_postdata();
} ?>

Key details about the fix: #

• get_attached_media('file', get_the_ID()): Pulls all file-type attachments associated with the current post. You can narrow this down to specific types (like 'pdf' or 'docx') if you only want certain files.
• wp_get_attachment_url(): This is the function that returns the direct, full-path URL to the file itself—exactly what you need for a download link.
• The download attribute on the <a> tag tells browsers to download the file instead of opening it in the browser tab (optional but user-friendly for downloads).
• esc_url() sanitizes the URL to prevent security issues, which is a best practice in WordPress development.
• wp_reset_postdata(): Always include this after custom WP_Query loops to reset the global post context back to the original page/post.

内容的提问来源于stack exchange，提问作者Nirdosh Shrestha