WooCommerce Bookings：自定义显示预订时长而非结束日期

本教程旨在指导WooCommerce Bookings用户，如何将订单详情、我的账户页面及邮件通知中默认显示的预订“结束日期”替换为更直观的“预订时长”。通过覆盖WooCommerce Bookings插件的模板文件，并利用预订对象提供的数据，实现这一自定义显示，从而提升客户和管理员的用户体验，避免因日期显示方式不一致而造成的混淆。

在WooCommerce Bookings中，当产品配置为按“天”或其他单位进行预订并设定时长时，系统在购物车和订单摘要中通常能正确显示预订开始日期和时长。然而，在邮件通知、我的账户页面以及订单完成后的感谢页面，系统默认却显示预订开始日期和结束日期。这种显示方式可能导致客户和管理员产生困惑，因为他们期望看到的是预订时长，而非一个计算出的结束日期。为了解决这一问题，最推荐且持久的解决方案是利用WooCommerce的模板覆盖机制来修改显示逻辑。

理解WooCommerce模板覆盖机制

WooCommerce及其扩展（如WooCommerce Bookings）都使用模板文件来渲染前端的各种视图。直接修改插件的核心模板文件是不可取的，因为在插件更新时，这些修改将会丢失。正确的做法是将需要修改的模板文件复制到你的主题（强烈建议使用子主题）中，然后在子主题中进行修改。WooCommerce会优先加载子主题中的同名模板文件。

为什么使用子主题？ 使用子主题可以确保你的自定义修改在父主题更新时不会丢失。如果你的网站目前没有使用子主题，建议先创建一个。

模板文件路径： WooCommerce Bookings的模板文件通常位于插件目录下的 wp-content/plugins/woocommerce-bookings/templates/。你需要将这些文件复制到你的子主题目录下的 your-child-theme/woocommerce-bookings/ 路径。

确定需要修改的模板文件

要修改邮件、我的账户页面和感谢页面中的预订日期显示，你需要识别并覆盖相关的模板文件。这些文件通常处理预订详情的输出。

以下是一些可能需要修改的常见模板文件示例：

• 我的账户页面相关：
  • woocommerce-bookings/templates/myaccount/booking-details.php：显示单个预订的详细信息。
  • woocommerce-bookings/templates/myaccount/my-bookings.php：我的账户中预订列表的显示。
• 邮件通知相关：
  • woocommerce-bookings/templates/emails/plain/booking-details.php：纯文本邮件中的预订详情。
  • woocommerce-bookings/templates/emails/html/booking-details.php：HTML邮件中的预订详情。
  • 其他具体的邮件模板，如 admin-new-booking.php、customer-booking-confirmed.php 等，它们可能包含了 booking-details.php 或直接输出预订信息。
• 感谢页面（订单完成页）相关：
  • 感谢页面通常会包含订单详情，而订单详情中又会包含预订详情。这可能涉及 woocommerce-bookings/templates/order/booking-details.php 或与我的账户页面相似的模板片段。

通常，booking-details.php 文件是核心，因为它包含了显示预订开始日期和结束日期的逻辑。

实现自定义显示：从结束日期到预订时长

以下是修改模板文件的具体步骤和示例代码。我们将以 woocommerce-bookings/templates/myaccount/booking-details.php 为例进行说明，其他模板文件的修改方法类似。

步骤一：复制模板文件

1. 通过FTP或文件管理器，导航到 wp-content/plugins/woocommerce-bookings/templates/ 目录。
2. 找到并复制 myaccount/booking-details.php 文件。
3. 在你的子主题目录中，创建以下文件夹结构（如果不存在）：your-child-theme/woocommerce-bookings/myaccount/。
4. 将复制的文件粘贴到 your-child-theme/woocommerce-bookings/myaccount/ 目录中。

步骤二：修改模板文件以显示时长

打开你在子主题中复制的 booking-details.php 文件。你需要找到显示预订开始日期和结束日期的部分，并将其替换为显示开始日期和预订时长的逻辑。

Tana

“节点式”AI智能笔记工具，支持超级标签。

80

查看详情

在模板文件中，你通常可以访问到 WC_Booking 对象（通常以 $booking 变量的形式）。这个对象提供了获取预订详细信息的方法。

示例代码：

找到类似以下显示开始日期和结束日期的代码片段（具体行号和结构可能因版本而异）：

<?php
// 示例：查找类似这样的代码，它可能以列表项或其他HTML结构显示日期
// echo '<li>' . esc_html__( 'Start Date:', 'woocommerce-bookings' ) . ' ' . $booking->get_start_date() . '</li>';
// echo '<li>' . esc_html__( 'End Date:', 'woocommerce-bookings' ) . ' ' . $booking->get_end_date() . '</li>';
?>

将其替换为以下显示开始日期和预订时长的代码：

