إضافة KYC لووردبريس: التحقق من العمر في WooCommerce

​

المتطلبات الأساسية

• WordPress 6.0 أو أحدث
• PHP 7.4 أو أحدث
• حساب في Didit Console

​

الخطوة 1: احصل على بيانات اعتماد Didit الخاصة بك

1. سجّل الدخول أو أنشئ حسابًا على business.didit.me
2. انتقل إلى API وwebhook وانسخ مفتاح API
3. انتقل إلى Workflows، وأنشئ سير عمل أو اختر واحدًا، ثم انسخ Workflow ID

​

الخطوة 2: ثبّت الإضافة

1. نزّل الملف didit-verify-0.3.4.zip من إصدار 0.3.4
2. في لوحة إدارة WordPress، انتقل إلى Plugins → Add New → Upload Plugin
3. اختر ملف ZIP الذي نزّلته، ثم انقر Install Now
4. انقر تفعيل

​

الخطوة 3: اضبط الإضافة

​

اختر وضعك

​

اضبط خيارات الجلسة (وضع API فقط)

• Vendor Data: يربط كل عملية تحقق بمستخدم محدد في لوحة تحكم Didit، فيتيح لك تتبع من قام بالتحقق. القيمة الافتراضية هي معرّف مستخدم WordPress (مثل wp-42). يمكنك أيضًا اختيار بريد المستخدم الإلكتروني، أو بادئة مخصصة، أو تعطيله.
• Callback URL: صفحة على موقعك يُعاد إليها المستخدمون بعد التحقق. يضيف Didit المعاملين verificationSessionId وstatus كمعاملات استعلام.
• Callback Method: الجهاز الذي يتعامل مع إعادة التوجيه: initiator (الجهاز الذي بدأ العملية)، أو completer (الجهاز الذي أنهاها)، أو both.
• Language: اختر من بين 54 لغة، أو دع الإضافة تكتشف اللغة تلقائيًا من المتصفح.

​

اضبط خيارات العرض

• Display Mode: Modal (نافذة منبثقة فوق الصفحة) أو Embedded (مدمج داخل الصفحة)
• Close Button: إظهار زر X في النافذة المنبثقة أو إخفاؤه
• Exit Confirmation: عرض مربع حوار “هل أنت متأكد؟” عند الإغلاق
• Auto-close: إغلاق النافذة المنبثقة تلقائيًا عند اكتمال التحقق
• Debug Logging: تسجيل أحداث SDK في وحدة تحكم المتصفح (للمساعدة في استكشاف الأخطاء)

​

خصّص الزر

• نص الزر ونص النجاح
• لون الخلفية ولون النص
• نصف قطر الحواف والحشو وحجم الخط

​

الخطوة 4: أضف التحقق إلى موقعك

​

لمتاجر WooCommerce

1. في الإعدادات → Didit Verify → WooCommerce، فعّل Require identity verification at checkout
2. اختر مكان ظهور قسم التحقق:
   • أعلى صفحة الدفع
   • بعد تفاصيل الفوترة
   • بعد ملاحظات الطلب
   • قبل Place Order (موصى به)
3. اختياريًا، اختر Product Scope: جميع المنتجات (الخيار الافتراضي)، أو المنتجات المحددة فقط، أو جميع المنتجات باستثناء المحددة. علّم المنتجات بمربع Didit verification ضمن Product data → Advanced في محرر المنتج. تتطلب السلة التي تحتوي على منتج واحد على الأقل يحتاج إلى التحقق هذا التحقق. ينطبق النطاق على وضعي الدفع والوضع بعد الشراء معًا.
4. اختياريًا، عدّل Section Title وCheckout Message وPost-purchase Message ضمن الإعدادات → Didit Verify → WooCommerce؛ إذا تُركت الحقول فارغة يُستخدم النص الافتراضي.
5. اختياريًا، فعّل Send Billing Data لإرسال اسم العميل وبريده الإلكتروني وهاتفه وعنوانه تلقائيًا إلى Didit لتعبئتها مسبقًا والتحقق من صحتها بشكل متبادل.

​

لأي صفحة في WordPress

[didit_verify]

[didit_verify text="Verify Now" success_text="Done!"]

[didit_verify mode="embedded"]

​

الخطوة 5: تقييد المحتوى على المستخدمين الموثَّقين (اختياري)

[didit_gate]
This content is only visible to verified users.
[/didit_gate]

[didit_gate message="Please verify to continue."]Secret content here.[/didit_gate]

[didit_status]

​

التحقق من حالة التحقق

​

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

​

الأمان

1. CSRF nonce: يجب أن تصدر الطلبات من موقع WordPress الخاص بك
2. شرط تسجيل الدخول: المستخدمون المسجَّلون فقط يمكنهم إنشاء الجلسات (قابل للتهيئة)
3. تقييد المعدل: 10 جلسات/ساعة لكل مستخدم، و3/ساعة لكل عنوان IP للزوار
4. تعقيم المدخلات: جميع الحقول مُدرجة في القائمة البيضاء ومعقّمة على الخادم

​

للمطورين

​

خطافات PHP

// When a user completes verification
add_action('didit_verification_completed', function ($user_id, $session_id, $status) {
    // Update CRM, send email, grant access, etc.
}, 10, 3);

// When a user cancels verification
add_action('didit_verification_cancelled', function ($user_id, $session_id) {
    // Log cancellation
}, 10, 2);

// When a session is created server-side
add_action('didit_session_created', function ($url, $user_id, $vendor_data) {
    // Log, notify, etc.
}, 10, 3);

​

حدث JavaScript

document.addEventListener('didit:complete', function (e) {
    console.log('Result:', e.detail); // { type, session }
});

​

التحقق من حالة التحقق في PHP

$is_verified = Didit_Verify::init()->is_user_verified($user_id);

​

المصادر

• كود المكوّن الإضافي المصدري (GitHub)
• وثائق Didit API
• Didit Console
• مرجع Create Session API