Referral Rewards for WooCommerce & TeraWallet

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

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

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

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

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

خريطة الإعدادات (٨ تبويبات)

منذ 4.5.0 كل إعداد في مكان واحد، وكل كارت يعرض الحقول التي تنطبق على اختيارك الحالي فقط: تغيير «نوع العمولة» مثلًا يُظهر خانة النسبة أو المبلغ لا كليهما، وإطفاء خاصية يُخفي كروتها. الحقول المخفية تحتفظ بقيمها.

ملاحظة ترقية: حقل «مدة تعليق عمولة المبيعات» القديم لم يعد في الواجهة؛ قيمته تبقى الافتراضي للعمولة الخاصة بطلبات المبيعات إلى أن تحدد مدة لمجموعة السيلز في كارت «مدة الريفند».

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

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

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

العمولات والمجموعات الثلاث وسياسة كل مجموعة

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

• نسبة المحيل الخاصة: من تفاصيل المحيل اختر توريث أو نسبة أو مبلغ ثابت أو بدون عمولة. النسبة الفردية تتقدم على مجموعة المستخدم ومستواه والنسبة العامة.
• المجموعات الثلاث (منذ 4.4.0): سيلز، بلوجر، عملاء. لكل مستوى نسبته وطريقة تسليمه (محفظة أو نقاط) عند تفعيل «نسبة لكل مجموعة» و«كل مجموعة لها طريقتها». يُحدَّد المستوى بهذا الترتيب: التحديد اليدوي على صفحة المحيل، ثم أدوار السيلز، ثم أدوار البلوجر، ثم قائمة السيلز المختارين، وإلا فهو عميل. أدوار السيلز والبلوجر تختارها من تبويب «المجموعات» ← «من ينتمي لأي مجموعة».
• دور «بلوجر» (منذ 4.6.0): الإضافة تنشئ دور ووردبريس اسمه «بلوجر» (rr_blogger) بنفس صلاحيات العميل فقط، ومحسوب دايمًا ضمن مجموعة البلوجر (يظهر مُعلَّمًا ومقفولًا في قائمة أدوار البلوجر)، زي دور «سيلز». لتحويل مستخدم لبلوجر: من «المستخدمين» في ووردبريس غيّر دوره إلى «بلوجر»، أو اختر المجموعة يدويًا من صفحة المحيل. نسبة عمولة البلوجر نفسه تُضبط من «نسبة كل مجموعة» بعد تفعيل «نسبة لكل مجموعة».
• العميل حسب نوع المُحيل (منذ 4.6.0): كارت «العميل حسب نوع المُحيل» في تبويب «المجموعات» يحدد لكل مجموعة (سيلز/بلوجر/عملاء) خصم الشراء ومكافأة المشتري للعميل اللي اشترى بكود محيل من المجموعة دي. المجموعة هنا هي مجموعة صاحب الكود، مش المشتري. ومنذ 4.6.1 تقدر تحدد خصم لصاحب كود بعينه من صفحة المحيل ← «خصم المشترين بكوده»؛ ترتيب الخصم: خصم صاحب الكود ← خصم مجموعته ← الخصم العام (الخانة الفاضية = مجموعته، و0 = بدون خصم). الخانة الفاضية أو «حسب الإعداد العام» = قيم تبويب «العمولات». ترتيب مكافأة المشتري: نسبة خاصة محفوظة على حساب المشتري نفسه ← إعداد مجموعة المحيل ← الإعداد العام؛ السقف والحد الأدنى للطلب وطريقة التسليم تبقى عامة. الخصم يظهر للمحيل في لوحته وفي المواد التسويقية بقيمة مجموعته، وفي صفحة تفاصيل المحيل للأدمن.
• سياسة كل مجموعة: في تبويب «المجموعات» يحدد لكل مجموعة: (١) أساس العمولة — قيمة الطلب شاملة الشحن، أو بدون الشحن، أو قيمة يدوية تُكتب على الطلب؛ (٢) خصم الشحن عند الإلغاء. أما مدة الريفند لكل مجموعة ففي تبويب «العمولات» ← «مدة الريفند». مع «قيمة يدوية» افتح الطلب في ووكومرس واكتب المبلغ في صندوق «مكافآت الإحالة»؛ إن تُرك فارغًا تُحسب العمولة على الطلب بدون الشحن.
• الرُتب (كانت «المستويات»): يمكن أن تضيف نسبة أو تبقى للعرض؛ راجع تأثيرها مع النسبة الفردية.
• المنتج والتصنيف: راجع العمولة الخاصة أو المبلغ لكل قطعة والاستثناء. في هذا الوضع يُجمع المنتجات سطرًا سطرًا، ويُضاف الشحن بنسبة المحيل الافتراضية فقط إذا كان أساس مستواه «شاملة الشحن».
• الحملات والشبكة: قد تضيف تأثيرًا آخر على الحساب؛ عمولات الشبكة تُحسب على أساس المحيل المباشر نفسه. اختبر القواعد مجتمعة قبل إعلان نسبة موحدة للجميع.

