إضافة Certificate لتوتارا

نظام إصدار وإدارة الشهادات الإلكترونية

نظرة عامة

إضافة Certificate هي إضافة موديول (Module) شاملة لنظام توتارا لتعلّم (Totara Learn) تهدف إلى إصدار وإدارة الشهادات الإلكترونية للمستخدمين عند إكمالهم للدورات التدريبية أو تحقيقهم لشروط معينة.

توفر هذه الإضافة نظامًا متكاملاً لإنشاء وتخصيص وإصدار الشهادات الإلكترونية بصيغة PDF مع دعم كامل للغة العربية والإنجليزية وغيرها من اللغات. تدعم الإضافة أنواع شهادات مختلفة، محرر مخصص، إدارة الخطوط، QR Codes للتحقق من الشهادات، وأدوات تخصيص متقدمة.

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

المميزات الرئيسية

📜 إصدار الشهادات الإلكترونية

إصدار شهادات PDF احترافية
إصدار تلقائي عند إكمال الدورة
إصدار بناءً على شروط معينة (الدرجات، الوقت، الأنشطة)
تخزين الشهادات الصادرة
معاينة الشهادات قبل الإصدار

🎨 أنواع الشهادات المتعددة

A4 Embedded - شهادة A4 مع خطوط مدمجة
A4 Non-Embedded - شهادة A4 بدون خطوط مدمجة
Letter Embedded - شهادة Letter مع خطوط مدمجة
Letter Non-Embedded - شهادة Letter بدون خطوط مدمجة
Custom Editor - محرر مخصص للشهادات

✏️ المحرر المخصص (Custom Editor)

واجهة تحرير مرئية للشهادات
سحب وإفلات العناصر
تخصيص الخطوط والأحجام والألوان
إضافة النصوص والصور
إضافة العناصر الديناميكية (اسم المستخدم، اسم الدورة، التاريخ، إلخ)
معاينة فورية للتغييرات

🔤 إدارة الخطوط المتقدمة

مدير خطوط متقدم (Font Manager)
رفع خطوط مخصصة (TTF, OTF, WOFF, WOFF2)
معاينة الخطوط
اختبار الخطوط
دعم متعدد اللغات
خطوط افتراضية مدعومة (Dejavusans, Dejavuserif)
خطوط عربية خاصة

🔲 QR Code للتحقق

توليد QR Code تلقائي لكل شهادة
التحقق من صحة الشهادة عبر QR Code
صفحة تحقق منفصلة
تأمين الشهادات من التزوير

🎨 التخصيص الكامل

تخصيص الحدود (Borders) - خطوط أو صور
إضافة الأختام (Seals)
إضافة التوقيعات (Signatures)
إضافة العلامات المائية (Watermarks)
تخصيص النصوص والخطوط
تخصيص الألوان
تخصيص المحاذاة (Left, Center, Right)

📄 بناء القوالب (Template Builder)

إنشاء قوالب شهادات مخصصة
نظام عناصر متقدم
العناصر الديناميكية (Dynamic Elements)
تصدير واستيراد القوالب
التحقق من القوالب (Template Validation)

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

تقرير الشهادات الصادرة
عرض الشهادات لكل مستخدم
عرض الشهادات لكل دورة
تصدير البيانات
حذف الشهادات الصادرة

📧 إشعارات البريد الإلكتروني

إرسال الشهادات عبر البريد الإلكتروني
إشعارات للمدربين عند إصدار شهادة
إشعارات لأطراف أخرى (Notify Others)
تخصيص محتوى البريد الإلكتروني

🌐 دعم متعدد اللغات

دعم كامل للغة العربية
دعم اللغة الإنجليزية
دعم RTL و LTR
خطوط خاصة بالعربية
تنسيق التواريخ حسب اللغة

✅ نظام التحقق (Validation System)

التحقق من بيانات الشهادة
التحقق من الخطوط
التحقق من القوالب
التحقق من المحتوى

التثبيت

المتطلبات

توتارا لتعلّم (Totara Learn) الإصدار 2025012300 أو أحدث
PHP 7.4 أو أحدث
قاعدة بيانات MySQL أو MariaDB
مكتبة PDF (TCPDF) مدعومة مدمجة
امتدادات PHP: GD, mbstring, JSON

خطوات التثبيت

نسخ الملفات:
انسخ مجلد certificate إلى مجلد server/mod/ في توتارا

