توثيق NIBRA Contest Manager

📖 مقدمة

ما هي إضافة NIBRA Contest Manager؟

إضافة WordPress متكاملة لإدارة المسابقات كاملةً — من الإعلان والتسجيل إلى التحكيم والنتائج. مصمّمة للسوق الجزائري مع دعم كامل للغة العربية RTL، والولايات الجزائرية، وخيارات الدفع المحلية.

🏆

إدارة كاملة للمسابقات

من الإنشاء إلى نشر النتائج — كل شيء في مكان واحد مع واجهة عربية احترافية.

👩‍⚖️

نظام تحكيم متقدم

معايير مرجّحة، لجان محكّمين، درجات تفصيلية ونتائج معتمدة تلقائياً.

📌

تكامل WordPress كامل

أكواد مختصرة، ودجت، REST API، وطباعة احترافية — كل ما تحتاجه جاهز.

🇩🇿

مصمّم للسوق الجزائري

دعم 58 ولاية، DZD، RTL كامل، وخيارات دفع CIB / داهبية / Chargily.

⚙️ المتطلبات

متطلبات التشغيل

تأكد من توافر هذه المتطلبات قبل تثبيت الإضافة.

المتطلب	الحد الأدنى	الموصى به
WordPress	5.8	6.4+
PHP	7.4	8.1+
MySQL	5.7	8.0+
ذاكرة PHP	64MB	256MB
اتصال إنترنت	للتحقق من الترخيص	مستمر للإشعارات
إضافات PHP	curl، json، mbstring، openssl

ℹ️

الإضافة لا تحتاج إلى Composer — تستخدم Autoloader مخصصاً خفيف الوزن.

📦 التثبيت

التحميل والتثبيت

ثلاث طرق لتثبيت الإضافة على موقعك.

الطريقة الأولى — رفع الملف (موصى بها)

1

احصل على ملف الإضافة

قم بتحميل ملف nibra-contest-manager.zip من بوابة العملاء على productes.nibra.cloud بعد إتمام عملية الشراء.

2

افتح لوحة إدارة WordPress

اذهب إلى الإضافات ← إضافة جديدة ← رفع إضافة من شريط التنقل العلوي.

3

ارفع ملف ZIP

انقر على "اختيار ملف" واختر nibra-contest-manager.zip ثم انقر "تثبيت الآن".

4

فعّل الإضافة

بعد اكتمال التثبيت انقر "تفعيل الإضافة". سيتم إنشاء جداول قاعدة البيانات تلقائياً (17 جدول).

5

تحقق من نجاح التثبيت

ستجد قائمة "المسابقات" في شريط التنقل الإداري. انقر عليها للوصول إلى لوحة تحكم NIBRA.

الطريقة الثانية — FTP / File Manager

أوامر FTP
# 1. فك ضغط الملف محلياً
unzip nibra-contest-manager.zip

# 2. ارفع المجلد إلى:
/wp-content/plugins/nibra-contest-manager/

# 3. فعّل من لوحة WordPress:
الإضافات ← NIBRA Contest Manager ← تفعيل
        

✅

بعد التفعيل سيتم إنشاء 17 جدول تلقائياً في قاعدة البيانات بالبادئة wp_ncm_

التحقق من التثبيت

ما يتم إنشاؤه	التفاصيل
17 جدول في DB	wp_ncm_competitions, wp_ncm_submissions, ... إلخ
3 أدوار مستخدم	ncm_organizer, ncm_judge, ncm_participant
مجلد الرفع	wp-content/uploads/ncm/
خيارات WordPress	ncm_settings, ncm_db_version
مهام Cron	ncm_competition_status_check (كل ساعة)

🔑 الترخيص

تفعيل الترخيص

ستعمل الإضافة بالنسخة المجانية تلقائياً. لتفعيل خطة Pro أو Enterprise اتبع هذه الخطوات.

1

اشترِ الخطة المناسبة