مثال للعميل: الخصم العام 10%، خصم «بلوجر» 15% ومكافأة مشتري 5% لعملاء البلوجر، وخانات السيلز فاضية. عميل يشتري بكود بلوجر بـ1000 ياخد خصم 15% ومكافأة 50؛ عميل يشتري بكود سيلز ياخد الخصم العام 10% ومكافأة المشتري العامة.

مثال: طلب 1000 بضاعة + 50 شحن، مستوى السيلز بنسبة 10%. أساس «شاملة الشحن» يعطي 105، «بدون الشحن» يعطي 100، و«قيمة يدوية» 800 مكتوبة على الطلب تعطي 80 — قبل أي سقف أو حملة.

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

مكافأة المشتري الذي استخدم إحالة منفصلة عن خصمه وعن عمولة المحيل. حدّد نوع المكافأة وقيمتها وسقفها وحد الطلب الأدنى وفترة حجزها. منذ 4.6.0 تقدر تخلي المكافأة (والخصم) مختلفين حسب نوع صاحب الكود — سيلز أو بلوجر أو عميل — من «المجموعات» ← «العميل حسب نوع المُحيل»؛ اختيار «بدون مكافأة» لمجموعة يوقف مكافأة المشتري لعملائها حتى لو المكافأة العامة مفعّلة. جرّب الطلب بحساب المشتري وتحقق من سجله هو أيضًا.

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

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

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

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

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

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

فلتر الكوبونات (منذ 4.6.1): في ووكومرس ← الكوبونات قائمة «كل الكوبونات / كوبونات عادية / إحالة: سيلز / إحالة: بلوجر / إحالة: ريفيرال» بعدد كل نوع، وعمود «الإحالة» بيعرض صاحب الكود ومجموعته و«الخصم الفعلي» اللي بيتطبق دلوقتي. الرقم في عمود «القيمة» بتاع ووكومرس هو المحفوظ في الكوبون، أما الخصم وقت الدفع فبيتحسب من صاحب الكود ومجموعته — استخدم أداة «تحديث نسب الخصم» لو عايز الرقمين يتطابقوا.

تسجيل الطلبات للعملاء (السيلز)

من تاب «تسجيل طلب» في لوحة المحيل، السيلز يسجّل طلب كامل لعميل ويوصل للإدارة (ويتحوّل لطلب ووكومرس لو التحويل مفعّل). شغّل الخاصية من الإعدادات ← تسجيل الطلبات ← نموذج تسجيل الطلب، وحدد المسموح لهم من «من يملك صلاحية التسجيل».

منتج ولا خدمة (منذ 4.7.0)

من كارت «الطلب والسعر» اختار «بيبيع إيه»: منتجات وخدمات (السيلز يختار في أول النموذج)، أو منتجات بس، أو خدمات بس.

