动态获取并显示WordPress首页特色图片：跨页面引用指南

<?php
// 获取被设置为静态首页的页面ID
$home_page_id = get_option('page_on_front');

// 检查是否成功获取到首页ID
if ( ! $home_page_id ) {
    // 如果没有设置静态首页，则可能需要其他处理，例如获取最近的文章页面或直接返回
    // 对于大多数情况，如果网站配置了静态首页，这里会返回一个有效的ID
    echo '网站未设置静态首页。';
    return;
}
?>

<?php
// 假设 $home_page_id 已经从上一步获取
$home_page_thumbnail_id = get_post_thumbnail_id($home_page_id);

// 检查首页是否设置了特色图片
if ( ! $home_page_thumbnail_id ) {
    echo '首页未设置特色图片。';
    return;
}
?>

<?php
// 假设 $home_page_thumbnail_id 已经从上一步获取
// 'large' 是一个常见的图片尺寸，您也可以使用 'thumbnail', 'medium', 'full' 或自定义尺寸
echo wp_get_attachment_image($home_page_thumbnail_id, 'large');
?>

<?php
// 假设 $home_page_thumbnail_id 已经从上一步获取
$image_attributes = wp_get_attachment_image_src($home_page_thumbnail_id, 'full'); // 获取完整尺寸的图片URL

if ( $image_attributes ) {
    $image_url = $image_attributes[0]; // 数组的第一个元素是图片URL
    ?>
    <img src="<?php echo esc_url($image_url); ?>" alt="首页特色图片" class="homepage-featured-image">
    <?php
} else {
    echo '无法获取首页特色图片URL。';
}
?>

<?php
/**
 * 获取并显示WordPress静态首页的特色图片。
 *
 * @param string $size 图片尺寸，默认为 'large'。
 * @param bool   $return_url_only 是否只返回URL，默认为 false（返回完整<img>标签）。
 * @return string|void 返回图片URL或<img>标签，或在未找到时返回空字符串。
 */
function get_homepage_featured_image( $size = 'large', $return_url_only = false ) {
    // 1. 获取静态首页的ID
    $home_page_id = get_option('page_on_front');

    if ( ! $home_page_id ) {
        return ''; // 未设置静态首页
    }

    // 2. 获取首页特色图片的ID
    $home_page_thumbnail_id = get_post_thumbnail_id($home_page_id);

    if ( ! $home_page_thumbnail_id ) {
        return ''; // 首页未设置特色图片
    }

    // 3. 根据需求返回图片URL或完整<img>标签
    if ( $return_url_only ) {
        $image_attributes = wp_get_attachment_image_src($home_page_thumbnail_id, $size);
        if ( $image_attributes ) {
            return esc_url($image_attributes[0]); // 返回图片URL
        }
    } else {
        return wp_get_attachment_image($home_page_thumbnail_id, $size); // 返回完整<img>标签
    }

    return ''; // 默认返回空字符串
}

// 在您的自定义模板文件（例如 about.php 或 page-about.php）中使用
?>

<!-- 示例 1: 显示完整的<img>标签 -->
<div class="about-page-hero">
    <?php echo get_homepage_featured_image('full'); ?>
</div>

<!-- 示例 2: 仅获取URL并用于自定义HTML或CSS背景 -->
<?php
$homepage_image_url = get_homepage_featured_image('large', true);
if ( $homepage_image_url ) {
    ?>
    <div class="about-section-background" style="background-image: url('<?php echo $homepage_image_url; ?>');">
        <h2>关于我们</h2>
        <p>这是我们公司的简介，背景图片来自首页。</p>
    </div>
    <?php
}
?>