قم بزيارة productes.nibra.cloud واختر الخطة المناسبة (Pro أو Enterprise). ستصلك رسالة بريد إلكتروني تحتوي على مفتاح الترخيص بالشكل: XXXX-XXXX-XXXX-XXXX

2

افتح صفحة الترخيص

من القائمة الجانبية اذهب إلى المسابقات ← الترخيص 🔑

3

أدخل المفتاح وفعّل

الصق مفتاح الترخيص في الحقل ثم انقر "تفعيل ✓". ستتصل الإضافة تلقائياً بسيرفر productes.nibra.cloud للتحقق.

4

تأكيد التفعيل

ستظهر رسالة ✅ "تم تفعيل الترخيص بنجاح!" وتتحول الصفحة لتعرض خطتك الحالية، تاريخ الانتهاء، والإضافات المفعّلة.

⚠️

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

إلغاء التفعيل

لإلغاء تفعيل الترخيص (مثلاً لنقله إلى موقع آخر):

اذهب إلى المسابقات ← الترخيص
انقر على "إلغاء التفعيل" تحت بطاقة حالة الترخيص الحالية
سيتم إرسال طلب deactivate لسيرفر NIBRA ومسح المفتاح من قاعدة البيانات

🏠 لوحة التحكم

لوحة التحكم الرئيسية

الصفحة الأولى عند فتح الإضافة. تعرض نظرة سريعة على كل نشاطات الإضافة.

العنصر	الوصف
🏆 بطاقة المسابقات	إجمالي عدد المسابقات في النظام
✅ مفتوحة	عدد المسابقات المفتوحة حالياً للتسجيل
📝 المشاركات	إجمالي الطلبات الواردة
⏳ معلّقة	المشاركات التي لم تُراجَع بعد
🥇 مؤهّلة	المشاركات التي تم قبولها للتحكيم
📋 آخر المشاركات	جدول أحدث 8 مشاركات مع بيانات المتسابق والحالة
🏆 المسابقات الأخيرة	قائمة آخر 6 مسابقات مع حالتها وتاريخ الانتهاء
📊 توزيع الحالات	رسم بياني بار chart يوضح توزيع حالات المشاركات

💡

يمكن تغيير لغة الواجهة في أي وقت من أزرار AR / FR / EN في أسفل القائمة الجانبية. التغيير يحفظ تلقائياً في بيانات المستخدم.

🏆 المسابقات

إنشاء وإدارة المسابقات

قلب الإضافة — يمر إنشاء كل مسابقة بمعالج 3 خطوات (Wizard).

الخطوة 1 — المعلومات الأساسية

الحقل	الوصف	مطلوب
عنوان المسابقة	الاسم الظاهر للمسابقة	✅
الوصف	تفاصيل المسابقة الكاملة	✅
الفئة	تصنيف المسابقة (أدب، فنون، تقني...)	—
صورة المسابقة	صورة الغلاف — رفع من مكتبة WP أو URL مباشر	—
اسم المنظّم	الجهة أو الشخص المنظّم	✅
بريد المنظّم	للتواصل والإشعارات	—
هاتف المنظّم	رقم الاتصال	—
شعار المنظّم	يظهر في بطاقة الطباعة وصفحة المسابقة	—
معلومات الجائزة	وصف الجوائز والمكافآت	—
بداية التسجيل	تاريخ ووقت فتح باب المشاركة	✅
نهاية التسجيل	تاريخ ووقت إغلاق باب المشاركة	✅
بداية التحكيم	متى تبدأ مرحلة التحكيم	—
نهاية التحكيم	الموعد النهائي للتحكيم	—

حالات المسابقة

الحالة	المعنى	الانتقال
`draft`	مسودة — غير مرئية للزوار	يدوي → published
`published`	منشورة لكن التسجيل لم يبدأ	تلقائي → open
`open`	مفتوحة — التسجيل نشط	تلقائي → closed
`closed`	انتهى موعد التسجيل	تلقائي → judging
`judging`	مرحلة التحكيم جارية	بعد اعتماد النتائج
`archived`	مؤرشفة — للأرشيف فقط	يدوي

