Referral Rewards for WooCommerce & TeraWallet

التثبيت والتفعيل والاعتماديات

1. خذ نسخة احتياطية من الملفات وقاعدة البيانات، وجرّب التثبيت على نسخة تجريبية إذا كان الموقع يستقبل طلبات أو مشاهدين.
2. نزّل ملف ZIP الخاص بالإضافة من حسابك أو رابط التنزيل المصرّح به. من ووردبريس افتح «الإضافات ← أضف إضافة جديدة ← رفع إضافة»، واختر الملف ثم ثبّت وفعّل.
3. افتح قائمة الإضافة ثم شاشة «التفعيل» أو «التفعيل والتحديثات»، وأدخل كود الترخيص المخصص لها. راجع الدومين وحالة التفعيل وعدد المواقع المسموح بها.
4. اضبط الإعدادات واحفظها، ثم اختبر بحساب مستخدم عادي؛ حساب المدير قد يمتلك استثناءات لا يمتلكها العميل.

الحد الأدنى المسجّل لهذه الإضافات: WordPress 5.6 وPHP 7.4. هذه حدود توافق وليست توصية باستخدام نسخ قديمة. حالة «تم الاختبار حتى» المعروضة في صفحة المنتج تصف بيانات الإصدار ولا تعني أن كل تركيب من القوالب والإضافات مختبَر.

تحتاج WooCommerce 5.0 أو أحدث للمتجر. TeraWallet اختياري للصرف إلى المحفظة، وLearnPress اختياري لعرض لوحة المستخدم في ملفه. بدون TeraWallet تُسجل المكافآت كنقاط وفق الإعدادات بدل الاعتماد على رصيد المحفظة.

بعد التفعيل افتح «مكافآت الإحالة»، واضبط الخصم والعمولة وطريقة المكافأة. من «الأدوات» ولّد الأكواد الناقصة للمستخدمين الحاليين. الإضافة المقفولة بدون ترخيص لا تُحمّل حساب العمولات أو واجهاتها المعتادة؛ ابدأ بحل التفعيل.

أول إحالة من الرابط حتى المكافأة

1. جهز حساب محيل وحساب مشترٍ مختلفين؛ الإحالة الذاتية ممنوعة بالحساب وبريد الفوترة.
2. من لوحة المحيل انسخ كود الإحالة أو رابط الدعوة.
3. افتح الرابط بحساب المشتري، وأضف منتجًا مسموحًا وتحقق من ظهور الخصم قبل الدفع.
4. أكمل طلبًا تجريبيًا حتى الحالة التي تعتمدها إعدادات البرنامج.
5. راجع سجل الإحالات والمبلغ المحجوز/المعتمد وطريقة صرفه.
6. جرّب إلغاء أو استرجاع الطلب على بيئة الاختبار وتحقق من انعكاس العمولة دون إضافة مكافأة ثانية.

لا تستخدم نفس الحساب في طرفي الاختبار، ولا تعتمد على رقم الإحصائيات وحده؛ افتح سجل الطلب والإحالة.

العمولات والنسب الخاصة والمجموعات

اختَر نسبة مئوية أو مبلغًا ثابتًا واضبط السقف إن احتجت. افصل بين خصم المشتري وعمولة المحيل ومكافأة المشتري؛ الثلاثة إعدادات مختلفة وقد تجتمع في الطلب نفسه.

• نسبة المحيل الخاصة: من تفاصيل المحيل اختر توريث أو نسبة أو مبلغ ثابت أو بدون عمولة. النسبة الفردية تتقدم على مجموعة المستخدم ومستواه والنسبة العامة.
• المجموعات: اضبط السيلز والعملاء كلًا على حدة. يمكن دفع السيلز للمحفظة والعملاء بالنقاط، مع تخصيص المجموعة للمستخدم عند الحاجة.
• المستويات: يمكن أن تضيف نسبة أو تبقى للعرض؛ راجع تأثيرها مع النسبة الفردية.
• المنتج والتصنيف: راجع العمولة الخاصة أو المبلغ لكل قطعة والاستثناء، خصوصًا عندما تبدو نتيجة طلب مختلف غير متوقعة.
• الحملات والشبكة: قد تضيف تأثيرًا آخر على الحساب؛ اختبر القواعد مجتمعة قبل إعلان نسبة موحدة للجميع.

مثال توضيحي: أساس عمولة مؤهل 1000 ونسبة فعالة 10% ينتجان 100 قبل أي سقف أو قواعد إضافية. أساس الحساب الفعلي وإعداداته أهم من إجمالي الطلب الظاهر؛ راجع الشحن والضرائب والخصومات والاستثناءات في إعداداتك.

مكافأة المشتري ونقاط الشراء