C:\wamp64\www\totara\server\mod\certificate
تثبيت الإضافة:
انتقل إلى صفحة إدارة الموقع (Site Administration) في توتارا. سيتم اكتشاف الإضافة الجديدة تلقائيًا وستظهر رسالة تشير إلى إكمال التثبيت.
ترقية قاعدة البيانات:
اضغط على زر "Upgrade database" إذا ظهرت رسالة ترقية قاعدة البيانات. سيتم إنشاء الجداول التالية:
- certificate - لحفظ معلومات الشهادات
- certificate_issues - لحفظ الشهادات الصادرة
- وغيرها من الجداول
إعداد الخطوط (اختياري):
قم برفع الخطوط المخصصة من خلال Font Manager إذا كنت تريد استخدام خطوط خاصة.

💡 ملاحظة: الخطوط الافتراضية (Dejavusans, Dejavuserif) مدعومة مدمجة. يمكنك استخدامها مباشرة أو رفع خطوط مخصصة.

الإعدادات

إعدادات الموديول

عند إنشاء نشاط Certificate جديد في دورة، يمكنك تكوين:

الإعداد	الوصف
Certificate Name	اسم الشهادة
Certificate Type	نوع الشهادة (A4, Letter, Embedded, Non-embedded, Custom)
Orientation	الاتجاه (Portrait, Landscape)
Border Style	نمط الحدود (Border Image أو Lines)
Border Color	لون الحدود
Custom Text	نص مخصص (للتوقيعات والأسماء)
Delivery	طريقة التسليم (Open in Browser, Force Download, Email)
Email Others	إرسال إشعارات لآخرين
Print Teacher	طباعة اسم المدرب على الشهادة
Print Seal	طباعة الختم على الشهادة
Print Signature	طباعة التوقيع على الشهادة
Locking Options	خيارات القفل (متى يُصدر الشهادة)
Issue Options	خيارات الإصدار (عند إكمال الدورة، بناءً على الدرجة، إلخ)

إعدادات النظام

يمكن تكوين إعدادات النظام من:

Site Administration > Plugins > Activity modules > Certificate

الإعدادات المتاحة:

Sans-serif font family: خط Sans-serif للشهادات مع الخطوط المدمجة
Serif font family: خط Serif للشهادات مع الخطوط المدمجة

الاستخدام

إنشاء نشاط Certificate

انتقل إلى الدورة التدريبية
قم بتفعيل "Turn editing on"
انقر على "Add an activity or resource"
اختر "Certificate"
املأ النموذج:
- اسم الشهادة
- نوع الشهادة
- إعدادات التصميم
- خيارات الإصدار
انقر على "Save and return to course"

معاينة الشهادة

يمكن معاينة الشهادة من:

/mod/certificate/certificate_preview.php?id=CERTIFICATE_ID

أو من داخل النشاط - زر "Preview"

تتيح صفحة المعاينة:

معاينة مرئية كاملة للشهادة
تكبير وتصغير
تعديل العناصر
تغيير الخطوط والأحجام والألوان
تصدير PDF

استلام الشهادة

يمكن للمستخدمين استلام الشهادة من:

صفحة نشاط Certificate في الدورة
زر "Get your certificate"
سيتم فتح الشهادة أو تنزيلها حسب الإعدادات
يمكن إرسالها عبر البريد الإلكتروني

مشاهدة الشهادات الخاصة

يمكن للمستخدمين عرض جميع شهاداتهم من:

/mod/certificate/viewarchive.php

تعرض هذه الصفحة:

جميع الشهادات الصادرة للمستخدم
تاريخ الإصدار
اسم الدورة
روابط للتحميل

التحقق من الشهادة

يمكن التحقق من صحة الشهادة من:

/mod/certificate/verify.php

أو من خلال مسح QR Code الموجود على الشهادة

أنواع الشهادات

A4 Embedded

شهادة بحجم A4 مع خطوط مدمجة (Embedded Fonts). تستخدم خطوط Dejavusans و Dejavuserif. مناسبة للغات التي تستخدم أحرف خاصة مثل العربية.

المميزات:

دعم كامل للغة العربية
لا يتطلب خطوط على الجهاز
حجم ملف أكبر

A4 Non-Embedded

شهادة بحجم A4 بدون خطوط مدمجة. تستخدم خطوط Helvetica و Times. مناسبة عندما تكون الخطوط متوفرة على أجهزة المستخدمين.

المميزات:

حجم ملف أصغر
يتطلب خطوط على الجهاز
أفضل للغة الإنجليزية

Letter Embedded

شهادة بحجم Letter (8.5 × 11 بوصة) مع خطوط مدمجة. نفس مميزات A4 Embedded ولكن بحجم Letter.

Letter Non-Embedded

شهادة بحجم Letter بدون خطوط مدمجة. نفس مميزات A4 Non-Embedded ولكن بحجم Letter.

Custom Editor

