本教程旨在指导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/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 为例进行说明，其他模板文件的修改方法类似。
步骤一：复制模板文件
- 通过FTP或文件管理器，导航到 wp-content/plugins/woocommerce-bookings/templates/ 目录。
- 找到并复制 myaccount/booking-details.php 文件。
- 在你的子主题目录中，创建以下文件夹结构（如果不存在）：your-child-theme/woocommerce-bookings/myaccount/。
- 将复制的文件粘贴到 your-child-theme/woocommerce-bookings/myaccount/ 目录中。
步骤二：修改模板文件以显示时长
打开你在子主题中复制的 booking-details.php 文件。你需要找到显示预订开始日期和结束日期的部分，并将其替换为显示开始日期和预订时长的逻辑。
在模板文件中，你通常可以访问到 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 ) 来确保只有在有时长信息时才显示时长，这增加了代码的健壮性。
步骤三：重复操作于其他相关模板
根据你的需求，对其他涉及预订日期显示的模板文件（如邮件模板、感谢页面模板等）重复上述复制和修改过程。
注意事项与最佳实践
- 备份： 在进行任何文件修改之前，务必备份你的网站文件和数据库。
- 测试： 完成修改后，务必在不同的场景下（例如，新预订、查看历史预订、收到预订邮件）彻底测试你的更改，确保所有地方都按预期显示。
- 插件更新： 即使使用了子主题，当WooCommerce Bookings插件进行重大更新时，仍建议检查其模板结构是否发生变化。如果模板结构有更新，你可能需要重新审查和调整你的自定义模板文件。
- 国际化： 示例代码中使用了 esc_html_e() 和 _n() 等函数，这有助于确保你的自定义文本能够被正确地翻译和本地化。
- 具体上下文： 不同的模板文件在加载 WC_Booking 对象的方式上可能略有不同。如果 $booking 变量在你的模板中不可用，你可能需要根据模板文件的上下文，通过预订ID（例如 $booking_id）来手动实例化 WC_Booking 对象：$booking = new WC_Booking( $booking_id );
总结
通过覆盖WooCommerce Bookings的模板文件，并利用 WC_Booking 对象提供的方法，你可以灵活地控制预订信息的显示方式。将预订“结束日期”替换为更具描述性的“预订时长”，能够显著提升用户体验，减少混淆，使预订流程更加清晰直观。请务必遵循最佳实践，在子主题中进行修改，并进行充分测试，以确保网站的稳定性和功能的正确性。
