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

本教程旨在解决woocommerce bookings插件中默认显示预订开始日期和结束日期，而非预订时长的问题。我们将探讨如何通过覆盖woocommerce bookings模板文件这一核心方法，在购物车、我的账户页面及订单邮件中，将预订的结束日期替换为更直观的预订时长，从而提升用户和管理员的体验，并提供具体的实现思路和最佳实践。

引言：优化WooCommerce预订日期显示体验

在WooCommerce Bookings插件的实际应用中，尤其当产品以天为单位进行预订时，系统默认在订单摘要、我的账户页面以及邮件通知中显示预订的“开始日期”和“结束日期”。然而，对于许多用户和管理员而言，直接显示“开始日期”和“预订时长”更为直观和实用，能够有效避免混淆。例如，客户预订了3天，看到“开始日期：2023年10月26日，结束日期：2023年10月28日”可能不如“开始日期：2023年10月26日，预订时长：3天”清晰明了。本教程将指导您如何通过WooCommerce推荐的方式，实现这一显示优化。

理解WooCommerce预订日期显示机制与现有尝试

WooCommerce Bookings插件在不同的页面和通知中，通过其内部逻辑和模板文件来渲染预订产品的详细信息。默认情况下，它倾向于展示完整的日期范围。

有开发者尝试通过WordPress的过滤器（如wc_bookings_summary_list_date）来干预日期显示。例如，以下代码可以隐藏结束日期，只显示开始日期：

function modify_summary_date_20170821( $booking_date, $booking_start, $booking_end ) {
    echo 'Ankunft: '; // 可自定义前缀，如“Arrival:”
    return date_i18n( wc_date_format(), $booking_start );
}       
add_filter( 'wc_bookings_summary_list_date', 'modify_summary_date_20170821', 10, 3 );

这段代码确实能够阻止结束日期被显示，并允许自定义开始日期的前缀。然而，这个过滤器仅提供了$booking_date（通常是开始日期）、$booking_start和$booking_end作为参数。它无法直接提供预订时长的信息，也无法在现有参数的基础上轻松计算并插入时长，因为其设计目的主要是修改日期字符串本身，而非添加新的数据字段或改变整体结构。因此，要实现将结束日期替换为预订时长，我们需要更深层次的定制方法。

核心解决方案：通过模板覆盖定制显示

WooCommerce及其扩展插件（包括Bookings）都提供了强大的模板覆盖机制，允许开发者在不修改插件核心文件的情况下，自定义插件的输出内容。这是实现将结束日期替换为预订时长的最推荐和最灵活的方法。

Lifetoon

免费的AI漫画创作平台

92

查看详情

为什么选择模板覆盖？

1. 最大灵活性： 直接控制HTML结构和PHP逻辑，可以精确地调整显示内容和样式。
2. 未来兼容性： 您的修改位于子主题中，插件更新时不会被覆盖。
3. 直接访问数据： 在模板文件中，您可以直接访问到完整的预订对象（WC_Booking），从而获取其所有属性，包括开始日期、结束日期、时长和时长单位等。

识别相关模板文件

WooCommerce Bookings插件在多个地方显示预订详情，您可能需要根据实际需求修改一个或多个模板文件：

• 我的账户页面： woocommerce-bookings/templates/myaccount/bookings.php 或其包含的其他模板。
• 订单详情页（后台及前端）： woocommerce-bookings/templates/order/booking-details.php。
• 邮件通知： woocommerce-bookings/templates/emails/customer-booking-details.php (发给客户的邮件) 和 woocommerce-bookings/templates/emails/admin-new-booking.php (发给管理员的邮件)。
• 购物车/结账页面： 某些情况下可能涉及 woocommerce-bookings/templates/cart/cart-item-booking.php 或类似文件。

您可以在 wp-content/plugins/woocommerce-bookings/templates/ 目录下找到所有原始模板文件。

模板覆盖步骤

1. 创建子主题（如果尚未创建）： 模板覆盖必须在子主题中进行，以确保插件更新后您的修改不会丢失。
2. 复制模板文件：
   • 在您的子主题目录中，创建一个名为 woocommerce-bookings 的文件夹。
   • 将您需要修改的原始模板文件（例如，myaccount/bookings.php）从 wp-content/plugins/woocommerce-bookings/templates/ 复制到您的子主题的 woocommerce-bookings/ 文件夹中，并保持原有的子目录结构。
     • 例如，如果您要修改 myaccount/bookings.php，则复制到 your-child-theme/woocommerce-bookings/myaccount/bookings.php。
3. 修改模板文件以显示时长：
   • 打开复制到子主题的模板文件。
   • 在这些模板中，您会发现用于显示预订详情的代码，通常会有一个 $booking 变量，它是一个 WC_Booking 类的实例。
   • 找到显示开始日期和结束日期的代码段。例如，您可能会看到类似 echo $booking->get_start_date(); 和 echo $booking->get_end_date(); 的代码。
   • 将显示结束日期的代码替换为显示预订时长的代码。WC_Booking 对象提供了获取时长的方法。

以下是一个概念性的代码示例，展示如何在模板中获取并显示预订时长：

<?php
// 假设您已经在一个循环中获取到了 $booking 对象
// $booking 是 WC_Booking 类的实例

if ( $booking && is_a( $booking, 'WC_Booking' ) ) {
    // 获取开始日期
    $start_date_formatted = date_i18n( wc_date_format(), $booking->get_start_date( 'timestamp' ) );

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

    // 根据单位进行本地化显示，例如将 'day' 显示为 '天'
    $translated_duration_unit = '';
    switch ( $duration_unit ) {
        case 'day':
            $translated_duration_unit = __( '天', 'your-text-domain' ); // 替换 'your-text-domain' 为您主题或插件的文本域
            break;
        case 'hour':
            $translated_duration_unit = __( '小时', 'your-text-domain' );
            break;
        case 'minute':
            $translated_duration_unit = __( '分钟', 'your-text-domain' );
            break;
        default:
            $translated_duration_unit = $duration_unit;
            break;
    }

    // 输出开始日期和预订时长
    echo '<p><strong>开始日期:</strong> ' . esc_html( $start_date_formatted ) . '</p>';
    echo '<p><strong>预订时长:</strong> ' . esc_html( $duration ) . ' ' . esc_html( $translated_duration_unit ) . '</p>';

    // 您可以根据需要移除或注释掉显示结束日期的原有代码
    // 例如：
    // echo '<p><strong>结束日期:</strong> ' . date_i18n( wc_date_format(), $booking->get_end_date( 'timestamp' ) ) . '</p>';
}
?>

**

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