本教程旨在指导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 为例进行说明，其他模板文件的修改方法类似。
步骤一：复制模板文件
通过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 '
将其替换为以下显示开始日期和预订时长的代码：
- get_start_date( wc_date_format() ) ); ?> get_duration(); $duration_unit = $booking->get_duration_unit(); if ( $duration && $duration_unit ) : ?>
- get_duration_unit_label() // 获取时长单位的本地化标签 ); ?> <!--
- --> <!-- --> <!-- get_end_date( wc_date_format() ) ); ?> --> <!-- -->
代码说明：
$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 对象提供的方法，你可以灵活地控制预订信息的显示方式。将预订“结束日期”替换为更具描述性的“预订时长”，能够显著提升用户体验，减少混淆，使预订流程更加清晰直观。请务必遵循最佳实践，在子主题中进行修改，并进行充分测试，以确保网站的稳定性和功能的正确性。
以上就是WooCommerce Bookings：自定义显示预订时长而非结束日期的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1338091.html
微信扫一扫 
支付宝扫一扫 