محرر مخصص للشهادات. يسمح بإنشاء تصميمات شهادات مخصصة بالكامل باستخدام واجهة تحرير مرئية.

المميزات:

حرية كاملة في التصميم
واجهة تحرير مرئية
سحب وإفلات العناصر
تخصيص كامل

💡 نصيحة: استخدم Embedded types للغات التي تستخدم أحرف خاصة مثل العربية، واستخدم Non-Embedded types للغة الإنجليزية إذا كنت تريد حجم ملفات أصغر.

المحرر المخصص (Custom Editor)

نظرة عامة

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

الوصول إلى المحرر

يمكن الوصول إلى المحرر المخصص من:

/mod/certificate/certificate_editor.php?id=CERTIFICATE_ID

أو من داخل نشاط Certificate - زر "Edit Certificate"

العناصر المتاحة

يمكن إضافة العناصر التالية:

العنصر	الوصف
Text Element	عنصر نص ثابت
Dynamic Element	عنصر ديناميكي (اسم المستخدم، اسم الدورة، التاريخ، إلخ)
Image Element	صورة
Border Element	حدود
Seal Element	ختم
Signature Element	توقيع
Watermark Element	علامة مائية

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

يمكن تخصيص كل عنصر:

الموضع (Position): X, Y للإحداثيات
الخط (Font): اختيار الخط
الحجم (Size): حجم الخط
اللون (Color): لون النص
المحاذاة (Alignment): Left, Center, Right
العرض والارتفاع (Width/Height): للصور والعناصر

العناصر الديناميكية

العناصر الديناميكية المتاحة:

{USER_NAME} - اسم المستخدم
{COURSE_NAME} - اسم الدورة
{DATE} - تاريخ الإصدار
{GRADE} - الدرجة
{TEACHER} - اسم المدرب
{CREDIT_HOURS} - ساعات معتمدة
وغيرها

إدارة الخطوط (Font Management)

مدير الخطوط

يمكن الوصول إلى مدير الخطوط من:

/mod/certificate/font_manager.php

يسمح مدير الخطوط بـ:

عرض جميع الخطوط المتاحة
رفع خطوط جديدة (TTF, OTF, WOFF, WOFF2)
معاينة الخطوط
اختبار الخطوط
حذف الخطوط المخصصة
عرض إحصائيات الخطوط

رفع خط جديد

انتقل إلى Font Manager
انقر على "Upload Font"
اختر ملف الخط (TTF, OTF, WOFF, WOFF2)
أدخل اسم الخط (اختياري)
انقر على "Upload"
سيتم حفظ الخط في مجلد fonts/

الخطوط المدعومة

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

TTF (TrueType Font): النوع الأكثر شيوعًا
OTF (OpenType Font): نوع متقدم
WOFF (Web Open Font Format): للويب
WOFF2: نسخة محسّنة من WOFF

الخطوط الافتراضية

الإضافة تأتي مع خطوط افتراضية:

Dejavusans: خط Sans-serif للخطوط المدمجة
Dejavuserif: خط Serif للخطوط المدمجة
Helvetica: للخطوط غير المدمجة
Times: للخطوط غير المدمجة
خطوط عربية خاصة (إذا كانت مرفوعة)

اختبار الخط

يمكن اختبار الخط لمعرفة:

كيف يظهر النص
الأداء
استخدام الذاكرة
دعم الأحرف الخاصة

QR Code للتحقق

نظرة عامة

كل شهادة يتم إصدارها تحصل على QR Code فريد. يمكن استخدام هذا QR Code للتحقق من صحة الشهادة والتأكد من أنها أصليّة وليست مزورة.

كيف يعمل

عند إصدار شهادة، يتم توليد رمز فريد (Unique Code)
يتم إنشاء QR Code يحتوي على رابط التحقق
يتم طباعة QR Code على الشهادة
يمكن مسح QR Code للتحقق من صحة الشهادة

التحقق من الشهادة

يمكن التحقق من الشهادة من:

/mod/certificate/verify.php?code=CERTIFICATE_CODE

أو من خلال:

مسح QR Code الموجود على الشهادة
إدخال رمز الشهادة يدويًا

صفحة التحقق

تعرض صفحة التحقق:

معلومات الشهادة
اسم المستخدم
اسم الدورة
تاريخ الإصدار
حالة الشهادة (صحيحة أو غير صحيحة)

💡 ملاحظة: QR Code يوفر أمانًا إضافيًا للشهادات ويساعد في منع التزوير.

بناء القوالب (Template Builder)

نظرة عامة

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

استخدام Template Builder

use mod_certificate\builder\template_builder;

$builder = new template_builder('A4_embedded');

