> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة ووردبريس/ووكوميرس

> دليل الإعداد السريع لإضافة Navio على ووردبريس/ووكوميرس

<div dir="rtl">
  ## نظرة عامة

  Navio لووكوميرس هي إضافة بوابة دفع تدمج Navio مع متجر ووكوميرس الخاص بك. اقبل المدفوعات الآمنة بالدينار الجزائري (DZD) مع إعداد بسيط.

  <CardGroup cols={2}>
    <Card title="تثبيت سهل" icon="download" color="#0D9373">
      التثبيت من ملف ZIP - لا حاجة للبرمجة
    </Card>

    <Card title="فحص تلقائي للحالة" icon="clock-rotate-left" color="#0D9373">
      يتحقق تلقائيًا من حالة الدفع كل 20 دقيقة
    </Card>

    <Card title="دعم كتل ووكوميرس" icon="cubes" color="#0D9373">
      يعمل مع كل من الدفع الكلاسيكي ودفع الكتل
    </Card>

    <Card title="اختبار الوضع التجريبي" icon="flask" color="#0D9373">
      اختبر في الوضع التجريبي قبل البدء
    </Card>
  </CardGroup>

  ## المتطلبات

  <Steps>
    <Step title="ووردبريس و ووكوميرس">
      * ووردبريس 5.0 أو أحدث
      * ووكوميرس 4.0 أو أحدث
      * PHP 7.2 أو أحدث
    </Step>

    <Step title="شهادة SSL">
      يجب تفعيل SSL/HTTPS على موقعك (مطلوب للمدفوعات)
    </Step>

    <Step title="حساب Navio">
      حساب تاجر نشط على [enterprise.oneclickdz.com](https://enterprise.oneclickdz.com/)

      <Warning>
        أكمل التحقق من التاجر قبل إنشاء روابط الدفع
      </Warning>
    </Step>
  </Steps>

  ## الإعداد السريع

  ### 1. تثبيت الإضافة

  <Steps>
    <Step title="تحميل الإضافة">
      قم بتحميل الإضافة من [GitHub](https://github.com/oneclickdz/ocpay_wordpress/releases/download/v2.1.0/ocpay-gateway-2.1.0.zip)
    </Step>

    <Step title="رفع إلى ووردبريس">
      * اذهب إلى **الإضافات ← إضافة جديد**
      * انقر على **رفع إضافة**
      * اختر ملف ZIP
      * انقر على **التثبيت الآن**
    </Step>

    <Step title="التفعيل">
      انقر على **تفعيل الإضافة** بعد التثبيت
    </Step>
  </Steps>

  ### 2. احصل على مفاتيح API الخاصة بك

  1. سجل الدخول إلى [enterprise.oneclickdz.com](https://enterprise.oneclickdz.com/)
  2. اذهب إلى إعدادات API
  3. انسخ كلا المفتاحين:
     * **مفتاح الوضع التجريبي**: للاختبار
     * **مفتاح الإنتاج**: للمدفوعات الفعلية

  <Warning>
    لا تكشف أبدًا مفاتيح API في كود عام أو تشاركها عبر البريد الإلكتروني
  </Warning>

  ### 3. إعداد الإضافة

  <Steps>
    <Step title="افتح الإعدادات">
      اذهب إلى **ووكوميرس ← الإعدادات ← المدفوعات**
    </Step>

    <Step title="اختر Navio">
      انقر على **Navio** في قائمة طرق الدفع
    </Step>

    <Step title="التفعيل والإعداد">
      * **تفعيل/تعطيل**: ضع علامة لتفعيل Navio
      * **العنوان**: "Navio - دفع ون كليك" (يظهر للعملاء)
      * **الوصف**: وصف طريقة الدفع
    </Step>

    <Step title="أضف مفاتيح API">
      * **مفتاح API التجريبي**: مفتاحك التجريبي
      * **مفتاح API الإنتاج**: مفتاح الإنتاج الخاص بك
      * **وضع API**: اختر "Sandbox" للاختبار
    </Step>

    <Step title="إعداد الخيارات">
      * **وضع الرسوم**: اختر من يدفع رسوم المعاملات
        * `NO_FEE`: أنت تتحمل الرسوم (أفضل تجربة للعميل)
        * `SPLIT_FEE`: تقسيم 50/50
        * `CUSTOMER_FEE`: العميل يدفع جميع الرسوم
      * **حالة الطلب**: اختر الحالة بعد نجاح الدفع
        * `Completed`: للمنتجات الرقمية (تسليم تلقائي)
        * `Processing`: للمنتجات المادية (يتطلب التنفيذ)
    </Step>

    <Step title="حفظ الإعدادات">
      انقر على **حفظ التغييرات**
    </Step>
  </Steps>

  ## الاختبار في الوضع التجريبي

  <Note>
    اختبر دائمًا في الوضع التجريبي قبل قبول المدفوعات الحقيقية
  </Note>

  1. **اضبط على الوضع التجريبي**
     * وضع API: `Sandbox (Testing)`
     * استخدم مفتاح API التجريبي الخاص بك

  2. **إنشاء طلب تجريبي**
     * اذهب إلى متجرك
     * أضف منتجًا إلى السلة
     * تابع إلى الدفع
     * اختر طريقة دفع Navio
     * أكمل عملية الدفع

  3. **اختبار تدفق الدفع**
     * سيتم تحويلك إلى صفحة دفع Navio
     * أكمل الدفع التجريبي
     * ارجع إلى متجرك

  4. **التحقق من تحديث الطلب**
     * تحقق من حالة الطلب في ووكوميرس
     * يجب أن يتحدث إلى الحالة المحددة
     * تحقق من سجلات الإضافة: **ووكوميرس ← Navio ← سجلات النشاط**

  ## الانتقال للبيئة الحقيقية

  عندما تكون مستعدًا لقبول المدفوعات الحقيقية:

  <Steps>
    <Step title="التبديل إلى الإنتاج">
      * اذهب إلى **ووكوميرس ← الإعدادات ← المدفوعات ← Navio**
      * غير **وضع API** إلى `Production (Live)`
      * احفظ التغييرات
    </Step>

    <Step title="التحقق من SSL">
      تأكد من أن SSL/HTTPS معدّ بشكل صحيح على موقعك
    </Step>

    <Step title="طلب تجريبي">
      أنشئ طلبًا تجريبيًا صغيرًا للتحقق من أن كل شيء يعمل
    </Step>
  </Steps>

  ## الميزات الأساسية

  ### الفحص التلقائي للحالة

  تفحص الإضافة تلقائيًا حالة الدفع كل 20 دقيقة باستخدام cron ووردبريس:

  * **لا حاجة لتدخل يدوي**
  * تحديث الطلبات تلقائيًا عند تأكيد الدفع
  * المدفوعات الفاشلة تُعلّم كـ "قيد الانتظار"

  ### الفحص اليدوي للحالة

  يمكن للعملاء فحص حالة الدفع يدويًا:

  * متاح على صفحة الطلب
  * انقر على زر "فحص حالة الدفع"
  * تحديث فوري عبر AJAX

  ### أوضاع الرسوم

  | الوضع             | الوصف                | الأفضل لـ         |
  | ----------------- | -------------------- | ----------------- |
  | **NO\_FEE**       | أنت تدفع جميع الرسوم | أفضل تجربة للعميل |
  | **SPLIT\_FEE**    | تقسيم 50/50          | تكلفة مشتركة      |
  | **CUSTOMER\_FEE** | العميل يدفع          | زيادة الأرباح     |

  <Info>
    **هيكل الرسوم**: 0% على الرصيد، رسوم سحب 1% فقط
  </Info>

  ## استكشاف الأخطاء وإصلاحها

  ### بوابة الدفع غير معدة

  **المشكلة**: رسالة خطأ عند تقديم الطلب

  **الحل**:

  * تحقق من إدخال مفتاح API
  * تأكد من أن مفتاح API يطابق الوضع (تجريبي/إنتاج)
  * اختبر الاتصال في إعدادات الإضافة

  ### الطلبات لا تتحدث

  **المشكلة**: الطلبات تبقى "قيد الانتظار" بعد الدفع

  **الحل**:

  1. تحقق من أن cron ووردبريس يعمل
  2. تحقق من حفظ مرجع الدفع في الطلب
  3. فعّل وضع التصحيح في إعدادات الإضافة
  4. تحقق من سجلات النشاط للأخطاء

  ### SSL/HTTPS مطلوب

  **المشكلة**: رسالة خطأ "SSL مطلوب"

  **الحل**:

  * اتصل بمزود الاستضافة لتفعيل SSL
  * استخدم شهادة Let's Encrypt المجانية
  * تحقق من أن عنوان الموقع يبدأ بـ `https://`

  ## وضع التصحيح

  فعّل لاستكشاف الأخطاء:

  1. اذهب إلى **ووكوميرس ← الإعدادات ← المدفوعات ← Navio**
  2. ضع علامة على **تفعيل تسجيل التصحيح**
  3. احفظ التغييرات
  4. اعرض السجلات في **ووكوميرس ← Navio ← سجلات النشاط**

  <Warning>
    عطّل وضع التصحيح في الإنتاج للحصول على أداء أفضل
  </Warning>

  ## الدعم والموارد

  <CardGroup cols={2}>
    <Card title="مستودع GitHub" icon="github" href="https://github.com/oneclickdz/Ocpay_wordpress">
      كود الإضافة والمشاكل
    </Card>

    <Card title="توثيق API" icon="book" href="/ar/api-reference/ocpay/create-link">
      مرجع API مفصل
    </Card>

    <Card title="لوحة تحكم Navio" icon="gauge" href="https://enterprise.oneclickdz.com/">
      إدارة حساب التاجر الخاص بك
    </Card>

    <Card title="اتصل بالدعم" icon="headset" href="/ar/contact">
      احصل على المساعدة من فريقنا
    </Card>
  </CardGroup>

  ## الخطوات التالية

  <Card title="أفضل ممارسات Navio" icon="star" href="/ar/ocpay-guides/4-best-practices">
    تعلم نصائح الإنتاج وأفضل ممارسات الأمان
  </Card>
</div>