🔄

الانتقالات التلقائية تتم عبر مهمة Cron تُنفَّذ كل ساعة. لا تحتاج إلى أي إجراء يدوي لتحديث الحالة.

الخطوة 2 — المحكّمون والمعايير

اختر المحكّمين من القائمة (يجب إضافتهم أولاً في صفحة المحكّمين)
حدّد رئيس لجنة التحكيم باختياره من القائمة
أضف معايير التقييم: الاسم، النقاط القصوى، الوزن (weight)
المعايير المرجّحة تسمح بتقييم بعض الجوانب أكثر من غيرها

الخطوة 3 — النموذج والأكواد المختصرة

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

📝 المشاركات

إدارة المشاركات

استعراض وإدارة جميع طلبات المشاركة في كل المسابقات.

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

حالات المشاركة

⏳ معلّق (pending)

الحالة الافتراضية عند الإرسال. تنتظر المراجعة.

👁️ قيد المراجعة (reviewing)

يتم مراجعة المشاركة حالياً من قِبَل الفريق.

✅ مقبول (qualified)

مؤهل للمرحلة التالية أو للتحكيم.

❌ مرفوض (rejected)

تم رفض الطلب مع إمكانية إرسال إشعار بالسبب.

👩‍⚖️ المحكّمون

إدارة المحكّمين

أنشئ قاعدة بيانات محكّمين مستقلة وارتبطهم بأي عدد من المسابقات.

بيانات المحكّم	الوصف
الاسم الكامل	الاسم الرسمي للمحكّم (يظهر في التقارير)
البريد الإلكتروني	للتواصل وإرسال الإشعارات
رقم الهاتف	رقم التواصل المباشر
المؤسسة / الجهة	الجهة التي ينتمي إليها المحكّم
التخصص	مجال خبرة المحكّم
السيرة الذاتية	نبذة مختصرة عن المحكّم
المسابقات	تحديد المسابقات التي سيحكّم عليها (checkbox متعددة)
رئيس اللجنة	تعيين كرئيس لجنة التحكيم في مسابقة معينة

💡

يمكن إضافة محكّم سريع مباشرةً من الخطوة 2 لإنشاء مسابقة دون الخروج من المعالج.

🎯 التحكيم

نظام التحكيم والتقييم

نظام تحكيم متكامل بمعايير مرجّحة وسير عمل اعتماد رسمي.

1

اختر المسابقة

من صفحة التحكيم اختر المسابقة من القائمة المنسدلة. ستظهر جميع المشاركات المؤهلة والمحكّمون المعيّنون.

2

أدخل الدرجات

لكل مشاركة ولكل محكّم أدخل الدرجة لكل معيار. الدرجة النهائية = مجموع (الدرجة × الوزن / النقاط القصوى).

3

احسب النتائج

انقر "حساب النتائج" لتوليد الترتيب النهائي بناءً على متوسط درجات جميع المحكّمين مع تطبيق الأوزان.

4

اعتمد النتائج

بعد المراجعة انقر "اعتماد ونشر النتائج". هذا الإجراء نهائي ولا يمكن التراجع عنه. يصبح تقرير النتائج متاحاً للطباعة.

⚠️

بعد اعتماد النتائج تصبح صفحة التحكيم للقراءة فقط. تأكد من صحة جميع الدرجات قبل الاعتماد.

🥇 النتائج

إدارة النتائج

عرض النتائج المعتمدة ونشرها على الواجهة العامة.

الميزة	الوصف
عرض مرتب	النتائج مرتبة حسب الترتيب النهائي (1, 2, 3...)
تمييز الفائزين	إمكانية تحديد الفائزين الرسميين وتمييزهم بشارة
نشر / إخفاء	التحكم في ظهور النتائج على الواجهة العامة
تقرير الطباعة	تقرير PDF احترافي بجميع النتائج ومصفوفة الدرجات
Shortcode	عرض النتائج في أي صفحة عبر `[ncm_results id="X"]`

