إضافة حقل مخصص لصفحة الدفع في ووكومرس وحفظه في الطلب (كود كامل)

/**
 * حقل "وقت التوصيل المفضل" في صفحة الدفع — ووكومرس
 * يعمل مع صفحة الدفع الكلاسيكية (Shortcode). لصفحة الدفع بالكتل انظر الملاحظة أدناه.
 */

// 1) إضافة الحقل بعد حقول الفوترة
add_action( 'woocommerce_after_order_notes', 'mirror_delivery_time_field' );
function mirror_delivery_time_field( $checkout ) {
    echo '<div id="mirror_delivery_time_wrap"><h3>وقت التوصيل</h3>';

    woocommerce_form_field( 'mirror_delivery_time', array(
        'type'     => 'select',
        'class'    => array( 'form-row-wide' ),
        'label'    => 'وقت التوصيل المفضل',
        'required' => true,
        'options'  => array(
            ''          => 'اختر الوقت المناسب',
            'morning'   => 'صباحًا (9 – 12)',
            'afternoon' => 'ظهرًا (12 – 4)',
            'evening'   => 'مساءً (4 – 9)',
        ),
    ), $checkout->get_value( 'mirror_delivery_time' ) );

    echo '</div>';
}

// 2) التحقق قبل إتمام الطلب
add_action( 'woocommerce_checkout_process', function () {
    if ( empty( $_POST['mirror_delivery_time'] ) ) {
        wc_add_notice( 'من فضلك اختر وقت التوصيل المفضل.', 'error' );
    }
} );

// 3) الحفظ في الطلب
add_action( 'woocommerce_checkout_create_order', function ( $order ) {
    if ( ! empty( $_POST['mirror_delivery_time'] ) ) {
        $order->update_meta_data( '_mirror_delivery_time', sanitize_text_field( wp_unslash( $_POST['mirror_delivery_time'] ) ) );
    }
} );

// 4) نص مقروء للقيمة
function mirror_delivery_time_label( $key ) {
    $labels = array(
        'morning'   => 'صباحًا (9 – 12)',
        'afternoon' => 'ظهرًا (12 – 4)',
        'evening'   => 'مساءً (4 – 9)',
    );
    return $labels[ $key ] ?? $key;
}

// 5) العرض في لوحة التحكم (صفحة الطلب)
add_action( 'woocommerce_admin_order_data_after_shipping_address', function ( $order ) {
    $value = $order->get_meta( '_mirror_delivery_time' );
    if ( $value ) {
        echo '<p><strong>وقت التوصيل:</strong> ' . esc_html( mirror_delivery_time_label( $value ) ) . '</p>';
    }
} );

// 6) العرض في الإيميلات وصفحة "شكرًا"
add_filter( 'woocommerce_get_order_item_totals', function ( $totals, $order ) {
    $value = $order->get_meta( '_mirror_delivery_time' );
    if ( $value ) {
        $totals['mirror_delivery_time'] = array(
            'label' => 'وقت التوصيل:',
            'value' => mirror_delivery_time_label( $value ),
        );
    }
    return $totals;
}, 10, 2 );