📋 فصل ۳: سفارش‌ها و فرآیند پرداخت

سبد خرید
   ↓
صفحه پرداخت (Checkout)
   ↓
ثبت سفارش → وضعیت: pending (در انتظار پرداخت)
   ↓
هدایت به درگاه پرداخت
   ↓ (پرداخت موفق)
وضعیت: processing (در حال پردازش)
   ↓ (آماده‌سازی و ارسال)
وضعیت: completed (تکمیل شده)

مسیرهای دیگر:
   - failed (ناموفق) → پرداخت رد شد
   - cancelled (لغو شده)
   - refunded (مسترد شده)
   - on-hold (در انتظار)

$order = wc_get_order( $order_id );

// اطلاعات کلی
$order->get_id();                      // شناسه سفارش
$order->get_order_number();            // شماره سفارش (می‌تواند با ID متفاوت باشد)
$order->get_status();                  // وضعیت بدون wc-
$order->get_currency();                // ارز
$order->get_total();                   // مجموع
$order->get_subtotal();                // جمع آیتم‌ها
$order->get_total_tax();               // مالیات
$order->get_shipping_total();          // هزینه ارسال
$order->get_total_discount();          // تخفیف
$order->get_payment_method();          // slug درگاه
$order->get_payment_method_title();    // نام درگاه
$order->get_transaction_id();          // ID تراکنش از درگاه

// مشتری
$order->get_customer_id();             // 0 اگر مهمان باشد
$order->get_user();                    // WP_User
$order->get_billing_email();
$order->get_billing_phone();
$order->get_billing_first_name();
$order->get_billing_last_name();
$order->get_billing_address_1();
$order->get_billing_city();
$order->get_billing_state();
$order->get_billing_postcode();
$order->get_billing_country();

// آدرس ارسال (ممکن است متفاوت با صورتحساب باشد)
$order->get_shipping_first_name();
$order->get_shipping_address_1();
// ...

// آیتم‌های سفارش
foreach ( $order->get_items() as $item_id => $item ) {
    $item_name     = $item->get_name();
    $product_id    = $item->get_product_id();
    $variation_id  = $item->get_variation_id();
    $quantity      = $item->get_quantity();
    $subtotal      = $item->get_subtotal();
    $total         = $item->get_total();
    $product       = $item->get_product();
    $meta_data     = $item->get_meta_data();
}

// آیتم‌های ارسال و کوپن
foreach ( $order->get_items( 'shipping' ) as $shipping_item ) { /* ... */ }
foreach ( $order->get_items( 'fee' ) as $fee_item ) { /* ... */ }
foreach ( $order->get_items( 'coupon' ) as $coupon_item ) { /* ... */ }

// به‌روزرسانی وضعیت با یادداشت
$order->update_status( 'completed', 'سفارش با موفقیت تحویل داده شد.' );

// افزودن یادداشت داخلی (فقط ادمین می‌بیند)
$order->add_order_note( 'یادداشت داخلی: انبار شماره ۲', false );

// افزودن یادداشت برای مشتری (ایمیل می‌شود)
$order->add_order_note( 'بسته شما در حال ارسال است.', 1 );

// متادیتای سفارش
$order->update_meta_data( '_my_custom_field', 'value' );
$value = $order->get_meta( '_my_custom_field' );
$order->save();

// روش پیشنهادی (سازگار با HPOS)
$orders = wc_get_orders( [
    'status'        => [ 'processing', 'completed' ],
    'limit'         => 50,
    'orderby'       => 'date',
    'order'         => 'DESC',
    'date_created'  => '>=' . strtotime( '-30 days' ),
    'customer_id'   => 0, // فقط مهمان‌ها
] );

foreach ( $orders as $order ) {
    echo $order->get_id() . ' - ' . $order->get_total() . PHP_EOL;
}

// فیلتر بر اساس آیتم خاص
$orders = wc_get_orders( [
    'limit' => -1,
    'meta_key' => '_payment_method',
    'meta_value' => 'zarinpal',
] );

// سفارش‌های یک مشتری خاص
$customer_orders = wc_get_orders( [
    'customer_id' => 123,
    'limit'       => -1,
] );