مكافأة المشتري الذي استخدم إحالة منفصلة عن خصمه وعن عمولة المحيل. حدّد نوع المكافأة وقيمتها وسقفها وحد الطلب الأدنى وفترة حجزها. جرّب الطلب بحساب المشتري وتحقق من سجله هو أيضًا.

نقاط الشراء تكافئ العميل على مشترياته، وليست إحالة جديدة. اضبط قواعدها ومعامل التحويل، ثم اختبر منتجًا مؤهلًا وآخر مستثنى. عند تشغيل أكثر من مكافأة، راجع النتيجة الإجمالية بدل اعتبار ظهور نقطتين تكرارًا تلقائيًا.

اختبار التغيير يجب أن يشمل طلبًا جديدًا؛ تغيير النسبة لا يعني إعادة حساب السجلات القديمة أو صرف فرقها تلقائيًا.

الانضمام وإدارة المحيلين

يمكن فتح البرنامج للمستخدمين أو طلب انضمام بموافقة الإدارة. اضبط النموذج والحقول والمرفقات المطلوبة ورسائل الحالة، ثم قدّم طلبًا بحساب تجريبي.

1. افتح قائمة المحيلين وابحث بالحالة أو المستخدم.
2. راجع الطلب والمرفقات ثم وافق أو ارفض وفق سياسة البرنامج.
3. من صفحة التفاصيل راجع الأرباح والإحالات والشبكة والسحب والنسبة الخاصة.
4. عند التعديل اليدوي للأرباح دوّن سببًا واضحًا، وتحقق من اتجاه الإضافة أو الخصم والمبلغ قبل الحفظ.

لا تنشر المرفقات أو بيانات الصرف في صفحات عامة. تخصيص نسبة المستخدم لا يمنحه صلاحيات إدارة ووردبريس.

الحجز والاسترجاع ومنع التكرار

فترة الحجز تبقي العمولة غير متاحة حتى انقضائها، لتغطية دورة الاسترجاع حسب سياستك. راجع المهام المجدولة إذا ظل رصيد مؤهل محجوزًا بعد موعده.

إلغاء أو استرجاع الطلب يرتبط بعكس العمولة. قبل أي تصحيح يدوي افحص حالة الطلب وسجل العمولة وحركة المحفظة أو النقاط؛ لا تصرف التعويض يدويًا ثم تعيد تنفيذ نفس الاستحقاق بدون مراجعة.

عند الاشتباه في إحالة مكررة، سجّل رقم الطلب ورقم الإحالة وحالة كل سجل والتوقيت، واختبر سيناريو الاسترجاع الجزئي الذي يستخدمه متجرك على نسخة تجريبية.

المحفظة والنقاط وطلبات السحب

1. اختَر طريقة المكافأة العامة أو طريقة المجموعة/المحيل، وتأكد من وجود TeraWallet عند الصرف للمحفظة.
2. اضبط الحد الأدنى للسحب والطريقة المتاحة: نموذج طلب أو التواصل عبر واتساب في الوضع المبسط.
3. يحفظ المستخدم بيانات الصرف البنكي أو محفظة الموبايل أو الطريقة الأخرى ثم يطلب السحب.
4. راجع الطلب في الإدارة، وتأكد من المستفيد والمبلغ ثم نفّذ التحويل الفعلي بالطريقة المتفق عليها وسجّل الحالة والملاحظات.
5. رفض الطلب يعيد الرصيد وفق مسار الرفض؛ لا تضفه مرة ثانية يدويًا. راجع السجل بعد الإجراء.

إدارة حالة طلب السحب ليست دليلًا أن حوالة بنكية تمت تلقائيًا. تحويل النقاط إلى رصيد يتطلب TeraWallet وإعداد التحويل، ويجب اختباره بمبلغ صغير قبل تعميمه.

المستويات والأوسمة وشبكة الإحالة

من إعدادات المستويات حدّد الأسماء والحدود والألوان والنسب الاختيارية. الأوسمة تُحسب من بيانات المستخدم، والمعالم قد تصرف مكافأة مرة واحدة عند بلوغ الهدف.

شبكة الإحالة تدعم حتى ثلاثة مستويات، مع نسب للمستوى الثاني والثالث. راجع أثر الشبكة على إجمالي تكلفة الطلب، وأنشئ سلسلة حسابات اختبار واضحة، ثم افحص المستفيد من كل سجل بدل الاكتفاء بالمجموع.

لوحة الصدارة تعرض ترتيب المستخدمين وبيانات مستوياتهم. راجع ما تسمح بعرضه علنًا، واختبر مستخدمًا بدون إحالات حتى تظهر حالة الفراغ بشكل مفهوم.

الحملات والمواد التسويقية والتحليلات

1. أنشئ حملة وحدّد الكود والنوع: نسبة أو مبلغ ثابت أو مضاعف.
2. اضبط البداية والنهاية وحد الاستخدام ونطاق التطبيق: كود محدد أو الطلبات المُحالة.
3. اختبر قبل البداية وأثناء المدة وبعد الانتهاء، مع مراجعة تداخل النسبة الخاصة والحملة.

