WooCommerce邮件自定义：文本格式与动态内容插入的挑战与解决方案-php教程-PHP中文网

WooCommerce邮件自定义：文本格式与动态内容插入的挑战与解决方案

霞舞

发布： 2025-10-05 13:46:10

原创

218人浏览过

WooCommerce邮件自定义：文本格式与动态内容插入的挑战与解决方案

本文探讨了在WooCommerce邮件中进行复杂文本格式化和动态内容插入的挑战，例如斜体字和订单号引用。我们将分析传统PHP代码实现这些功能的复杂性，特别是涉及wp_kses的安全过滤机制。最终，文章推荐使用专业的邮件构建器（如YayMail）作为更高效、更简便的解决方案，以实现美观且功能丰富的邮件模板，避免繁琐的PHP编码。

理解WooCommerce邮件自定义的挑战

在woocommerce中自定义邮件模板，尤其是需要插入特定格式的文本或动态数据时，可能会遇到一些挑战。开发者通常会直接修改主题或插件提供的邮件模板文件，使用php代码来控制输出。然而，这涉及到wordpress的安全机制，特别是wp_kses函数，它用于过滤html以防止跨站脚本攻击（xss）。

例如，当尝试在邮件中实现以下布局时：

在第一段中将特定短语（如“The Versatile Home”）设置为斜体。
添加一个包含银行转账信息的第二段，并动态引用订单号作为参考。

原始的PHP尝试可能如下所示：

<?php if ( $order->needs_payment() ) { ?>
    <p>
    <?php
    printf(
        wp_kses(
            /* translators: %1$s Site title, %2$s Order pay link */
            __( 'We’re delighted to let you know that the first print of <i>The Versatile Home</i> is now available and we are able to fulfil your pre-order. Your invoice is below and here is a link to make payment: %2$s', 'woocommerce' ),
            array(
                'a' => array(
                    'href' => array(),
                ),
            )
        ),
        esc_html( get_bloginfo( 'name', 'display' ) ),
        '<a href="' . esc_url( $order->get_checkout_payment_url() ) . '">' . esc_html__( 'click here to pay by credit/debit card or PayPal', 'woocommerce' ) . '</a>'
    );
    ?>
    </p>
<?php } ?>

登录后复制

在这个示例中，<i>标签未能正确渲染斜体效果，并且第二段内容及其中的动态订单号也无法直接添加。这主要是因为wp_kses函数默认或根据提供的白名单，移除了未被允许的HTML标签。

传统PHP方法处理复杂格式与动态内容

要使用纯PHP代码实现上述需求，需要对wp_kses的工作原理有深入理解，并掌握如何正确地构建和拼接HTML字符串。

1. 允许特定HTML标签（如斜体）

wp_kses函数接受一个允许的HTML标签及其属性的数组作为第二个参数。如果需要显示<i>标签，必须将其明确添加到允许列表中。

示例代码：

<?php if ( $order->needs_payment() ) { ?>
    <p>
    <?php
    printf(
        wp_kses(
            __( 'We’re delighted to let you know that the first print of <i>The Versatile Home</i> is now available and we are able to fulfil your pre-order. Your invoice is below and here is a link to make payment: %2$s', 'woocommerce' ),
            array(
                'a' => array(
                    'href' => array(),
                ),
                'i' => array(), // 明确允许 <i> 标签
            )
        ),
        esc_html( get_bloginfo( 'name', 'display' ) ),
        '<a href="' . esc_url( $order->get_checkout_payment_url() ) . '">' . esc_html__( 'click here to pay by credit/debit card or PayPal', 'woocommerce' ) . '</a>'
    );
    ?>
    </p>
<?php } ?>

登录后复制

通过在wp_kses的允许标签数组中添加'i' => array()，<i>标签将不再被过滤，从而实现斜体效果。

2. 添加新段落并插入动态订单号

要添加第二个段落，通常需要一个新的printf或echo语句块。动态订单号可以通过$order->get_id()方法获取。

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