• منتج: البحث بيعرض منتجات المتجر اللي بتتشحن بس. السيلز يختار المنتج ويحدد الكمية بأزرار − و+ (أو يكتب الرقم)، واختيار نفس المنتج تاني بيزوّد الكمية. بعدها يكتب عنوان الشحن: المحافظة من قايمة، والمدينة/المنطقة، والعنوان بالتفصيل — كلها إجبارية.
• خدمة: البحث بيعرض منتجات ووكومرس المعلَّمة «افتراضية» (Virtual). ولو الخدمة مش في المتجر، يكتب اسمها والسعر المتفق عليه في «خدمة مش موجودة في المتجر؟». الخدمة مافيهاش شحن، والعنوان خانة نصية عادية (إجبارية بس لو «العنوان إجباري» مفعّل).

كود الخصم

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

الشحن والإجمالي وتفاصيل الطلب

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

• من مناطق الشحن في ووكومرس (الافتراضي): نفس مناطق وطرق الشحن اللي في ووكومرس ← الإعدادات ← الشحن. لو المنطقة فيها أكتر من طريقة، السيلز يختار منها (الافتراضي الأرخص). «شحن مجاني» بحد أدنى أو بكوبون بيتحسب على طلب العميل ده.
• مبلغ ثابت: نفس المبلغ لأي طلب منتجات.
• بدون شحن.

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

اللي بيوصل للإدارة

في «طلبات المبيعات» ← «تفاصيل» جدول بالأسطر والكميات والكود والخصم والشحن والإجمالي. وطلب ووكومرس اللي بيتعمل منه فيه المنتجات بكمياتها، والكوبون مطبّق من مسار ووكومرس نفسه (فبيتحسب في عدد مرات الاستخدام)، وسطر شحن، وعنوان الفاتورة والشحن مفصّلين. الخدمة المكتوبة يدويًا بتتضاف كسطر رسوم باسمها وسعرها.

العمولة: عمولة طلب المبيعات بالنسبة بتتحسب على قيمة المنتجات بعد الخصم، من غير الشحن. مثال: ٣ × 200 + 100 = 700، وكوبون 10% يخصم 70، والشحن 60 → الإجمالي 690، والعمولة على 630.

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

مدة الريفند والاسترجاع وخصم الشحن

مدة الريفند تُبقي المكافأة «محجوزة» غير قابلة للسحب حتى انقضائها، لتغطية نافذة الاسترجاع. كل مدد الحجز في كارت واحد: تبويب «العمولات» ← «مدة الريفند» (الافتراضي، لكل مجموعة، مكافأة المشتري). منذ 4.4.0 يحمل كل سجل جديد موعد إفراجه الخاص (hold_until) ويُحدَّد بهذا الترتيب: مدة الطلب نفسه ← مدة مستوى المستفيد ← الإعداد القديم لكل مصدر (حجز العمولة العام، حجز طلبات المبيعات، حجز مكافأة المشتري). السجلات الأقدم من 4.4.0 تستمر على الحساب القديم.

• مدة لطلب بعينه: افتح الطلب في ووكومرس ← صندوق «مكافآت الإحالة» ← «مدة الريفند لهذا الطلب». فارغ = حسب المستوى، ٠ = فوري. تغييرها يعيد توقيت كل المكافآت المحجوزة على الطلب (المحيل والمشتري والشبكة) ولا يمس ما صُرف؛ يُسجَّل ذلك في ملاحظات الطلب. الصندوق يعرض أيضًا كل مكافآت الطلب وحالتها وتاريخ إتاحتها.
• مكافأة المشتري: تنتظر نفس نافذة الطلب، فالاسترجاع داخلها لا يكلّف المتجر شيئًا.
• الإفراج: تقوم به المهمة اليومية rr_release_held_commissions. راجع المهام المجدولة من مركز الدعم إذا بقي رصيد مؤهل محجوزًا بعد موعده.
• خصم الشحن عند الإلغاء: إذا فُعِّل للمجموعة (تبويب «المجموعات» ← «سياسة كل مجموعة»)، فإلغاء الطلب أو استرجاعه يخصم قيمة شحنه (مع ضريبته) من رصيد صاحب الإحالة مرة واحدة فقط، ويُسجَّل كتعديل يدوي بسبب واضح في السجل وملاحظة على الطلب. رصيد النقاط لا ينزل تحت الصفر؛ رصيد المحفظة قد يصبح سالبًا حسب TeraWallet.

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