function icsd_create_manual_order( $items, $customer_data ) {
    // ساخت سفارش
    $order = wc_create_order();
    
    // افزودن محصولات
    foreach ( $items as $item ) {
        $product = wc_get_product( $item['product_id'] );
        $order->add_product( $product, $item['quantity'] );
    }
    
    // آدرس صورتحساب
    $order->set_address( [
        'first_name' => $customer_data['first_name'],
        'last_name'  => $customer_data['last_name'],
        'phone'      => $customer_data['phone'],
        'email'      => $customer_data['email'],
        'address_1'  => $customer_data['address'],
        'city'       => $customer_data['city'],
        'state'      => $customer_data['state'],
        'postcode'   => $customer_data['postcode'],
        'country'    => 'IR',
    ], 'billing' );
    
    // اگر مشتری ثبت‌نام کرده
    if ( ! empty( $customer_data['user_id'] ) ) {
        $order->set_customer_id( $customer_data['user_id'] );
    }
    
    // افزودن هزینه ارسال
    $shipping_item = new WC_Order_Item_Shipping();
    $shipping_item->set_method_title( 'پست پیشتاز' );
    $shipping_item->set_method_id( 'flat_rate' );
    $shipping_item->set_total( 50000 );
    $order->add_item( $shipping_item );
    
    // محاسبه مجموع
    $order->calculate_totals();
    
    // وضعیت اولیه
    $order->set_status( 'processing', 'سفارش حضوری توسط ادمین ثبت شد.' );
    
    // متادیتای اختصاصی
    $order->update_meta_data( '_icsd_order_source', 'in_store' );
    $order->update_meta_data( '_icsd_seller', get_current_user_id() );
    
    // ذخیره
    $order_id = $order->save();
    
    return $order_id;
}

<?php
class ICSD_Custom_Order_Statuses {
    
    public function __construct() {
        add_action( 'init', [ $this, 'register_statuses' ] );
        add_filter( 'wc_order_statuses', [ $this, 'add_to_list' ] );
        add_filter( 'bulk_actions-edit-shop_order', [ $this, 'add_bulk_actions' ] );
    }
    
    public function register_statuses() {
        register_post_status( 'wc-designing', [
            'label'                     => 'در حال طراحی',
            'public'                    => true,
            'show_in_admin_status_list' => true,
            'show_in_admin_all_list'    => true,
            'exclude_from_search'       => false,
            'label_count'               => _n_noop(
                'در حال طراحی (%s)',
                'در حال طراحی (%s)'
            ),
        ] );
        
        register_post_status( 'wc-weaving', [
            'label'                     => 'در حال بافت',
            'public'                    => true,
            'show_in_admin_status_list' => true,
            'show_in_admin_all_list'    => true,
            'exclude_from_search'       => false,
            'label_count'               => _n_noop(
                'در حال بافت (%s)',
                'در حال بافت (%s)'
            ),
        ] );
        
        register_post_status( 'wc-ready-to-ship', [
            'label'                     => 'آماده ارسال',
            'public'                    => true,
            'show_in_admin_status_list' => true,
            'show_in_admin_all_list'    => true,
            'exclude_from_search'       => false,
            'label_count'               => _n_noop(
                'آماده ارسال (%s)',
                'آماده ارسال (%s)'
            ),
        ] );
    }
    
    public function add_to_list( $order_statuses ) {
        $new_statuses = [];
        
        foreach ( $order_statuses as $key => $status ) {
            $new_statuses[ $key ] = $status;
            
            // بعد از processing، وضعیت‌های ما را اضافه کن
            if ( 'wc-processing' === $key ) {
                $new_statuses['wc-designing']     = 'در حال طراحی';
                $new_statuses['wc-weaving']        = 'در حال بافت';
                $new_statuses['wc-ready-to-ship']  = 'آماده ارسال';
            }
        }
        
        return $new_statuses;
    }
    
    public function add_bulk_actions( $actions ) {
        $actions['mark_designing']     = 'تغییر به: در حال طراحی';
        $actions['mark_weaving']        = 'تغییر به: در حال بافت';
        $actions['mark_ready-to-ship']  = 'تغییر به: آماده ارسال';
        return $actions;
    }
}

new ICSD_Custom_Order_Statuses();

// رنگ‌بندی وضعیت‌های سفارشی در پیشخوان
add_action( 'admin_head', 'icsd_custom_status_colors' );
function icsd_custom_status_colors() {
    ?>