يُثبَّت Cardix من ملف ZIP واحد للتثبيت. تحتوي الحزمة على كل ما يحتاجه Cardix، بما في ذلك خطوطه وقوالب ARN Smart الجاهزة، لذا لا يُنزَّل أي شيء أثناء التثبيت. تفحص صفحة الإعداد الموجودة داخل الحزمة خادمك وكل ملف، وتفعّل ترخيصك، وتنشئ حساب المسؤول.
قبل أن تبدأ
- تحقّق من متطلبات الخادم.
- احرص على وجود ملف ZIP الخاص بتثبيت Cardix على حاسوبك. نزّله من الرابط الموجود في رسالة الترخيص.
- أبقِ رسالة الترخيص التي تحتوي على رمز تفعيل ARNA في متناول يدك.
- اختر العنوان الذي سيستخدمه Cardix، مثل
https://cards.example.com/أو مجلد فرعي مثلhttps://www.example.com/cards/. استخدم مجلدًا فارغًا: لا يعمل الإعداد في مجلد يحتوي بالفعل على تثبيت Cardix. - احرص على توفّر وصول FTP أو مدير الملفات في استضافتك.
رفع الحزمة
- ارفع ملف ZIP الخاص بالتثبيت إلى المجلد الذي سيعمل فيه Cardix.
- فكّ ضغطه هناك مع الإبقاء على مجلداته. تحتوي الحزمة، من بين أشياء أخرى، على
setup.phpوadmin.phpوindex.php، والمجلداتdataوclientوlangوassetsوpwa، وملفINSTALL.txt. - افتح
https://cards.example.com/setup.phpفي متصفحك فورًا (وفي حالة المجلد الفرعيhttps://www.example.com/cards/setup.php). لا تترك حزمة مفكوكة الضغط بانتظار إعدادها. وإلى أن يكتمل الإعداد، يفتح عنوان المجلد وadmin.phpصفحة الإعداد أيضًا.
تشغيل الإعداد
يتكوّن الإعداد من ثلاث خطوات تظهر أعلى الصفحة: اللغة والفحص والتفاصيل وتم.
- اختر لغة الإعداد. انقر TR أو EN أو AR. يستمر الإعداد بتلك اللغة؛ وتُعرض الصفحات العربية من اليمين إلى اليسار. يمكنك تغيير اللغة لاحقًا من المبدّل أعلى اليمين.
- راجع فحص الخادم. تعرض لوحة فحص الخادم 11 عنصرًا، كلٌّ منها موسوم بـ مطلوب أو موصى به، وتُظهر جاهز أو مفقود لكل عنصر. يفحص بند ملفات الحزمة كل ملف في ملف ZIP الخاص بالتثبيت؛ وإذا كان ملف مفقودًا أو معدَّلًا، مثلًا بعد رفع لم يكتمل، يظهر اسمه. ارفع ملف ZIP كاملًا مرة أخرى وفك ضغطه.
- أدخل الترخيص وحساب المسؤول في نموذج الترخيص وحساب المسؤول. الحقول موضحة في الجدول أدناه.
- إذا كانت العناصر المفقودة من العناصر الموصى بها فقط، فحدّد التثبيت في الوضع المحدود. يمكن عندها متابعة الإعداد، لكن العناصر المفقودة قد تؤثر في بعض الميزات.
- انقر تثبيت Cardix. يجري التحقق من ترخيصك لدى ARN Smart؛ ويستغرق الإعداد بضع ثوانٍ.
| الحقل | ما يجب إدخاله |
|---|---|
| اسم العميل (اختياري) | شركتك أو صاحب الفعالية. يصبح عنوان موقع صفحات المشاركين؛ وبدونه يكون العنوان "Cardix" |
| رمز التفعيل ARNA | الرمز الموجود في رسالة الترخيص الإلكترونية، مثل ARNA-XXXX… |
| اسم المستخدم | 3 أحرف على الأقل: حروف وأرقام و_ و- و. |
| كلمة المرور وتكرار كلمة المرور | 12 حرفًا على الأقل |