المحفظة والنقاط وطلبات السحب وموعد الصرف

1. اختَر طريقة المكافأة الموحّدة أو طريقة كل مجموعة من تبويب «المجموعات» ← «طريقة المكافأة»، وتأكد من وجود TeraWallet عند الصرف للمحفظة.
2. اضبط الحد الأدنى للسحب والطريقة المتاحة: نموذج طلب أو التواصل عبر واتساب في الوضع المبسط.
3. موعد الصرف (منذ 4.4.0): من تبويب «عام» ← «السحب والصرف» اختر نظام السحب: فوري — كل طلب سحب يصلك لحظة إرساله (السلوك السابق)؛ طلب يُعالَج يوم محدد — يطلب المستخدم متى شاء وتتجمع الطلبات حتى يوم الدفعة فتتحول «قيد المعالجة» ويصلك بريد بملخصها؛ تلقائي — لا يطلب أحد: يوم الدفعة يتحول كل رصيد بلغ الحد الأدنى (نقاط أو محفظة) إلى طلب سحب جاهز، ويُتخطى من لم يحفظ طريقة صرف ويُذكر في الملخص. حدد «يوم الدفعة الشهرية» من ١ إلى ٢٨.
4. يحفظ المستخدم بيانات الصرف البنكي أو محفظة الموبايل أو الطريقة الأخرى ثم يطلب السحب. في الوضع التلقائي يختفي زر الطلب وتعرض اللوحة موعد الدفعة القادمة.
5. راجع الطلبات في «طلبات السحب»، ونفّذ التحويل الفعلي بالطريقة المتفق عليها ثم علّم كل طلب «مدفوع». زر «تشغيل دفعة الصرف الآن» يشغّل دورة الشهر فورًا دون انتظار يوم الدفعة.
6. رفض الطلب يعيد الرصيد وفق مسار الرفض؛ لا تضفه مرة ثانية يدويًا. راجع السجل بعد الإجراء.

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

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

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

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

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

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

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

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

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

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

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

الموبايل (منذ 4.6.1): تابات لوحة المحيل بتظهر شبكة من ٣ أعمدة بدل شريط بيتسحب للجنب، وخانات الإدخال حجم خطها 16 بكسل عشان آيفون مايعملش زوم على الصفحة، ونموذج «تسجيل طلب» بقى عمود واحد بزرار إرسال بعرض الشاشة ونتائج بحث المنتجات بحجم مناسب للصباع. جداول «سجل الأرباح» و«طلباتك الأخيرة» و«سجل طلبات السحب» بتتحول لكروت، وكل خانة مكتوب جنبها اسم العمود. لو الثيم بتاعك عامل تنسيق قوي للخانات وماتغيرش الشكل، امسح كاش الصفحات والـCSS.

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

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

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

روابط الدعم والتوثيق: لينك «التوثيق» في صف الإضافة بصفحة الإضافات بيفتح هذا الدليل على license.mirrororg.com، ولينك «الدعم الفني» (وكذلك «تواصل مع MirrorORG» في شاشة التفعيل) بيفتح صفحة التواصل على mirrororg.com. تقدر تغيّر رابط الدعم اللي بيظهر لفريقك من «متقدم ← الدعم الفني ← رابط الدعم».

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

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

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

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

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

