本教程详细指导如何在woocommerce bookings中，将默认显示的预订结束日期替换为更直观的预订时长。通过覆盖woocommerce bookings插件的模板文件，用户可以自定义订单详情、邮件和我的账户页面的显示内容，从而提升客户和管理员的用户体验，避免日期混淆。文章将介绍模板覆盖的步骤和修改方法，确保预订信息清晰明了。
解决WooCommerce Bookings显示问题：从结束日期到预订时长
在WooCommerce Bookings中，当销售以天为单位的可预订产品时，客户通常输入预订开始日期和预订时长。虽然购物车和订单摘要页面可能正确显示这些信息，但在电子邮件、我的账户页面和结账后的感谢页面中，系统默认显示的是预订开始日期和预订结束日期，这常常导致客户和管理员的困惑。本教程旨在提供一种专业的解决方案，通过修改WooCommerce Bookings的模板文件，将结束日期替换为更明确的预订时长。
初步尝试与局限性
一些开发者可能会尝试使用WooCommerce提供的过滤器（Filter）来修改显示内容。例如，使用wc_bookings_summary_list_date过滤器可以干预日期显示：
function modify_summary_date_20170821( $booking_date, $booking_start, $booking_end ) {
echo 'Ankunft: '; // Output custom text
return date_i18n( wc_date_format(), $booking_start ); // Return only start date
}
add_filter( 'wc_bookings_summary_list_date', 'modify_summary_date_20170821', 10, 3 );这段代码能够成功隐藏预订结束日期并显示自定义文本及开始日期。然而，其局限性在于该过滤器主要用于修改或返回单个日期字符串，难以直接在此处插入预订时长这一独立信息。对于更复杂的布局和信息展示需求，简单的过滤器往往力不从心。
推荐解决方案：覆盖模板文件
要实现将结束日期替换为预订时长，最强大和灵活的方法是覆盖WooCommerce Bookings插件的模板文件。这种方法允许您完全控制HTML结构和显示逻辑，从而实现精确的定制。
1. 理解模板覆盖机制
WooCommerce及其扩展插件（如WooCommerce Bookings）都采用模板系统。这意味着插件的大部分前端输出都是通过特定的.php模板文件生成的。为了允许用户自定义这些输出而无需修改核心插件文件（这会导致更新时丢失修改），WooCommerce提供了一种模板覆盖机制：
- 将插件的模板文件复制到您的主题（强烈建议使用子主题）的特定目录中。
- 系统会优先加载主题中的模板文件，而非插件自带的。
2. 识别需要修改的模板文件
WooCommerce Bookings的模板文件通常位于wp-content/plugins/woocommerce-bookings/templates/目录下。您需要根据需要修改的页面（例如，我的账户页面、订单详情页、电子邮件）来定位对应的模板文件。
常见的可能需要修改的文件包括：
- 我的账户页面预订详情: myaccount/bookings.php 或其包含的子模板文件，如 myaccount/booking-details.php。
- 订单详情页: order/booking-details.php (WooCommerce Bookings通常会在此处添加自己的详情片段)。
- 电子邮件模板: emails/plain/booking-details.php (纯文本邮件) 和 emails/booking-details.php (HTML邮件)。
查找方法： 打开wp-content/plugins/woocommerce-bookings/templates/目录，浏览其子文件夹。通常，您会找到名为booking-details.php或booking-summary.php的文件，这些文件负责渲染预订的详细信息。
3. 复制模板文件到子主题
在您的子主题（如果尚未创建，请务必创建一个）中，创建一个与插件模板路径相对应的目录结构。例如，如果目标文件是wp-content/plugins/woocommerce-bookings/templates/myaccount/booking-details.php，您需要将其复制到：
wp-content/themes/your-child-theme/woocommerce-bookings/myaccount/booking-details.php
重要提示： 始终使用子主题进行此类修改，以确保主题或插件更新时您的修改不会丢失。
4. 修改模板文件以显示预订时长
打开您复制到子主题的模板文件。您需要找到负责显示预订开始日期和结束日期的代码行。通常，它们会使用$booking对象（一个WC_Booking实例）来获取这些信息。
示例：在模板中查找并修改
假设您找到类似以下的代码段，它可能用于显示开始和结束日期：
<?php // 原始代码示例：显示开始日期和结束日期 echo '<span>' . wc_bookings_get_formatted_date( $booking->get_start_date() ) . ' - ' . wc_bookings_get_formatted_date( $booking->get_end_date() ) . '</span>'; ?>
您可以将其修改为显示开始日期和预订时长：
<?php
// 获取预订对象（假设已在模板中定义为 $booking）
// 确保 $booking 是 WC_Booking 类的实例
if ( $booking instanceof WC_Booking ) {
$start_date = $booking->get_start_date();
$duration = $booking->get_duration(); // 获取预订时长数值
$duration_unit = $booking->get_duration_unit(); // 获取预订时长单位 (e.g., 'day', 'hour')
// 显示开始日期
echo '<span>' . wc_bookings_get_formatted_date( $start_date ) . '</span>';
// 显示预订时长
// 使用 sprintf 格式化输出，并考虑单复数
echo '<br>'; // 换行，或根据您的布局调整
echo '<span>' . sprintf(
/* translators: 1: duration, 2: duration unit */
_n( 'Duration: %1$s %2$s', 'Duration: %1$s %2$ss', $duration, 'woocommerce-bookings' ),
$duration,
$duration_unit
) . '</span>';
}
?>代码说明：
- $booking->get_start_date(): 获取预订的开始日期。
- $booking->get_duration(): 获取预订的时长数值。
- $booking->get_duration_unit(): 获取预订时长的单位（例如“天”、“小时”）。
- wc_bookings_get_formatted_date(): WooCommerce Bookings提供的函数，用于格式化日期显示。
- _n(): WordPress的国际化函数，用于处理单复数文本。这里用于根据时长数值显示正确的单位（例如“1 day” vs “2 days”）。
5. 注意事项与最佳实践
- 使用子主题： 再次强调，所有模板修改都应在子主题中进行，以避免主题或插件更新时覆盖您的定制。
- 备份： 在进行任何代码修改之前，务必备份您的网站。
- 逐步测试： 修改一小部分代码后立即测试，确保功能正常且没有引入新的问题。
- 国际化： 如果您的网站支持多种语言，请确保您的自定义文本（如“Duration: ”）使用WordPress的国际化函数（如__()或_e()）进行包裹，以便进行翻译。
- WooCommerce Bookings文档： 查阅官方的WooCommerce Bookings模板文档（如：https://woocommerce.com/document/bookings-templates/），了解更多关于其模板结构和可用函数的信息。
总结
通过覆盖WooCommerce Bookings的模板文件，您可以获得对预订信息显示方式的完全控制。这种方法虽然比简单的过滤器更复杂，但它提供了无与伦比的灵活性和稳定性，确保您的定制在插件更新后依然有效。通过将预订结束日期替换为清晰的预订时长，您将显著提升客户和管理员在使用您的预订系统时的体验。