<?php
/**
 * Booking details
 *
 * This template can be overridden by copying it to yourtheme/woocommerce-bookings/myaccount/booking-details.php.
 *
 * @see     https://docs.woocommerce.com/document/template-structure/
 * @author  WooThemes
 * @package WooCommerce Bookings/Templates
 * @version 1.10.0
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}

// 确保 $booking 对象可用，如果不可用，可能需要根据模板上下文进行初始化
if ( ! isset( $booking ) || ! ( $booking instanceof WC_Booking ) ) {
    // 尝试从全局变量或通过ID获取，具体取决于模板如何传递数据
    // 例如：如果模板通过 $booking_id 传递ID
    // if ( isset( $booking_id ) ) {
    //     $booking = new WC_Booking( $booking_id );
    // } else {
    //     return; // 无法获取预订对象，直接返回
    // }
    // 对于 myaccount/booking-details.php，通常 $booking 是直接可用的
    return;
}

// ... 模板中其他现有代码 ...

// 修改日期显示部分
?>
<ul class="wc-booking-details">
    <li class="wc-booking-detail">
        <strong><?php esc_html_e( 'Booking Date:', 'woocommerce-bookings' ); ?></strong>
        <?php echo esc_html( $booking->get_start_date( wc_date_format() ) ); ?>
    </li>

    <?php
    // 检查预订是否包含时长信息
    $duration      = $booking->get_duration();
    $duration_unit = $booking->get_duration_unit();

    if ( $duration && $duration_unit ) :
        ?>
        <li class="wc-booking-detail">
            <strong><?php esc_html_e( 'Duration:', 'woocommerce-bookings' ); ?></strong>
            <?php
            echo sprintf(
                _n( '%s %s', '%s %s', $duration, 'woocommerce-bookings' ),
                $duration,
                $booking->get_duration_unit_label() // 获取时长单位的本地化标签
            );
            ?>
        </li>
    <?php
    // 如果没有时长信息，或者你希望在特定情况下仍然显示结束日期，可以添加else分支
    // else :
    //    ?>
    <!-- <li class="wc-booking-detail"> -->
    <!--    <strong><?php esc_html_e( 'End Date:', 'woocommerce-bookings' ); ?></strong> -->
    <!--    <?php // echo esc_html( $booking->get_end_date( wc_date_format() ) ); ?> -->
    <!-- </li> -->
    <?php
    endif;
    ?>
</ul>
<?php
// ... 模板中其他现有代码 ...
?>

代码说明：

• $booking->get_start_date( wc_date_format() )：获取预订的开始日期，并使用WooCommerce的日期格式进行格式化。
• $booking->get_duration()：获取预订的时长数值。
• $booking->get_duration_unit()：获取预订的时长单位（例如 'day', 'hour'）。
• $booking->get_duration_unit_label()：获取时长单位的本地化显示标签（例如 '天', '小时'）。
• _n() 和 sprintf()：用于根据时长数值进行复数形式的本地化显示，确保语言的准确性。
• 我们使用 if ( $duration && $duration_unit ) 来确保只有在有时长信息时才显示时长，这增加了代码的健壮性。

步骤三：重复操作于其他相关模板

根据你的需求，对其他涉及预订日期显示的模板文件（如邮件模板、感谢页面模板等）重复上述复制和修改过程。

注意事项与最佳实践

1. 备份： 在进行任何文件修改之前，务必备份你的网站文件和数据库。
2. 测试： 完成修改后，务必在不同的场景下（例如，新预订、查看历史预订、收到预订邮件）彻底测试你的更改，确保所有地方都按预期显示。
3. 插件更新： 即使使用了子主题，当WooCommerce Bookings插件进行重大更新时，仍建议检查其模板结构是否发生变化。如果模板结构有更新，你可能需要重新审查和调整你的自定义模板文件。
4. 国际化： 示例代码中使用了 esc_html_e() 和 _n() 等函数，这有助于确保你的自定义文本能够被正确地翻译和本地化。
5. 具体上下文： 不同的模板文件在加载 WC_Booking 对象的方式上可能略有不同。如果 $booking 变量在你的模板中不可用，你可能需要根据模板文件的上下文，通过预订ID（例如 $booking_id）来手动实例化 WC_Booking 对象：$booking = new WC_Booking( $booking_id );

总结

通过覆盖WooCommerce Bookings的模板文件，并利用 WC_Booking 对象提供的方法，你可以灵活地控制预订信息的显示方式。将预订“结束日期”替换为更具描述性的“预订时长”，能够显著提升用户体验，减少混淆，使预订流程更加清晰直观。请务必遵循最佳实践，在子主题中进行修改，并进行充分测试，以确保网站的稳定性和功能的正确性。

以上就是WooCommerce Bookings：自定义显示预订时长而非结束日期的详细内容，更多请关注php中文网其它相关文章！