آموزش نمایش جزئیات سفارشات ووکامرس + پادکست صوتی

قبل از شروع مقاله ، اگه حوصله یا فرصت مطالعه این مقاله رو ندارید ، پیشنهاد می کنیم پادکست صوتی زیر که با ابزار هوش مصنوعی (گوگل notebooklm ) به زبان فارسی توسط تیم پروان وب تولید شده است ، گوش کنید.

ووکامرس یکی از محبوب‌ترین افزونه‌ها برای ایجاد فروشگاه‌های آنلاین با وردپرس است. این ابزار امکانات گسترده‌ای برای مدیریت فروشگاه، از جمله نمایش جزئیات سفارشات ووکامرس، فراهم می‌کند. اما گاهی نیاز داریم صفحه‌ای اختصاصی طراحی کنیم که به‌صورت سفارشی و دقیق جزئیات سفارشات مشتریان ووکامرس را نمایش دهد.

در این مقاله یاد می‌گیریم چگونه صفحه‌ای سفارشی برای نمایش جزئیات سفارش ووکامرس طراحی کنیم تا کاربران بتوانند با وارد کردن شناسه سفارش، اطلاعات دقیق خرید خود را مشاهده کنند.

چرا طراحی صفحه جزئیات سفارش ووکامرس اهمیت دارد؟

ساخت یک صفحه سفارشی برای نمایش جزئیات سفارش ووکامرس می‌تواند تجربه کاربری فروشگاه شما را به شکل چشمگیری بهبود دهد. این صفحه به مشتریان امکان می‌دهد خیلی سریع به اطلاعات مهم مثل وضعیت سفارش، تاریخ تحویل، جزئیات محصولات و روش ارسال دسترسی داشته باشند.

همچنین با طراحی صفحه جزئیات سفارش ووکامرس می‌توانید امکانات اضافی مثل نمایش پیام‌های سفارشی، لینک‌های دسترسی سریع به پشتیبانی یا حتی نوار پیشرفت وضعیت سفارش را اضافه کنید. چنین امکاناتی باعث افزایش رضایت مشتریان و کاهش تماس‌های پشتیبانی می‌شود.

نحوه دریافت داده‌های سفارشات مشتریان ووکامرس

در ووکامرس، شیء $order یکی از مهم‌ترین بخش‌هاست که شامل تمام اطلاعات مربوط به یک سفارش خاص می‌شود. با استفاده از این شیء می‌توانید به جزئیات مختلف سفارش مانند شناسه، تاریخ، اطلاعات صورتحساب، حمل و نقل، محصولات خریداری‌شده و وضعیت سفارش دسترسی پیدا کنید.

1️⃣ بازیابی شیء سفارش

برای شروع، باید شیء سفارش را با استفاده از تابع wc_get_order() بازیابی کنید. این تابع به عنوان ورودی شناسه سفارش (Order ID) را می‌گیرد و یک شیء سفارش برمی‌گرداند.

$order_id = 123; // مثال: شناسه سفارش
$order = wc_get_order( $order_id );

2️⃣ اطلاعات اولیه سفارش

پس از اینکه شیء سفارش را دریافت کردید، می‌توانید اطلاعات اولیه آن را به راحتی استخراج کنید:

✅ شناسه سفارش:

$order_id = $order->get_id();
echo 'Order ID: ' . $order_id;

✅ تاریخ ثبت سفارش:

$order_date = $order->get_date_created();
echo 'Order date: ' . wc_format_datetime( $order_date );

✅ جمع کل سفارش:

$order_total = $order->get_formatted_order_total();
echo 'Order total: ' . $order_total;

✅ دریافت ارز سفارش:

echo $order->get_currency(); // مثلاً: 'IRR', 'USD'

3️⃣ اطلاعات صورتحساب (Billing)

اطلاعات صورتحساب شامل جزئیاتی است که مشتری هنگام ثبت سفارش وارد کرده است. این اطلاعات شامل نام، آدرس، ایمیل و تلفن می‌باشد:

✅ آدرس کامل صورتحساب:

$billing_address = $order->get_formatted_billing_address();
echo 'Billing address: ' . $billing_address;

✅ نام کوچک و نام خانوادگی:

echo $order->get_billing_first_name(); // نام کوچک
echo $order->get_billing_last_name();  // نام خانوادگی

✅ ایمیل صورتحساب:

$billing_email = $order->get_billing_email();
echo 'Billing email: ' . $billing_email;

✅ تلفن صورتحساب:

$billing_phone = $order->get_billing_phone();
echo 'Billing phone: ' . $billing_phone;

✅ آدرس صورتحساب:

echo $order->get_billing_address_1(); // آدرس

4️⃣ اطلاعات حمل و نقل (Shipping)

اطلاعات حمل و نقل هم دقیقاً مشابه صورتحساب قابل دسترسی است و شامل اطلاعات گیرنده و آدرس ارسال می‌شود:

✅ آدرس کامل ارسال:

$shipping_address = $order->get_formatted_shipping_address();
echo 'Shipping address: ' . $shipping_address;

✅ جزئیات آدرس ارسال:

echo $order->get_shipping_first_name();  // نام کوچک گیرنده
echo $order->get_shipping_last_name();   // نام خانوادگی گیرنده
echo $order->get_shipping_address_1();   // آدرس ارسال
echo $order->get_shipping_city();        // شهر
echo $order->get_shipping_postcode();    // کد پستی

5️⃣ اقلام موجود در سفارش (Products)

برای نمایش آیتم‌های خریداری‌شده، می‌توانید اطلاعات محصولات، تعداد و قیمت هر آیتم را بازیابی کنید:

$items = $order->get_items();

foreach ( $items as $item_id => $item ) {
    $product = $item->get_product();
    echo 'Product name: ' . $item->get_name() . '<br>';
    echo 'Quantity: ' . $item->get_quantity() . '<br>';
    echo 'Total: ' . wc_price( $item->get_total() ) . '<br>';
}

6️⃣ روش پرداخت و ارسال

✅ روش پرداخت:

$payment_method = $order->get_payment_method_title();
echo 'Payment method: ' . $payment_method;

✅ روش ارسال:

$shipping_methods = $order->get_shipping_methods();

foreach ( $shipping_methods as $shipping_method ) {
    echo 'Shipping method: ' . $shipping_method->get_name();
}

7️⃣ وضعیت سفارش

برای دریافت وضعیت فعلی سفارش (مثل: در حال پردازش، تکمیل شده و …) از این روش استفاده کنید:

$order_status = wc_get_order_status_name( $order->get_status() );
echo 'Order status: ' . $order_status;

8️⃣ یادداشت مشتری (Customer Note)

اگر مشتری هنگام ثبت سفارش یادداشتی نوشته باشد، می‌توانید آن را با این کد دریافت کنید:

echo $order->get_customer_note();

9️⃣ دریافت آیتم‌های سفارش به‌صورت پیشرفته

اگر بخواهید اطلاعات بیشتری مثل SKU یا ویژگی‌های هر محصول را نمایش دهید:

foreach ( $order->get_items() as $item_id => $item ) {
    $product = $item->get_product();
    echo 'Product name: ' . $item->get_name() . '<br>';
    echo 'SKU: ' . $product->get_sku() . '<br>';
    echo 'Quantity: ' . $item->get_quantity() . '<br>';
    echo 'Total: ' . wc_price( $item->get_total() ) . '<br>';
}

🔟 نمایش داینامیک اطلاعات سفارش در صفحه حساب کاربری

اگر بخواهید به‌شکل داینامیک اطلاعات سفارش فعلی (مثلاً در صفحه /my-account/view-order/) را نمایش دهید:

if ( is_wc_endpoint_url( 'view-order' ) && isset( $_GET['order'] ) ) {
    $order_id = absint( $_GET['order'] );
    $order = wc_get_order( $order_id );
    // سپس اطلاعات سفارش را نمایش دهید
}

