WooCommerce 获取订单 ID 方法

本文档旨在指导开发者如何在 WooCommerce 的“我的账户”页面自定义版块中获取订单 ID，以便访问与特定订单关联的合同信息。我们将参考 WooCommerce 核心代码的实现方式，利用 wc_get_orders() 函数和用户 ID 来检索订单，并最终获取订单 ID。

获取用户订单

首先，我们需要使用 wc_get_orders() 函数来获取当前用户的订单。此函数允许我们根据不同的参数查询订单，包括用户 ID。

$customer_orders = wc_get_orders(
    array(
        'customer' => get_current_user_id(),
        'limit'    => -1, // 获取所有订单，或者设置一个合适的数量限制
        'orderby'  => 'date',
        'order'    => 'DESC',
    )
);

这段代码使用 get_current_user_id() 函数获取当前用户的 ID，并将其传递给 wc_get_orders() 函数。limit 参数设置为 -1 表示获取所有订单。orderby 和 order 参数用于指定订单的排序方式。

循环遍历订单并获取订单 ID

获取订单列表后，我们需要循环遍历这些订单，并从中提取订单 ID。

if ( ! empty( $customer_orders ) ) {
    foreach ( $customer_orders as $order ) {
        $order_id = $order->get_id();
        // 在这里可以使用 $order_id 进行后续操作，例如查询合同信息
        echo 'Order ID: ' . $order_id . '<br>';
    }
} else {
    echo 'No orders found for this user.';
}

这段代码首先检查订单列表是否为空。如果不为空，则使用 foreach 循环遍历每个订单对象。对于每个订单对象，我们使用 $order->get_id() 方法获取订单 ID，并将其存储在 $order_id 变量中。然后，我们可以在循环内部使用 $order_id 进行后续操作，例如查询与该订单相关的合同信息。

集成到你的自定义版块

现在，我们将上述代码集成到你的自定义版块 MyAccountRegistredContractsEndPoint() 函数中。

public function MyAccountRegistredContractsEndPoint()
{
    global $wpdb;
    $table = $wpdb->prefix . 'registered_contracts';
    $table_contracts = $wpdb->prefix . 'contracts';

    $customer_orders = wc_get_orders(
        array(
            'customer' => get_current_user_id(),
            'limit'    => -1, // 获取所有订单，或者设置一个合适的数量限制
            'orderby'  => 'date',
            'order'    => 'DESC',
        )
    );

    ?><div class="woocommerce-MyAccount-content">
        <?php if ( ! empty( $customer_orders ) ) : ?>
            <table class="woocommerce-orders-table woocommerce-MyAccount-orders shop_table shop_table_responsive my_account_orders account-orders-table">
                <thead>
                    <tr>
                        <th class="woocommerce-orders-table__header">
                            <?php _e('Contract') ?>
                        </th>
                        <th class="woocommerce-orders-table__header">
                            <?php _e('Date') ?>
                        </th>
                        <th class="woocommerce-orders-table__header">
                            <?php _e('File') ?>
                        </th>
                    </tr>
                </thead>

                <tbody>
                    <?php
                    foreach ( $customer_orders as $order ) :
                        $order_id = $order->get_id();

                        // 获取与订单相关的合同信息
                        $contracts = $wpdb->get_results($wpdb->prepare("SELECT contracts.name,registeredcontracts.date,registeredcontracts.file FROM $table registeredcontracts
                            left join $table_contracts contracts ON contracts.id=registeredcontracts.contracts WHERE ref = %d", $order_id));

                        if ( ! empty( $contracts ) ) :
                            foreach ( $contracts as $contract ) :
                    ?>
                                <tr>
                                    <td><?php _e($contract->name); ?></td>
                                    <td><?php echo $contract->date; ?></td>
                                    <td><a href="<?php echo CONTRACT_URL . '/' . $contract->file; ?>" target="_blank" class="woocommerce-button button"><?php _e('Download Contract'); ?></a></td>
                                </tr>
                    <?php
                            endforeach;
                        else :
                    ?>
                            <tr>
                                <td colspan="3"><?php _e('No contracts found for this order.'); ?></td>
                            </tr>
                    <?php
                        endif;
                    endforeach;
                    ?>
                </tbody>
            </table>
        <?php else : ?>
            <p><?php _e('You do not have a registered contract. ') ?></p>
        <?php endif; ?>
    </div>
    <?php
}

在这个修改后的函数中，我们首先获取用户的订单。然后，我们循环遍历每个订单，并使用订单 ID 查询相关的合同信息。最后，我们将合同信息显示在表格中。如果某个订单没有相关的合同，则显示一条消息。

注意事项

• 性能优化: 如果用户订单数量很大，wc_get_orders() 可能会影响性能。可以考虑使用分页或缓存来优化查询。
• 安全: 确保对 $order_id 进行适当的转义和验证，以防止 SQL 注入攻击。
• 错误处理: 添加适当的错误处理机制，以处理查询失败或其他异常情况。

总结

通过使用 wc_get_orders() 函数和用户 ID，我们可以在 WooCommerce 的“我的账户”页面自定义版块中轻松获取订单 ID。然后，我们可以使用订单 ID 查询与特定订单相关的合同信息，并将其显示给用户。请务必注意性能优化、安全性和错误处理，以确保代码的健壮性和安全性。