📊 التقارير

التقارير والإحصائيات

تقارير تفصيلية لتتبع أداء المسابقات والمشاركات.

📍

توزيع حسب الولاية

إحصائيات المشاركات مقسّمة حسب الولايات الجزائرية الـ 58.

📈

أداء المحكّمين

تقرير بمدى اكتمال التقييمات لكل محكّم في كل مسابقة.

🏷️

توزيع حسب الفئة

إحصائيات المسابقات والمشاركات مقسّمة حسب الفئات.

🖨️

تقارير قابلة للطباعة

جميع التقارير يمكن طباعتها مباشرةً بتصميم احترافي.

🔧 منشئ النماذج

منشئ النماذج المرئي

أنشئ نماذج تسجيل مخصصة لكل مسابقة بالسحب والإفلات.

أنواع الحقول المتاحة

text

حقل نصي قصير

textarea

حقل نصي طويل متعدد الأسطر

select

قائمة منسدلة بخيارات

radio

اختيار واحد من عدة خيارات

checkbox

اختيار متعدد من خيارات

file

رفع ملف (PDF، صورة...)

number

حقل رقمي

date

منتقي التاريخ

email

بريد إلكتروني مع تحقق

url

رابط URL مع تحقق

📌

الحقول الإجبارية دائماً: الاسم الكامل، البريد الإلكتروني، الهاتف، الولاية — هذه تُضاف تلقائياً لكل نموذج.

⚙️ الإعدادات

إعدادات الإضافة

تخصيص سلوك الإضافة وإعدادات البريد الإلكتروني والملفات.

الإعداد	القيم الممكنة	الوصف
اللغة الافتراضية	AR / FR / EN	اللغة الافتراضية لواجهة الإدارة
اسم المرسل	نص حر	الاسم الذي يظهر في رسائل البريد
بريد الإرسال	بريد صالح	عنوان البريد المرسل منه
أنواع الملفات	pdf,jpg,png...	امتدادات الملفات المسموح برفعها
حجم الملف الأقصى	MB	الحد الأقصى لحجم الملف الواحد
الإشعارات	تفعيل/تعطيل	إرسال إشعارات تلقائية عند تغيير الحالة

📌 الأكواد المختصرة

الأكواد المختصرة (Shortcodes)

أضف أي عنصر من الواجهة العامة لأي صفحة WordPress بسطر واحد.

[ncm_competitions]

عرض قائمة المسابقات بتخطيط شبكي أو قائمة مع صور وحالات وعداد تنازلي.

status="open" layout="grid" columns="3" per_page="9" category="" show_filter="true" lang="ar"

[ncm_competitions status="open" layout="grid" columns="3" show_filter="true"]

[ncm_competition_form id="X"]

نموذج التسجيل في مسابقة محددة. يعرض الحقول المخصصة وزر الإرسال مع التحقق من صحة البيانات.

id="X" ✅ مطلوب

[ncm_competition_form id="5"]

[ncm_form id="X"]

اختصار مرادف لـ [ncm_competition_form] — نفس الوظيفة بكود أقصر.

id="X" ✅ مطلوب

[ncm_results id="X"]

عرض نتائج المسابقة المعتمدة — قائمة الفائزين بالترتيب مع درجاتهم النهائية.

id="X" ✅ مطلوب

[ncm_results id="5"]

[ncm_submission_status id="X"]

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

id="X" ✅ مطلوب

[ncm_submission_status id="5"]

💡

استبدل X برقم ID المسابقة. تجده في قائمة المسابقات أو في عنوان صفحة التعديل.

🧩 الودجت

ودجت المسابقات

أضف المسابقات إلى أي منطقة ودجت (Sidebar، Footer...) في قالبك.

