如何在 WordPress 消息中安全嵌入超链接-html教程-PHP中文网

如何在 WordPress 消息中安全嵌入超链接

WordPress 的翻译函数 __() 默认会转义 HTML，但通过 sprintf() 结合未转义的 HTML 字符串（需确保内容可信），可将消息中的纯文本（如“contact us”）替换为可点击的超链接。

wordpress 的翻译函数 `__()` 默认会转义 html，但通过 `sprintf()` 结合未转义的 html 字符串（需确保内容可信），可将消息中的纯文本（如“contact us”）替换为可点击的超链接。

在 WordPress 插件或主题开发中，常需动态修改系统提示消息（例如 WooCommerce 订单校验失败时的提示）。默认情况下，__() 函数仅返回纯文本，直接在翻译字符串中写标签会被原样输出或被过滤，无法渲染为有效链接。正确做法是分离可翻译文本与 HTML 结构，利用 sprintf() 动态插入已构造好的 HTML 片段。

以下是推荐实现方式：

public function change_message( $message ) {
    // 1. 翻译链接锚文本（支持多语言）
    $contact_us = __( 'contact us', 'your-text-domain' );
    // 2. 构建安全链接（URL 应使用 esc_url() 防御 XSS）
    $link = '<a href="'%20.%20esc_url(%20'https://yoursite.com/contact'%20)%20.%20'" target="_blank" rel="noopener">' . esc_html( $contact_us ) . '</a>';
    // 3. 定义带占位符的翻译字符串（%s 将被链接替换）
    $format = __( 'Your order is too heavy. Please %s to get individual shipping cost.', 'your-text-domain' );
    // 4. 组合并返回最终消息
    return sprintf( $format, $link );
}

✅ 关键要点说明：