يعرض قسم تفاصيل الإعداد أسفل فحص الخادم النطاق الذي سيُربط به الترخيص وإصدار Cardix.
ما الذي يفعله الإعداد
- يفعّل الترخيص لدى ARN Smart ويربطه بالنطاق الذي تثبّت عليه. راجع تفعيل ترخيص Cardix.
- يثبّت الخطوط وحزمة القوالب الجاهزة المرفقة بالحزمة.
- يمنح مجلدات البيانات أسماء عشوائية، فلا يمكن تخمين عناوينها.
- يكتب
config.phpوقواعد الأمان في ملفات.htaccessوملف.user.iniبحدود PHP التي يحتاجها Cardix. - ينشئ فعالية نموذجية أولى، عيد مبارك، يمكنك تعديلها أو حذفها.
- يحذف
setup.phpمن الخادم عند اكتمال التثبيت.
عند اكتمال التثبيت
تعرض صفحة تم تثبيت Cardix بيانات تسجيل الدخول الخاصة بك:
| العنصر | ما يعرضه |
|---|---|
| لوحة الإدارة | عنوان لوحة الإدارة، مثل https://cards.example.com/admin.php |
| اسم المستخدم | اسم مستخدم المسؤول الذي اخترته |
| كلمة المرور | لا تُعرض: "كلمة المرور التي عيّنتها أثناء الإعداد" |
| صفحة المشاركين | الصفحة العامة لمشاركيك، مثل https://cards.example.com/ |
لكل عنوان زر نسخ. انقر فتح لوحة الإدارة أو فتح صفحة المشاركين؛ وإلا فستُفتح لوحة الإدارة تلقائيًا بعد 8 ثوانٍ. دوّن عنوان لوحة الإدارة واسم المستخدم: فلن تُفتح شاشة الإعداد مرة أخرى.
إذا تعذّر إكمال الإعداد
يعرض الإعداد تعذّر إكمال الإعداد والسبب. إذا فشلت خطوة بعد تفعيل الترخيص، يتراجع الإعداد عن تغييراته، فلا يبقى التثبيت ناقصًا أبدًا. عالج السبب وشغّل setup.php مرة أخرى. يمكنك خلال يوم واحد استخدام رمز التفعيل نفسه مجددًا؛ ولن يُفعَّل مرة ثانية.
الأسباب الشائعة:
- أحد العناصر المطلوبة في فحص الخادم مفقود.
- رمز التفعيل مفقود أو خاطئ: "أدخل رمز التفعيل ARNA المرسل إلى بريدك الإلكتروني."
- اسم المستخدم أقصر من 3 أحرف، أو كلمة المرور أقصر من 12 حرفًا، أو كلمتا المرور غير متطابقتين.
- مجلد Cardix غير قابل للكتابة، مثل "تحقق من صلاحيات الكتابة".
إذا تعذّر تثبيت حزمة القوالب الجاهزة، يكتمل التثبيت مع ذلك. يمكنك تثبيت الحزمة لاحقًا من شاشة القوالب الجاهزة عبر تثبيت القوالب الجاهزة.
حماية مجلدات البيانات على Nginx
بعد تسجيل دخولك، تتحقق لوحة الإدارة من متصفحك مما إذا كان خادم الويب يحمي مجلدات البيانات. وإن لم يكن كذلك، وغالبًا على Nginx، يظهر تحذير أعلى اللوحة: "يمكن فتح مجلد بيانات Cardix من الإنترنت". ويعرض الأسطر الدقيقة الخاصة بتثبيتك. إذا كان Cardix في جذر الموقع فهي:
location ^~ "/data/" { deny all; }
location ^~ "/storage" { deny all; }
إذا كان Cardix في مجلد فرعي، فستبدأ المسارات بذلك المجلد. أضف الأسطر إلى كتلة server الخاصة بموقعك وأعد تحميل Nginx. أما على Apache، فاسمح بملفات .htaccess لمجلد Cardix (AllowOverride All).