WooCommerce 自定义 WP_Query 获取订单详情报错解决方案

心靈之曲
发布: 2025-10-08 10:04:22
原创
171人浏览过

woocommerce 自定义 wp_query 获取订单详情报错解决方案

本文旨在解决在使用自定义 WP_Query 获取 WooCommerce 订单详情时遇到的 500 错误以及数据获取失败的问题。通过分析错误原因,提供了优化后的代码示例,并详细解释了如何正确地使用 WP_Query 来实现订单数据的分页加载和展示,避免常见的错误和陷阱。

在使用 WP_Query 获取 WooCommerce 订单详情时,可能会遇到一些问题,例如服务器返回 500 错误,或者查询结果为空。这些问题通常与查询参数设置不正确、循环使用方式不当,以及对 WooCommerce 对象的使用方式有关。下面将详细介绍如何解决这些问题,并提供一个可用的代码示例。

问题分析

  1. 500 错误: 500 错误通常表示服务器内部错误。在使用 WP_Query 时,如果在循环内部尝试获取订单 ID 或者订单项目时出现问题,可能是因为 $post 对象没有正确设置。
  2. 查询结果为空: 即使没有 500 错误,查询结果也可能为空。这可能是因为查询参数设置不正确,例如 post_type 或 post_status 设置错误,或者分页参数没有正确传递。

解决方案

1. 正确设置 WP_Query 参数

确保 WP_Query 的参数设置正确,特别是 post_type 和 post_status。对于 WooCommerce 订单,post_type 应该是 shop_order,post_status 应该是 wc-completed 或其他订单状态。此外,为了实现分页,需要正确设置 posts_per_page 和 paged 参数。

$paged = max( 1, intval( $_POST[ 'page' ] ) ); // 确保页码大于等于 1
$per_page = 4; // 每页显示的订单数量

$args = array(
    'post_type'      => 'shop_order',
    'post_status'    => 'wc-completed',
    'orderby'        => 'post_date',
    'order'          => 'DESC',
    'posts_per_page' => $per_page,
    'paged'          => $paged,
);

$loop = new WP_Query( $args );
登录后复制

2. 正确使用 the_post() 函数

在 WP_Query 的循环内部,必须调用 the_post() 函数来设置 $post 对象。这使得可以使用 get_the_ID() 函数获取当前订单的 ID。

if ( $loop->have_posts() ) {
    while ( $loop->have_posts() ) {
        $loop->the_post();

        $order_id = get_the_ID(); // 正确获取订单 ID
        $order = wc_get_order( $order_id ); // 使用订单 ID 获取 WC_Order 对象

        // ... 其他代码 ...
    }
    wp_reset_postdata(); // 重置 $post 对象,避免影响其他查询
}
登录后复制

3. 获取订单详情

获取订单详情需要使用 WC_Order 对象。通过 wc_get_order() 函数,可以使用订单 ID 获取 WC_Order 对象,然后使用该对象的方法来获取订单的各种信息,例如订单状态、订单项目、总金额等。

稿定AI文案
稿定AI文案

小红书笔记、公众号、周报总结、视频脚本等智能文案生成平台

稿定AI文案 45
查看详情 稿定AI文案
$order = wc_get_order( $order_id );

if ( $order ) {
    $orders_id = $order->get_id(); // 获取订单 ID
    $status = wc_get_order_status_name( $order->get_status() ); // 获取订单状态名称
    $date_created = $order->get_date_created()->date( 'd/m/Y' ); // 获取订单创建日期
    $payment_method = $order->get_payment_method_title(); // 获取支付方式名称
    $order_total = $order->get_formatted_order_total(); // 获取格式化的订单总金额

    $items = $order->get_items(); // 获取订单项目
    foreach ( $items as $item ) {
        $product_name = $item->get_name(); // 获取产品名称
        $product_id = $item->get_product_id(); // 获取产品ID
        $product = wc_get_product( $product_id ); // 获取产品对象
        if($product){
            $product_image = $product->get_image(); // 获取产品图片
        }
        // ... 其他代码 ...
    }
}
登录后复制

4. 完整代码示例

下面是一个完整的代码示例,展示了如何使用 WP_Query 获取 WooCommerce 订单详情,并进行分页显示:

add_action( 'wp_ajax_demo_pagination_posts', 'demo_pagination_posts' );
add_action( 'wp_ajax_nopriv_demo_pagination_posts', 'demo_pagination_posts' );