示例代码：

<?php if ( $order->needs_payment() ) { ?>
    <p>
    <?php
    // 第一段内容，包含斜体和支付链接
    printf(
        wp_kses(
            __( 'We’re delighted to let you know that the first print of <i>The Versatile Home</i> is now available and we are able to fulfil your pre-order. Your invoice is below and here is a link to make payment: %2$s', 'woocommerce' ),
            array(
                'a' => array( 'href' => array(), ),
                'i' => array(), // 允许 <i> 标签
            )
        ),
        esc_html( get_bloginfo( 'name', 'display' ) ),
        '<a href="' . esc_url( $order->get_checkout_payment_url() ) . '">' . esc_html__( 'click here to pay by credit/debit card or PayPal', 'woocommerce' ) . '</a>'
    );
    ?>
    </p>

    <p>
    <?php
    // 第二段内容，包含银行转账信息和动态订单号
    printf(
        wp_kses(
            __( 'Alternatively, you can make payment by bank transfer to Sort Code: 00-00-00, Acct #: 00000000, Acct name: xxxxx, quoting order # %s as the reference. As soon as we’ve received the payment we’ll get your order off to you straight away.', 'woocommerce' ),
            array() // 此段落如果不需要额外HTML标签，可以留空或使用 wp_kses_post
        ),
        esc_html( $order->get_id() ) // 获取并安全输出订单号
    );
    ?>
    </p>
<?php } ?>

登录后复制

注意事项：

安全性： 始终使用esc_html()、esc_url()等函数对用户输入或动态数据进行转义，以防止XSS攻击。
可读性： 复杂的HTML结构和多语言字符串（通过__或_e函数）在PHP代码中拼接会降低代码的可读性和维护性。
国际化： 确保所有面向用户的文本都通过WordPress的国际化函数进行封装，以便翻译。

简化方案：利用专业邮件构建器 (例如YayMail)

鉴于直接使用PHP代码进行WooCommerce邮件模板的复杂性、维护难度和对安全性的高要求，许多开发者和商家倾向于使用专业的邮件构建器插件。这些插件通常提供可视化的拖放界面，极大地简化了邮件模板的设计和自定义过程。

以YayMail为例，这类插件的优势包括：

可视化编辑： 提供直观的拖放界面，用户无需编写任何代码即可设计邮件布局、添加文本、图片、按钮等元素。
丰富的元素库： 内置多种邮件元素，如文本块、图片、按钮、产品列表、订单详情等，可直接拖放到模板中。
动态内容支持： 允许轻松插入各种动态占位符（如订单号、客户姓名、支付链接等），插件会自动从WooCommerce订单数据中获取并填充。
实时预览： 可以在编辑时实时预览邮件效果，确保最终发送的邮件符合预期。
兼容性与扩展性： 通常与WooCommerce核心邮件系统无缝集成，并支持各种WooCommerce扩展。
降低错误率： 减少了手动编码可能引入的语法错误或安全漏洞。

使用YayMail这类工具，上述的斜体文本和包含动态订单号的新段落，都可以通过简单的文本编辑和拖放操作来完成，而无需深入理解PHP代码和wp_kses的细节。这对于非开发人员或希望提高效率的开发人员来说，无疑是更“轻松”的选择。

总结

在WooCommerce邮件自定义中，虽然可以通过直接修改PHP代码来实现复杂的文本格式和动态内容，但这要求开发者具备扎实的PHP和WordPress安全编码知识，且维护成本较高。对于大多数场景，尤其是追求效率和便捷性的用户，使用专业的邮件构建器（如YayMail）是更为推荐的解决方案。它不仅简化了邮件设计过程，提高了效率，还能确保邮件内容的美观性和功能性，让您能够专注于业务本身，而非繁琐的代码调试。

以上就是WooCommerce邮件自定义：文本格式与动态内容插入的挑战与解决方案的详细内容，更多请关注php中文网其它相关文章！