如何在 WordPress 子目录多站点中自动添加 hreflang 标签-php教程-PHP中文网

如何在 WordPress 子目录多站点中自动添加 hreflang 标签

本文介绍一种稳定、无需远程请求的方案，为 wordpress 子目录多站点（如 example.com/uk/、example.com/au/）自动注入符合 seo 规范的 hreflang 标签，支持排除特定自定义文章类型，并兼容访客缓存环境。

本文介绍一种稳定、无需远程请求的方案，为 wordpress 子目录多站点（如 example.com/uk/、example.com/au/）自动注入符合 seo 规范的 hreflang 标签，支持排除特定自定义文章类型，并兼容访客缓存环境。

在 WordPress 子目录型多站点（Subdirectory Multisite）架构中，为不同地区站点（如 /uk/、/au/）正确部署 hreflang 标签是实现国际化 SEO 的关键一环。原始方案依赖 get_headers() 进行 URL 可达性检测，虽逻辑直观，但在生产环境中极易因缓存、权限或响应延迟导致漏发标签（例如 UK 站首页在无登录态下缺失 en-gb 标签），且性能开销大、不可靠。

以下为优化后的推荐实现，已通过真实多站点环境验证：

WordPress API Pro

生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段

下载

✅ 推荐方案：静态路径映射 + 无网络请求

将语言站点与 hreflang 值硬编码为可信映射关系，彻底规避 HTTP 请求依赖，确保所有用户（含访客、CDN 缓存用户）均能获得完整、一致的标签。

function mm_add_hreflang_attribute() {
    // 排除 locations 自定义文章类型（单页 & 归档页）
    if (is_singular('locations') || is_post_type_archive('locations')) {
        return;
    }

    // 定义站点路径前缀与 hreflang 值的映射：[子目录路径, hreflang 值]
    $sites = array(
        array('', 'x-default'),      // 主站（example.com/）→ x-default（默认主语言版本）
        array('uk/', 'en-gb'),       // UK 站（example.com/uk/）→ en-gb
        array('au/', 'en-au'),       // AU 站（example.com/au/）→ en-au
    );

    // 获取当前页面路径（去除 home_url 基础路径，保留相对路径如 /features/ 或 /about/）
    $page_path = substr(get_permalink(), strlen(home_url('/')));

    // 遍历所有语言站点，生成对应 hreflang 标签
    foreach ($sites as $site) {
        $geo_subdir = $site[0];          // 如 'uk/'
        $hreflang   = $site[1];          // 如 'en-gb'
        $url        = network_site_url() . $geo_subdir . ltrim($page_path, '/');

        echo '<link rel="alternate" href="'%20.%20esc_url(%24url)%20.%20'" hreflang="' . esc_attr($hreflang) . '">' . PHP_EOL;
    }
}
add_action('wp_head', 'mm_add_hreflang_attribute', 1);