المواد التسويقية تشمل بانرات ونصوص مشاركة. استخدم {link} للرابط و{code} للكود في النصوص، ثم عاين بحساب مستخدم وتحقق من القيم الفعلية.

من التحليلات اختر الفترة قبل مقارنة النقرات والزيارات والتسجيلات والطلبات ومعدل التحويل ومصادر الزيارات. تصدير CSV مفيد للمراجعة، لكن تأخر المهام أو اختلاف الفترة قد يفسّر اختلافًا مع سجل الطلبات.

صفحات العميل والشورت كود

لوحة العميل تشمل رابط الدعوة والإحصائيات والأوسمة والشبكة والسحب والمواد التسويقية حسب الإعدادات. اختر التصميم والألوان ثم جرّب الهاتف والوضع الليلي. استبعد صفحات الحساب والمكافآت الخاصة بالمستخدم من الكاش العام.

الصيانة والدعم ونقل الإعدادات

من مركز الدعم انسخ تقرير النظام عند فتح مشكلة، وراجع الإصدارات والاعتماديات والمهام المجدولة. استخدم تصدير إعدادات JSON قبل نقلها لموقع آخر، وراجع القيم الخاصة بالموقع بعد الاستيراد.

• تحديث الروابط يفيد إذا عاد تبويب الحساب بصفحة غير موجودة.
• إعادة جدولة المهام تفيد بعد التحقق من تعطل مهام الاعتماد أو الصيانة.
• إصلاح الجداول أو استعادة الافتراضي إجراءات تحتاج نسخة احتياطية ومعرفة أثرها؛ لا تجعلها أول خطوة لكل مشكلة.
• دخول الدعم المؤقت يمنح صلاحية ومدة محددتين. أنشئه لشخص موثوق فقط، وألغِه بعد العمل ولا تنشر الرابط علنًا.
• إلغاء التفعيل يحرر موقع الترخيص على الخادم؛ مسح البيانات محليًا ليس بالضرورة نفس عملية تحرير الموقع.

حل المشاكل واختبار ما بعد التحديث

التفعيل مرفوض: تأكد أن الكود يخص نفس الإضافة، وأنه لم ينتهِ أو يتجاوز عدد المواقع، وأن عنوان الموقع هو الدومين المسجّل. بعد نقل الدومين راجع التفعيل، ولا تنسخ بيانات ترخيص مشفّرة من قاعدة موقع آخر.

التحديث لا يظهر: افتح شاشة الترخيص وأعد الفحص، ثم صفحة تحديثات ووردبريس. راجع اتصال الخادم بمركز MirrorORG وتوقيت الخادم وسجل الخطأ، وأرسل للدعم اسم الإضافة ورقم النسخة ورسالة الخطأ بدون كود التفعيل أو كلمات المرور.

اختبار النسخة: إحالة بحسابين، خصم، اعتماد عمولة، مكافأة مشتري، استرجاع، ثم طلب سحب تجريبي ورفضه للتحقق من عودة الرصيد مرة واحدة.

التحديث والترقية من النسخ القديمة

1. راجع رقم الإصدار وسجل التغييرات في أسفل الدليل قبل التحديث.
2. خذ نسخة احتياطية من قاعدة البيانات والملفات، ودوّن إعداداتك المهمة. نفّذ التحديث من صفحة إضافات ووردبريس بعد التأكد من صلاحية الترخيص.
3. امسح كاش الصفحات والملفات الثابتة عند الحاجة، ثم نفّذ سيناريو الاختبار الموجود بهذا الدليل.
4. إذا ظهر تعارض، أعد الاختبار على النسخة التجريبية. الرجوع لحزمة أقدم وحده لا يرجع تغييرات قاعدة البيانات؛ استخدم نسخة احتياطية متوافقة عند اللزوم.

الدليل معنون برقم النسخة التي تمت مراجعتها. يُعرض سجل الإصدارات من الـHub مباشرة، وتُحفظ الأدلة القديمة عند نشر نسخة جديدة. الإعدادات والسلوك الجديد يحتاجان مراجعة تحريرية ضمن الإصدار؛ تغيير رقم النسخة وحده لا يكفي.

عند الترقية من 1.x احتفظ بنسخة قاعدة البيانات أولًا. أداة ترقية الأكواد القديمة تستبدل الأكواد القابلة للتخمين بأخرى عشوائية وقد توقف روابط الدعوة القديمة؛ خطط لإبلاغ المستخدمين قبل استخدامها. السجل التفصيلي يبدأ من الترقية بينما تبقى الأرقام الإجمالية القديمة وفق مسار الترقية.

سجل الإصدارات

هذه التغييرات مأخوذة مباشرة من الإصدارات المنشورة على الـHub.