优化WooCommerce Bookings显示：将结束日期替换为预订时长-php教程-PHP中文网

优化WooCommerce Bookings显示：将结束日期替换为预订时长

聖光之護

发布： 2025-11-23 13:17:39

原创

938人浏览过

优化WooCommerce Bookings显示：将结束日期替换为预订时长

本教程详细指导如何在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

微撰

AI智能写作平台

207

查看详情

重要提示： 始终使用子主题进行此类修改，以确保主题或插件更新时您的修改不会丢失。

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/），了解更多关于其模板结构和可用函数的信息。