AraTheme — دليل التثبيت (خطوة بخطوة)

قراءة 4 دقيقة 24 مشاهدة

AraTheme 1.3 · لمديري WHMCS

يأخذك هذا الدليل خطوة بخطوة من ملف zip الذي نزّلته إلى موقع يعمل بـ AraTheme. خصّص نحو 15 دقيقة. تحتاج إلى وصول عبر FTP أو مدير الملفات إلى مجلد WHMCS، وإلى حساب مدير في WHMCS بصلاحيات كاملة.

قبل أن تبدأ

  • تحقق من المتطلبات في Start here (ابدأ من هنا): WHMCS 9.0+، وPHP 8.1+، وionCube Loader، وإضافات PHP ‏curl وsodium وzip وgd. يمكنك معرفة إصداراتك في WHMCS من Help → System Health Status (أو Utilities → System → PHP Info).
  • خذ نسخة احتياطية من مجلد templates ومن قاعدة البيانات. لا يغيّر AraTheme ملفات WHMCS الأساسية، لكن النسخ الاحتياطي ممارسة جيدة دائمًا.
  • نسخة الاختبار أولًا (موصى به): إذا كانت لديك نسخة اختبار (staging) من WHMCS، فجرّبه عليها أولًا. تحتاج نسخة الاختبار إلى مفتاح ترخيص خاص بها.
  • جهّز مفتاح الترخيص (منطقة العملاء → Services → AraTheme for WHMCS).

الخطوة 1 — رفع الملفات

  1. فك ضغط aratheme-x.y.z.zip على حاسوبك.
  2. افتح مجلد upload/. يحتوي على templates/ وmodules/.
  3. ارفع محتويات upload/ إلى المجلد الجذري لـ WHMCS — وهو المجلد الذي يضم configuration.php وclientarea.php وcart.php. اترك المجلدات تندمج؛ لن يُستبدل أي شيء من ملفات WHMCS.
  4. تحقق من وجود هذه المجلدات الثلاثة الآن على الخادم:
    • templates/arahosterone/
    • templates/orderforms/arahoster_cart/
    • modules/addons/arahoster_theme/

نصيحة: ارفع الملفات بالوضع الثنائي (binary) (يفعل FileZilla ذلك افتراضيًا). إذا غيّر برنامج FTP ملفات PHP المشفّرة، فلن تُحمَّل الإضافة.

الخطوة 2 — تفعيل الإضافة

  1. في لوحة إدارة WHMCS انتقل إلى System Settings → Addon Modules (في WHMCS 9: أيقونة الترس → Apps & Integrations → Addon Modules، أو ابحث عن "Addon Modules").
  2. ابحث عن AraTheme وانقر Activate (تفعيل).
  3. انقر Configure (إعداد). ضمن Access Control (التحكم في الوصول)، حدّد مجموعات أدوار المديرين المسموح لها باستخدام مدير الثيم (على الأقل Full Administrator).
  4. اترك الخيار Keep settings on deactivate محدّدًا. بذلك تبقى إعداداتك محفوظة إذا أُلغي تفعيل الإضافة في أي وقت.
  5. انقر Save Changes.

الخطوة 3 — إدخال مفتاح الترخيص

  1. انتقل إلى Addons → AraTheme. بدون ترخيص ستظهر لك شاشة التفعيل (بالإنجليزية والعربية).
  2. الصق مفتاح الترخيص وانقر Activate.
  3. يُفتح مدير الثيم ويعرض الشريط العلوي حالة الترخيص Active (فعّال). إذا ظهرت Server unreachable (تعذّر الوصول إلى الخادم)، فهذا يعني أن خادمك لا يستطيع الوصول إلى https://me.arahoster.com — اطلب من شركة الاستضافة السماح باتصالات HTTPS الصادرة، ثم انقر Check now ضمن Licence & updates.

الخطوة 4 — تحويل WHMCS إلى AraTheme

  1. انتقل إلى System Settings → General Settings.
  2. في تبويب General، اضبط System Theme على arahosterone.
  3. في تبويب Ordering، اضبط Default Order Form Template على arahoster_cart.
  4. انقر Save Changes. قد يطلب منك WHMCS تأكيد كلمة مرور المدير — وهذه خطوة أمان عادية في WHMCS.
  5. يمكن أن تكون لمجموعات المنتجات سلة طلب خاصة بها. افتح System Settings → Products/Services، وعدّل كل مجموعة منتجات وتحقق من Order Form Template: اختر Use System Default أو arahoster_cart.

إذا رأيت المظهر القديم بعد التحويل، فأفرغ ذاكرة التخزين المؤقت للقوالب: Utilities → System → System Cleanup → Empty Template Cache، ثم أعد تحميل الصفحة.

الخطوة 5 — الفحص الأول (10 دقائق)

افتح موقعك في نافذة تصفح خاصة وتحقق من الآتي:

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

إذا بدا شيء غير صحيح، فراجع Troubleshooting and FAQ (استكشاف الأخطاء وإصلاحها والأسئلة الشائعة) أو افتح تذكرة.

الخطوة 6 — اجعله خاصًا بك (بداية سريعة)

يبدأ التثبيت الجديد بمظهر محايد: يُؤخذ اسم شركتك وشعارها من WHMCS إلى أن تضبطهما بنفسك. بعد ذلك مرّ على هذه الأقسام في Addons → AraTheme:

  1. Brand — الاسم، والشعار النصي (tagline)، والشعارات.
  2. Colours & look — ألوان العلامة التجارية والأزرار (يخبرك فحص التباين إن كان النص سيبقى مقروءًا).
  3. Header وMenus — ما يعرضه الشريط العلوي، والروابط الإضافية.
  4. Homepage — نص الواجهة الرئيسية (hero)، والأقسام، وتبويبات الخطط، والأسئلة الشائعة. اكتب فقط معلومات صحيحة عن شركتك.
  5. Footer — نص التعريف، وأعمدة الروابط، وشارات الدفع.
  6. SEO — عنوان الصفحة الرئيسية ووصفها، ثم دليل SEO الموجود في ذلك القسم.
  7. Cookies & privacy — مطلوب بمجرد إضافة Google Analytics أو أي بكسل تتبع.

يُحفظ كل قسم على حدة. يتيح محدِّد Editing في الأعلى التبديل بين All languages (default) ولغة واحدة، للنصوص التي تختلف من لغة إلى أخرى.

ماذا لو ظهرت في الثيم رسالة "AraTheme is not activated on this site"؟

يظهر هذا الشريط عندما يكون الثيم محددًا في WHMCS لكن الإضافة غير مفعّلة أو الترخيص غير فعّال. فعّل الإضافة (الخطوة 2) وأدخل مفتاحك (الخطوة 3). بدون ترخيص فعّال يعيد AraTheme تلقائيًا WHMCS إلى الثيم وسلة الطلب الخاصين به، فلا يُترك عملاؤك أبدًا دون موقع يعمل.

هل كانت المقالة مفيدة ؟