$template = $builder
    ->addTextElement('Certificate Title', 10, 30, 'freesans', 30, '#000080', 'C')
    ->addTextElement('This is to certify that', 10, 50, 'freeserif', 20, '#000000', 'C')
    ->addDynamicElement('user_name', 10, 70, ['font' => 'freesans', 'size' => 30])
    ->addTextElement('has completed the course', 10, 90, 'freeserif', 20, '#000000', 'C')
    ->addDynamicElement('course_name', 10, 110, ['font' => 'freesans', 'size' => 20])
    ->addDynamicElement('date', 10, 130, ['font' => 'freeserif', 'size' => 14])
    ->build();
            

التحقق من القوالب

يمكن التحقق من صحة القوالب للتأكد من أنها صحيحة ولا تحتوي على أخطاء. يقوم النظام بالتحقق من:

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

التخصيص

الحدود (Borders)

يمكن تخصيص الحدود بطريقتين:

Border Image: استخدام صورة للحدود من مجلد pdfresources/borders/
Border Lines: استخدام خطوط بسيطة بألوان مختلفة

الأختام (Seals)

يمكن إضافة أختام من:

مجلد pdfresources/seals/
رفع ختم مخصص

التوقيعات (Signatures)

يمكن إضافة توقيعات من:

مجلد pdfresources/signatures/
رفع توقيع مخصص
استخدام نص مخصص بدلاً من صورة

العلامات المائية (Watermarks)

يمكن إضافة علامات مائية من:

مجلد pdfresources/watermarks/
رفع علامة مائية مخصصة

تخصيص النصوص

يمكن تخصيص:

نص الشهادة الرئيسي
نص مخصص للتوقيعات
تنسيق التاريخ
تنسيق الدرجات

خيارات الإصدار

يمكن تحديد متى تُصدر الشهادة:

عند إكمال الدورة (Course Completion)
بناءً على الدرجة (Grade Requirement)
بناءً على الوقت في الدورة (Time Requirement)
يدويًا من قبل المدرب

الصلاحيات (Capabilities)

الإضافة تحتوي على الصلاحيات التالية:

الصلاحية	الوصف	الافتراضي
certificate:addinstance	إضافة نشاط Certificate	المديرون والمدربون
certificate:view	عرض الشهادة	جميع المستخدمين المسجلين
certificate:student	استلام الشهادة	جميع المستخدمين المسجلين
certificate:manage	إدارة نشاط Certificate	المديرون والمدربون
certificate:printteacher	طباعة اسم المدرب على الشهادة	المدربون
certificate:receivenotification	تلقي إشعارات عند إصدار شهادة	المدربون

💡 ملاحظة: يمكن تخصيص هذه الصلاحيات من Site Administration > Users > Permissions > Define roles

استكشاف الأخطاء

المشاكل الشائعة

الشهادة لا تُصدر

تحقق من شروط الإصدار (Course Completion, Grade, Time)
تحقق من أن المستخدم أكمل الدورة
تحقق من الصلاحيات
تحقق من إعدادات Locking Options

الخطوط لا تظهر بشكل صحيح

استخدم Embedded types للغات الخاصة
تحقق من أن الخط موجود في مجلد fonts/
اختبر الخط من Font Manager
تحقق من دعم الخط للغة المستخدمة

QR Code لا يعمل

تحقق من أن QR Code تم توليده
تحقق من رابط التحقق
تحقق من قاعدة البيانات
تحقق من سجلات الأخطاء

الصور لا تظهر

تحقق من مسار الصور
تحقق من أن الصور موجودة في المجلدات الصحيحة
تحقق من صلاحيات القراءة للملفات
تحقق من حجم الصور

المحرر المخصص لا يعمل

تحقق من JavaScript في المتصفح
تحقق من سجلات الأخطاء في المتصفح (Browser Console)
تحقق من وجود ملفات JavaScript
قم بمسح التخزين المؤقت للمتصفح

الشهادة لا تُرسل عبر البريد الإلكتروني

تحقق من إعدادات SMTP في توتارا
تحقق من إعداد "Delivery" في الشهادة
تحقق من صحة البريد الإلكتروني للمستخدم
تحقق من سجلات الأخطاء

سجلات الأخطاء

يمكن العثور على سجلات الأخطاء في ملفات السجل الخاصة بتوتارا. يتم تسجيل جميع الأخطاء مع البادئة [CERTIFICATE] لتسهيل البحث.

وضع التصحيح

لتمكين وضع التصحيح في توتارا لرؤية رسائل الأخطاء التفصيلية:

انتقل إلى Site Administration > Development > Debugging
فعّل "Debug messages"
حدد مستوى التصحيح
احفظ التغييرات