التحديث التلقائي (منذ 4.6.1): زي Mirror Protection Suite بالظبط — أول ما MirrorORG تنشر نسخة، المركز بيبعت إشعار موقّع للموقع على /wp-json/mirrororg-referral/v1/push، والموقع بيسأل المركز ويثبّت النسخة لوحده من مسار تحديثات ووردبريس العادي ويرجّع الإضافة شغّالة. لو الإشعار ماوصلش (جدار حماية أو REST مقفول) فيه فحص كل ساعة. الإعدادات في «تفعيل مكافآت الإحالة» ← «التحديثات»: التثبيت التلقائي، استقبال الإشعار، الفحص كل ساعة، البنر — وكلها شغّالة افتراضيًا. مع إطفاء التثبيت التلقائي بيظهر بنر في لوحة التحكم بزرار «حدّث دلوقتي». الإشعار مش بيحمل أي كود: هو بس بيقول للموقع «اسأل المركز»، وبيتحقق بتوقيع من كود الترخيص وبيترفض لو أقدم من ٥ دقايق أو لإضافة تانية. وزرار «تحقق مرة أخرى» في صفحة تحديثات ووردبريس بقى بيفضّي كاش الإضافة كمان.

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

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

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

الترقية إلى 4.4.0: تُضاف تلقائيًا الأعمدة الجديدة لقاعدة البيانات (3.5.0). كل الإعدادات الجديدة تبدأ بالسلوك السابق: أساس «شاملة الشحن»، مدة ريفند فارغة (= الإعداد القديم)، خصم الشحن مطفأ، ونظام السحب «فوري». راجع كارت «سياسة كل مستوى» وأدوار البلوجر ونظام السحب بعد التحديث.

الترقية إلى 4.5.0: لا تغيير في القيم المخزنة؛ أعيد ترتيب شاشة الإعدادات فقط (٨ تبويبات مع إظهار تدريجي). راجع «خريطة الإعدادات» أعلاه لتعرف أين انتقل كل إعداد.

الترقية إلى 4.5.1: إصلاح أداء داخلي فقط — الإعدادات بقت بتتقرا من قاعدة البيانات باستعلام واحد بدل استعلام لكل إعداد (كانت حوالي ٩٠ استعلام على كل صفحة في الموقع). لا تغيير في القيم المخزنة ولا في الشاشات ولا في حساب العمولات؛ لا إجراء مطلوب. تمت مراجعة الدليل كاملًا لهذا الإصدار ولم يلزم تعديل غير هذه الفقرة وفقرة روابط الدعم.

الترقية إلى 4.6.0: تُرفع نسخة قاعدة البيانات إلى 3.6.0 ويُنشأ دور «بلوجر» تلقائيًا. الإعدادات الجديدة (خصم ومكافأة لكل مجموعة) تبدأ فاضية = الإعداد العام، فسلوك المتجر لا يتغير لحد ما تحددها. أُصلح كمان عرض دور «سيلز» كمُعلَّم ومقفول في قائمة أدوار البلوجر بالغلط. أداة «تحديث نسب الخصم» في الأدوات بقت تكتب لكل كوبون خصم مجموعة صاحبه. لمطوّري الفلاتر: rr_buyer_reward بقى يستقبل معامل رابع (رقم المحيل)، وفيه فلتر جديد rr_referral_discount.

الترقية إلى 4.6.1: لا تغيير في قاعدة البيانات ولا في القيم المحفوظة. التحديث التلقائي بيبدأ شغّال بعد الترقية؛ لو عايز تتحكم في التوقيت اطفي «ثبّت التحديثات تلقائيًا». الإصدار ده نفسه بيوصل بالطريقة القديمة (لحد ١٢ ساعة)، والإصدارات اللي بعده بتوصل في ثواني.

الترقية إلى 4.7.0: بيتضاف عمود meta لجدول طلبات المبيعات (نسخة قاعدة البيانات 3.7.0) لحفظ الكود والشحن والإجمالي والعنوان المفصّل. الطلبات القديمة بتفضل زي ما هي. الإعدادات الجديدة بتبدأ: منتجات وخدمات، الكمية مفعّلة، كود الخصم مفعّل، والشحن من مناطق ووكومرس — راجع كارت «الطلب والسعر» بعد التحديث لو متجرك بيبيع خدمات بس أو مالوش مناطق شحن.

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

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