طريقة الإضافة

اذهب إلى المظهر ← الودجات (Appearance → Widgets)
ابحث عن "🏆 NIBRA — المسابقات"
اسحبه إلى منطقة الودجت المطلوبة
اضبط الإعدادات وانقر حفظ

إعداد الودجت	القيم	الوصف
العنوان	نص حر	عنوان الودجت الظاهر للزوار
الحالة	open / judging / closed / الكل	فلترة المسابقات المعروضة
عدد المسابقات	1 — 50	الحد الأقصى للمسابقات المعروضة
نوع العرض	grid / list	شبكة بطاقات أو قائمة بسيطة
عدد الأعمدة	1 — 4	عدد الأعمدة في وضع الشبكة

🖨️ الطباعة

قوالب الطباعة

قوالب طباعة احترافية مصمّمة خصيصاً للمسابقات والنتائج.

🪪

بطاقة المسابقة

تحتوي على: ترويسة بشعار المنظّم، معلومات المسابقة الكاملة، جدول المحكّمين ومناصبهم، معايير التقييم والأوزان، كتلة التوقيع الرسمية.

الرابط:
admin.php?ncm_print=card&id=X

📋

تقرير النتائج

A4 landscape — يحتوي على: جدول النتائج النهائي المرتب، مصفوفة درجات التحكيم لكل محكّم، منصة التتويج للفائزين، كتلة توقيع رسمية.

الرابط:
admin.php?ncm_print=results&id=X

🌐

كلا القالبين يتكيفان تلقائياً مع اللغة: العربية RTL أو الفرنسية/الإنجليزية LTR حسب إعداد المستخدم.

🔌 REST API

REST API

نقاط نهاية REST API لدمج الإضافة مع تطبيقات خارجية أو Mobile Apps.

Base URL
https://yoursite.com/wp-json/nibracontestmanager/v1/competitions
        

GET /nibracontestmanager/v1/competitions قائمة المسابقات مع فلترة حسب status, per_page, page, search

GET /nibracontestmanager/v1/competitions/{id} تفاصيل مسابقة واحدة بكامل بياناتها

GET /nibracontestmanager/v1/competitions/{id}/submissions قائمة مشاركات مسابقة محددة

GET /nibracontestmanager/v1/submissions/{id} تفاصيل مشاركة واحدة

DEL /nibracontestmanager/v1/submissions/{id} حذف مشاركة (يتطلب صلاحية manage_options)

GET /nibracontestmanager/v1/competitions/{id}/results النتائج المعتمدة لمسابقة محددة

مثال طلب

cURL

curl -X GET \
  "https://yoursite.com/wp-json/nibracontestmanager/v1/competitions?status=open&per_page=10" \
  -H "Accept: application/json"
        

🔐

نقاط نهاية القراءة (GET) متاحة للعموم. نقاط الكتابة والحذف تتطلب مصادقة WordPress (Application Passwords أو JWT).

🗃️ قاعدة البيانات

مخطط قاعدة البيانات

17 جدول بالبادئة wp_ncm_ يتم إنشاؤها تلقائياً وتُحدَّث باستخدام dbDelta.

wp_ncm_competitions

المسابقات: العنوان، الوصف، المنظّم، التواريخ، الحالة، الصورة، الجوائز

wp_ncm_forms

نماذج التسجيل المرتبطة بكل مسابقة

wp_ncm_form_fields

حقول النموذج: النوع، التسمية، مطلوب، الترتيب، الإعدادات

wp_ncm_submissions

طلبات المشاركة: بيانات المتسابق، الرمز المرجعي، الحالة

wp_ncm_submission_values

قيم الحقول المخصصة لكل مشاركة

wp_ncm_submission_files

الملفات المرفوعة مع طلبات المشاركة

wp_ncm_committees

لجان التحكيم العامة

wp_ncm_judges

