自定义WooCommerce预订显示：将结束日期替换为预订时长

本文详细介绍了如何在woocommerce bookings中，将默认显示的预订结束日期替换为更直观的预订时长。针对在购物车、订单详情、邮件及“我的账户”页面中出现的日期显示问题，教程推荐采用覆盖woocommerce bookings模板文件的方法，并提供了具体操作步骤和代码示例，帮助开发者实现灵活的日期显示定制，提升用户体验和管理效率。

在WooCommerce Bookings插件中，当用户预订以天为单位的产品时，系统默认会在多个关键页面（如电子邮件通知、用户“我的账户”页面以及结账后的感谢页面）显示预订的开始日期和结束日期。然而，对于某些业务场景，尤其是按天计费或按时长租赁的服务，直接显示预订的“时长”而非“结束日期”能提供更清晰、更符合用户预期的信息，从而减少混淆并提升用户体验。

虽然可以通过WooCommerce提供的过滤器（如wc_bookings_summary_list_date）来修改或隐藏特定日期显示，但这些过滤器通常只允许对现有日期进行格式化或隐藏，难以直接引入预订时长这一新信息。要彻底实现将结束日期替换为预订时长，并确保在所有相关输出中保持一致性，最健壮和推荐的方法是覆盖WooCommerce Bookings的模板文件。

理解WooCommerce Bookings模板覆盖机制

WooCommerce及其扩展插件（如Bookings）都设计了一套灵活的模板系统，允许开发者在不修改插件核心文件的情况下，自定义其输出。这意味着你可以将插件的特定模板文件复制到你的主题（强烈建议使用子主题）中，然后修改这些复制的文件以实现自定义显示逻辑。

当WooCommerce或Bookings需要渲染某个视图时，它会首先检查你的主题目录中是否存在对应的模板文件。如果存在，则使用主题中的文件；否则，使用插件自带的默认模板。

实施步骤：将结束日期替换为预订时长

以下是实现这一目标的分步指南：

1. 识别并复制相关模板文件

首先，你需要确定哪些模板文件负责显示预订日期。对于电子邮件、我的账户页面和感谢页面，通常涉及以下几个核心模板：

• 订单详情中的预订信息： woocommerce-bookings/templates/order/booking-details.php
• 我的账户页面中的预订列表/详情： woocommerce-bookings/templates/my-bookings/booking-details.php
• 电子邮件通知中的预订信息： woocommerce-bookings/templates/emails/customer-booking-details.php (以及其他特定邮件模板，如管理员新订单通知等)

操作步骤：

1. 通过FTP客户端或文件管理器访问你的网站服务器。
2. 导航到 wp-content/plugins/woocommerce-bookings/templates/ 目录。
3. 找到上述提到的模板文件，并将它们复制。
4. 在你的子主题（例如 your-child-theme/）根目录下创建一个名为 woocommerce-bookings 的新文件夹。
5. 将复制的模板文件粘贴到 your-child-theme/woocommerce-bookings/ 目录中，保持原有的文件路径结构。例如，booking-details.php 应该放在 your-child-theme/woocommerce-bookings/order/booking-details.php。

2. 修改模板文件以显示预订时长

打开你复制到子主题中的模板文件，查找显示预订结束日期的代码段。这些模板通常会有一个 $booking 对象可用，其中包含了所有预订相关的数据。

示例代码修改（以 booking-details.php 为例）：

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

396

查看详情

在模板文件中，你可能会找到类似以下的代码来显示开始日期和结束日期：

<?php echo date_i18n( wc_date_format(), $booking->get_start() ); ?>
<?php echo date_i18n( wc_date_format(), $booking->get_end() ); ?>

要将结束日期替换为预订时长，你需要访问 $booking 对象的持续时间信息。WC_Booking 对象通常提供了 get_duration() 和 get_duration_unit() 方法。

找到显示结束日期的行，并将其替换为显示时长的代码。

// 假设 $booking 对象已经可用
// 原始显示：
// echo '预订开始日期: ' . date_i18n( wc_date_format(), $booking->get_start() );
// echo '预订结束日期: ' . date_i18n( wc_date_format(), $booking->get_end() );

// 修改为显示开始日期和预订时长：
echo '预订开始日期: ' . date_i18n( wc_date_format(), $booking->get_start() );

// 获取预订时长和单位
$duration      = $booking->get_duration();
$duration_unit = $booking->get_duration_unit(); // 例如 'day', 'hour', 'minute'

// 获取本地化的单位标签
$unit_label = wc_get_duration_unit_label( $duration_unit );

if ( $duration && $unit_label ) {
    echo '<br>预订时长: ' . esc_html( $duration ) . ' ' . esc_html( $unit_label );
}

代码解释：

• $booking->get_start(): 获取预订开始时间戳。
• $booking->get_duration(): 获取预订的持续时间数值。
• $booking->get_duration_unit(): 获取预订持续时间的单位（例如 'day'、'hour'）。
• wc_get_duration_unit_label(): 这是一个WooCommerce Bookings的辅助函数，用于获取持续时间单位的本地化文本（例如，将 'day' 转换为 '天'）。
• esc_html(): 用于安全输出HTML内容。

重复此过程，修改所有你希望更改显示方式的模板文件。

3. 清除缓存并测试

完成模板修改后，务必清除所有网站缓存（包括主题缓存、插件缓存、CDN缓存等）。然后，进行全面的测试：

• 提交一个新的预订订单，检查结账后的感谢页面。
• 登录用户账户，检查“我的账户”页面中的预订详情。
• 检查发送给客户和管理员的电子邮件通知。

确保所有修改都已生效，并且预订时长显示正确。

注意事项与最佳实践

• 始终使用子主题： 直接修改父主题或插件文件会在更新时被覆盖。子主题是进行任何自定义的最佳实践。
• 备份： 在进行任何文件修改之前，务必备份你的网站文件和数据库。
• 了解模板结构： 在修改模板之前，花时间理解其HTML结构和PHP逻辑，避免引入错误。
• 兼容性： 插件更新可能会引入新的模板结构或修改现有模板。在WooCommerce Bookings更新后，检查你的自定义模板是否仍然兼容，可能需要根据新版本进行调整。
• 本地化： 使用 wc_get_duration_unit_label() 等函数确保时长单位能够正确地进行本地化，以适应不同语言的用户。

总结

通过覆盖WooCommerce Bookings的模板文件，你可以完全掌控预订信息的显示方式。这种方法虽然比简单的过滤器更复杂，但它提供了最大的灵活性和稳定性，确保你的自定义显示在插件更新后依然有效。通过将预订结束日期替换为预订时长，你不仅能提升客户体验，还能为网站管理员提供更直观的订单信息，从而优化整体的预订管理流程。

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