يُثبَّت Ticketix من حزمة التثبيت بصيغة ZIP في مجلد جديد فارغ. يُنشئ الإعداد عبر المتصفح ملف الإعدادات وأول حساب مسؤول.
قبل أن تبدأ
- تحقق من متطلبات الخادم.
- احتفظ بملف ZIP لتثبيت Ticketix على جهازك. نزّله من الرابط الموجود في رسالة الترخيص. لا تستخدم ملف ZIP الخاص بالتحديث لتثبيت جديد، ولا ترفع حزمة التثبيت فوق تثبيت موجود.
- أنشئ قاعدة بيانات MySQL فارغة (
utf8mb4) ومستخدم قاعدة بيانات بصلاحيات كاملة عليها. - حدّد العنوان العام، مثل
https://support.example.comأوhttps://support.example.com/ticketix، وتأكد من أنه يعمل عبر HTTPS. - ثبّت تطبيق مصادقة على هاتفك، فستحتاج إليه عند أول تسجيل دخول.
رفع الملفات
- فك ضغط ملف ZIP الخاص بالتثبيت في مجلد الويب الخاص بالعنوان الذي اخترته.
- تأكد من أن مستخدم خادم الويب يستطيع الكتابة في مجلد التطبيق وفي مجلد
storage. - على Nginx، أضف قواعد الوصول الموضحة في المتطلبات. أما على Apache، فيتولى ذلك ملف
.htaccessالمرفق.
تشغيل الإعداد
- افتح صفحة الإعداد على العنوان العام، مثل
https://support.example.com/setup.php. افتحها على العنوان النهائي، لأن الإعداد يحفظ هذا العنوان فيapp_url. - املأ الحقول:
| الحقل | ما يجب إدخاله |
|---|---|
| اسم التطبيق | الاسم الظاهر في الواجهة وفي رسائل البريد الإلكتروني |
| اللغة الافتراضية | English أو Türkçe أو العربية |
| جذر التخزين | مجلد التخزين؛ احتفظ بمجلد storage المقترح ما لم تتطلب استضافتك مسارًا آخر |
| بريد الدعم | العنوان الذي يراه العملاء والمرسل الافتراضي |
| مضيف خادم البريد | اسم المضيف لخادم البريد لديك |
| المضيف، المنفذ، اسم قاعدة البيانات، مستخدم قاعدة البيانات، كلمة مرور قاعدة البيانات | بيانات MySQL الخاصة بك، ضمن قاعدة البيانات (MySQL) |
| مجموعة الأحرف، الترتيب | احتفظ بـ utf8mb4 وutf8mb4_unicode_ci ما لم يكن لديك سبب لتغييرهما |
| اسم المسؤول، بريد المسؤول، كلمة مرور المسؤول | حساب المسؤول الأول؛ يجب أن تتكون كلمة المرور من 8 أحرف على الأقل |
- انقر على تثبيت Ticketix. يختبر الإعداد الاتصال بقاعدة البيانات، ويكتب
config.php، وينشئ الجداول وحساب المسؤول. - عندما تظهر رسالة اكتمل التثبيت. يمكنك الآن تسجيل الدخول.، انقر على دخول المسؤول.
بعد تثبيت Ticketix، يؤدي فتح setup.php إلى صفحة تسجيل الدخول فقط. تقترح شاشة الإعداد حذف setup.php بعد التثبيت. بدءًا من Ticketix 2.0.2، لا يحتوي ملف ZIP الخاص بالتحديث على setup.php، لذا لا يعود setup.php المحذوف مع التحديث.
ملف config.php وapp_url
ينشئ الإعداد ملف config.php الدائم من القالب config.sample.php. يحتوي الملف على بيانات قاعدة البيانات، والمفاتيح السرية التي أنشأها Ticketix (للمهمة المجدولة وفحص السلامة والبريد الوارد)، وهذه الإعدادات:
| الإعداد | الافتراضي | ما يفعله |
|---|---|---|
app_url | العنوان الذي فتحت به الإعداد | العنوان العام المستخدم في الروابط داخل رسائل البريد، بما فيها الرسائل التي ترسلها المهمة المجدولة |
storage_root | مجلد storage | المرفقات والسجلات والجلسات وملفات الترخيص وai-secret.key |
auto_close_days | 7 | عدد الأيام التي تُغلق بعدها التذاكر في حالة «قيد الانتظار» أو «تم الرد» تلقائيًا |
invite_expiry_hours | 72 | مدة صلاحية رابط دعوة العميل |
app_url هو العنوان العام الكامل بما في ذلك أي مجلد فرعي، دون شرطة مائلة في النهاية:
'app_url' => 'https://support.example.com/ticketix',
إذا نقلت Ticketix لاحقًا إلى عنوان آخر، فغيّر app_url في config.php. بدون app_url صحيح، لا يمكن فتح الروابط في الرسائل التي ترسلها المهمة المجدولة (مثل تأكيد تذكرة أُنشئت من بريد وارد).
مهم: لا تنشر
config.phpأبدًا ولا تستبدله أثناء التحديثات. احتفظ بنسخة احتياطية منه مع مجلدstorage.
تسجيل الدخول لأول مرة
يجب على المسؤولين والوكلاء استخدام المصادقة الثنائية. ستقوم بإعدادها عند تسجيل دخولك الأول:
- افتح صفحة تسجيل دخول الموظفين على
/admin/(مثلhttps://support.example.com/admin/). تحمل الصفحة اسم تسجيل دخول الموظفين. - أدخل بريد المسؤول في البريد الإلكتروني أو اسم العرض، وأدخل كلمة المرور، ثم انقر على تسجيل الدخول.
- يفتح Ticketix شاشة إعداد المصادقة الثنائية. افتح تطبيق المصادقة، وأضف حسابًا، وامسح رمز QR. إذا تعذّر عليك مسحه، فافتح لا يمكنك المسح؟ أدخل مفتاح الإعداد واكتب المفتاح في التطبيق.
- أدخل الرمز المكوّن من ستة أرقام من التطبيق وكلمة المرور الحالية، ثم انقر على تفعيل المصادقة الثنائية.
- يعرض Ticketix شاشة احفظ رموزك الاحتياطية: عشرة رموز تُستخدم مرة واحدة. احفظها في مدير كلمات المرور لديك، فهي لا تظهر إلا مرة واحدة.
رمز الإعداد صالح لمدة عشر دقائق. إذا انتهت صلاحيته، فانقر على إنشاء رمز إعداد جديد وامسح رمز QR الجديد.
من الآن فصاعدًا، سيُطلب منك في كل تسجيل دخول رمز من تطبيق المصادقة بعد كلمة المرور. راجع المصادقة الثنائية وإعادة تعيين كلمة المرور.
بعد التثبيت
- اقصر صلاحية الكتابة في مجلد التطبيق على المستخدم الذي يعمل به PHP. تتطلب التحديثات من شاشة التحديثات أن يكتب PHP ملفات التطبيق؛ وإذا تعذّر عليه ذلك، فحدّث يدويًا باستخدام ملف ZIP الخاص بالتحديث. يجب أن يظل مجلد
storageقابلًا للكتابة. راجع تحديث Ticketix. - احتفظ بنسخ احتياطية منتظمة من
config.phpومجلدstorageفي مكان محدود الوصول. يحمي الملفstorage/ai-secret.keyمفاتيح مزودي الذكاء الاصطناعي المخزّنة والمفاتيح السرية لتطبيقات المصادقة الثنائية.