المحكّمون: الاسم، البريد، الهاتف، المؤسسة، التخصص

wp_ncm_competition_judges

ربط المحكّمين بالمسابقات (pivot) مع تحديد رئيس اللجنة

wp_ncm_scoring_criteria

معايير التقييم: الاسم، النقاط القصوى، الوزن، الترتيب

wp_ncm_scores

درجات التحكيم لكل مشاركة حسب المحكّم والمعيار

wp_ncm_results

النتائج النهائية: الترتيب، الفائز، الدرجة، معتمد/غير معتمد

wp_ncm_appeals

الطعون والاعتراضات على النتائج

wp_ncm_payments

سجلات المدفوعات (رسوم المشاركة — خطة Pro)

wp_ncm_coupons

أكواد الخصم على رسوم المشاركة

wp_ncm_notifications

قائمة انتظار الإشعارات البريدية

wp_ncm_logs

سجل العمليات الكامل (Audit Log) لكل إجراء في النظام

⏰ المهام الآلية

المهام المجدولة (Cron)

مهام تعمل تلقائياً في الخلفية دون أي تدخل يدوي.

المهمة	التكرار	الوظيفة
`ncm_competition_status_check`	كل ساعة	تحديث حالات المسابقات تلقائياً بناءً على التواريخ (published→open→closed→judging)
`ncm_send_pending_notifications`	مرتين يومياً	إرسال الإشعارات البريدية المعلّقة في قائمة الانتظار (حتى 50 رسالة في الجولة)

الإشعارات التلقائية

تأكيد الاستلام: يُرسَل للمتسابق فور تقديم المشاركة مع الرمز المرجعي
تغيير الحالة: يُرسَل عند تغيير حالة المشاركة (قبول / رفض)
تذكير الانتهاء: يُرسَل للمتسابقين قبل انتهاء موعد التسجيل

💎 الخطط والأسعار

خطط الاشتراك

اختر الخطة المناسبة لحجم مسابقاتك واحتياجاتك.

🆓

مجاني

0 DA / سنة

✓ مسابقات غير محدودة
✓ مشاركات غير محدودة
✓ منشئ النماذج
✓ تقارير أساسية
✓ ودجت WordPress
✓ REST API
✗ دفع CIB / داهبية
✗ تصدير PDF
✗ رسائل SMS

⭐ الأكثر طلباً

🚀

Pro

4,900 DA / سنة

✓ كل ميزات المجاني
✓ دفع CIB / داهبية / Chargily
✓ تصدير PDF
✓ رسائل SMS الجزائر
✓ دعم مميز
✓ Telegram Bot
✓ تقارير متقدمة
✗ White Label
✗ مواقع غير محدودة

🏢

Enterprise

14,900 DA / سنة

✓ كل ميزات Pro
✓ White Label
✓ مواقع غير محدودة
✓ Webhooks
✓ دعم VIP مباشر
✓ تخصيص مخصص
✓ تدريب الفريق
✓ SLA مضمون
✓ نسخ احتياطية آلية

🎁

للمؤسسات والجامعات الحكومية: اتصل بنا للحصول على أسعار خاصة وشروط دفع مرنة.

🛒 المتجر

إضافات المتجر

وسّع قدرات الإضافة بإضافات متخصصة من متجر NIBRA.

📄

PDF Export Pro

تصدير المشاركات، النتائج، والتقارير بصيغة PDF احترافية مع شعار مؤسستك.

💳

Payment DZ

قبول رسوم المشاركة عبر CIB، داهبية، BaridiMob وبطاقات Chargily.

📱

SMS Algeria

إشعارات SMS مباشرة للمتسابقين عبر مزودي SMS الجزائريين.

🤖

Telegram Bot

إشعارات Telegram فورية للمديرين والمحكّمين عند وصول مشاركات جديدة.

🛒

اطّلع على جميع الإضافات المتاحة من صفحة المسابقات ← المتجر في لوحة الإدارة.