function demo_pagination_posts() {
    global $wpdb;
    $msg = '';

    if ( isset( $_POST[ 'page' ] ) ) {
        $paged = max( 1, intval( $_POST[ 'page' ] ) );
        $per_page = 4;

        $args = array(
            'post_type'      => 'shop_order',
            'post_status'    => 'wc-completed',
            'orderby'        => 'post_date',
            'order'          => 'DESC',
            'posts_per_page' => $per_page,
            'paged'          => $paged,
        );

        $loop = new WP_Query( $args );
        $count = $loop->found_posts;

        if ( $loop->have_posts() ) {
            while ( $loop->have_posts() ) {
                $loop->the_post();

                $order_id = get_the_ID();
                $order = wc_get_order( $order_id );

                if ( $order ) {
                    $orders_id = $order->get_id();
                    $status = wc_get_order_status_name( $order->get_status() );
                    $date_created = $order->get_date_created()->date( 'd/m/Y' );
                    $payment_method = $order->get_payment_method_title();
                    $order_total = $order->get_formatted_order_total();

                    $items = $order->get_items();
                    foreach ( $items as $item ) {
                        $product_name = $item->get_name();
                        $product_id = $item->get_product_id();
                        $product = wc_get_product( $product_id );
                        if($product){
                            $product_image = $product->get_image();
                        }

                        $view_order = $order->get_view_order_url();
                        $downloads = $order->get_downloadable_items();
                        $download_button = '';

                        if ( is_array( $downloads ) ) {
                            foreach ( $downloads as $product ) {
                                $download_button = '<a href="' . $product[ 'download_url' ] . '" target="_blank">Download</a>';
                            }
                        }

                        $msg .= '
                            <table class="table_orders" border="2">
                                <tr class="table_row_items">
                                  <td class="product_number">
                                   <span class="mobile title">Ordine</span>
                                   <span>#' . esc_attr( $orders_id ) . '</span>
                                  </td>

                                  <td class="product_name">
                                   <span class="mobile title">Prodotto</span>
                                   <a href="' . wp_kses_post( $view_order ) . '">' . wp_kses_post( $product_name ) . '</a>
                                  </td>

                                  <td class="product_data">
                                   <span class="mobile title">Data</span>
                                   <span>' . wp_kses_post( $date_created ) . '</span>
                                  </td>

                                  <td class="product_price">
                                   <span class="mobile title">Prezzo</span>
                                   <span>' . wp_kses_post( $order_total ) . '</span>
                                  </td>

                                  <td class="product_status">
                                   <span class="mobile title">Stato</span>
                                   <span class="label ' . $order->get_status() . '">' . wp_kses_post( $status ) . '</span>
                                  </td>

                                  <td class="product_action">
                                   <span class="mobile title">File</span>
                                   <a target=”_blank” href="' . esc_url( $view_order ) . '">Visualizza<i class="fa-duotone fa-eye"></i></a>
                                  </td>
                                </tr>    
                            </table> 
                        ';
                    }
                }
            }
            wp_reset_postdata();
        }

        $pages_num = intval( ceil( $count / $per_page ) );
        $is_last_page = $pages_num == $paged;
        $is_first_page = $paged === 1;

        $pagination_html = "<div class='pagination-link'>";
        $pagination_html .= "<ul>";

        if ( !$is_first_page ) {
            $pagination_html .= "<li data-pagenum='" . ( $paged - 1 ) . "' class='active'>Previous</li>";
        } else {
            $pagination_html .= "<li class='inactive'>Previous</li>";
        }

        for ( $i = 1; $i <= $pages_num; $i++ ) {
            if ( $paged == $i ) {
                $pagination_html .= "<li data-pagenum='$i' class = 'selected' >{$i}</li>";
            } else {
                $pagination_html .= "<li data-pagenum='$i' class='active'>{$i}</li>";
            }
        }

        if ( !$is_last_page ) {
            $pagination_html .= "<li data-pagenum='" . ( $paged + 1 ) . "' class='active'>Next</li>";
        } else {
            $pagination_html .= "<li class='inactive'>Next</li>";
        }

        $pagination_html .= "</ul>";
        $pagination_html .= "</div>";

        echo '<div class = "pagination-content">' . $msg . '</div>' .
             '<div class = "pagination-nav">' . $pagination_html . '</div>';
    }

    die();
}
登录后复制

前端代码(custom-template.php):

<div class="wrap">
    <div id="primary" class="content-area">
        <div class="col-md-12 content">
            <div class="inner-box content no-right-margin darkviolet">
                <script type="text/javascript">
                    jQuery(document).ready(function ($) {
                        var ajaxurl = '<?php echo admin_url( 'admin-ajax.php' ); ?>';

                        function load_all_posts(page) {
                            var data = {
                                page: page,
                                action: "demo_pagination_posts"
                            };

                            $.post(ajaxurl, data, function (response) {
                                $(".pagination_container").html(response);
                            });
                        }

                        load_all_posts(1);

                        $(document).on('click', '.pagination-link ul li', function () {
                            var page = $(this).attr('data-pagenum');
                            load_all_posts(page);
                        });
                    });
                </script>
                <div class="pag_loading">
                    <div class="pagination_container">
                        <div class="post-content"></div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>
登录后复制

5. 注意事项

  • 安全性: 对 $_POST['page'] 进行严格的验证和过滤,防止 SQL 注入攻击。使用 intval() 函数将其转换为整数,并确保其值大于等于 1。
  • 性能: 避免在循环内部执行复杂的数据库查询或计算,以提高性能。
  • 错误处理: 添加适当的错误处理机制,例如检查 wc_get_order() 函数是否返回有效的 WC_Order 对象。
  • 代码重用: 将代码封装成函数或类,以便在其他地方重用。

总结

通过正确设置 WP_Query 参数、使用 the_post() 函数、获取订单详情,并添加适当的错误处理机制,可以解决在使用自定义 WP_Query 获取 WooCommerce 订单详情时遇到的问题。以上提供的代码示例可以作为一个起点,根据实际需求进行修改和扩展。记住要始终关注代码的安全性、性能和可维护性。

以上就是WooCommerce 自定义 WP_Query 获取订单详情报错解决方案的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号