با استفاده از مثال‌های بالا می‌توانید تمام اطلاعات سفارشات ووکامرس را به‌صورت کامل مدیریت و نمایش دهید. این روش‌ها برای:

• نمایش جزئیات سفارش به مشتریان

• توسعه قالب‌ها و افزونه‌های سفارشی

• مدیریت پیشرفته سفارشات

کاربرد زیادی دارند و کمک می‌کنند کنترل کامل روی داده‌های سفارشات داشته باشید.

طراحی صفحه سفارشی نمایش جزئیات سفارش

برای طراحی یک صفحه اختصاصی نمایش جزئیات سفارش ووکامرس مراحل زیر را طی کنید:

مرحله ۱: ایجاد قالب سفارشی

در پوشه قالب فرزند خود یک فایل جدید به نام page-order-details.php بسازید و کد زیر را داخل آن قرار دهید:

<?php
/**
 * Template Name: Order Details
 */
get_header();
?>
<div id="primary" class="content-area">
    <main id="main" class="site-main">
        <?php
        if (isset($_GET['order_id'])) {
            $order_id = intval($_GET['order_id']);
            display_order_details($order_id);
        } else {
            echo '<p>لطفاً شناسه سفارش را وارد کنید.</p>';
        }
        ?>
    </main>
</div>
<?php
get_footer();

function display_order_details($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) {
        echo '<p>شناسه سفارش معتبر نیست.</p>';
        return;
    }

    echo '<h2>جزئیات سفارش</h2>';
    echo '<ul>';
    echo '<li>شناسه سفارش: ' . $order->get_id() . '</li>';
    echo '<li>تاریخ سفارش: ' . wc_format_datetime($order->get_date_created()) . '</li>';
    echo '<li>جمع کل: ' . $order->get_formatted_order_total() . '</li>';
    echo '<li>آدرس صورتحساب: ' . $order->get_formatted_billing_address() . '</li>';
    echo '<li>آدرس ارسال: ' . $order->get_formatted_shipping_address() . '</li>';
    echo '<li>ایمیل مشتری: ' . $order->get_billing_email() . '</li>';
    echo '<li>روش پرداخت: ' . $order->get_payment_method_title() . '</li>';
    echo '<li>وضعیت سفارش: ' . wc_get_order_status_name($order->get_status()) . '</li>';
    echo '</ul>';

    echo '<h3>اقلام سفارش</h3>';
    echo '<ul>';
    foreach ($order->get_items() as $item) {
        echo '<li>';
        echo 'نام محصول: ' . $item->get_name() . '<br>';
        echo 'تعداد: ' . $item->get_quantity() . '<br>';
        echo 'جمع: ' . wc_price($item->get_total());
        echo '</li>';
    }
    echo '</ul>';
}
?>

بعد از ذخیره فایل، وارد داشبورد وردپرس شوید و یک صفحه جدید بسازید. از بخش “ویژگی‌های صفحه”، قالب “Order Details” را انتخاب کنید. حالا کافی است به صفحه جدید بروید و شناسه سفارش را به شکل زیر به URL اضافه کنید:

https://yourwebsite.com/order-details/?order_id=12 

روش آسان‌تر: استفاده از کد کوتاه پیگیری سفارش ووکامرس

اگر نمی‌خواهید وارد کدنویسی شوید، می‌توانید از کد کوتاه [ woocommerce_order_tracking ] استفاده کنید. کافی است یک صفحه جدید بسازید و این شورت‌کد را در آن قرار دهید. کاربران با وارد کردن شماره سفارش و ایمیل، اطلاعات سفارش خود را مشاهده خواهند کرد.

نتیجه‌گیری

نمایش جزئیات سفارشات ووکامرس به مشتریان، شفافیت فروشگاه شما را افزایش می‌دهد و باعث رضایت بیشتر کاربران می‌شود. چه از طریق طراحی صفحه جزئیات سفارش ووکامرس به صورت سفارشی و چه با استفاده از کد کوتاه آماده، می‌توانید تجربه کاربری را به سطح بالاتری ببرید.