AraTheme 1.3 · لمسؤولي WHMCS
إعدادات System، والنسخ الاحتياطي لإعداداتك، وإجابات عن المشكلات الشائعة، وكيفية إزالة AraTheme بشكل نظيف.
الميزات (Features)
- Show "Get started" (register) in the header. (إظهار زر "Get started" للتسجيل في الترويسة.)
- Load only the styles each page needs — صفحات أسرع: ملف أساسي مشترك إضافة إلى ملف واحد للصفحة الرئيسية أو منطقة العملاء أو المتجر. أوقف هذا الخيار أثناء اختبار CSS المخصص الخاص بك.
- Load Font Awesome — تحتاجه وحدات كثيرة (cPanel، ولوحات VPS، وبوابات الدفع). لا توقفه إلا إذا لم يكن هناك شيء في موقعك يستخدمه.
- Force right-to-left layout for every language. (فرض التخطيط من اليمين إلى اليسار لكل اللغات.)
CSS المخصص والنسخ الاحتياطي
CSS المخصص (Custom CSS)
شيفرة CSS الخاصة بك، تُحمَّل بعد الثيم في كل صفحة. يستخدم الثيم متغيرات CSS، على سبيل المثال:
:root { --r: 20px; } /* rounder cards */
.x-logo-tag { display: none; } /* hide the tagline under the logo */احتفظ بتعديلاتك هنا بدلًا من تعديل ملفات الثيم: فالتحديثات تستبدل ملفات الثيم، لكنها لا تمسّ إعداداتك أبدًا.
تصدير الإعدادات واستيرادها
- Export ينزّل كل الإعدادات في ملف JSON واحد — استخدمه نسخةً احتياطية قبل التغييرات الكبيرة، أو لنسخ إعداداتك إلى تثبيت آخر (مثلًا من النسخة التجريبية staging إلى الموقع الفعلي).
- Import يحمّل ملفًا من هذا النوع. تُدمج النصوص لكل لغة: نصوص الملف هي التي تُعتمد، وتبقى النصوص الأخرى التي ضبطتها مسبقًا كما هي.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب والحل |
|---|---|
| صفحة الإضافة فارغة أو تعرض خطأ PHP / ionCube | أداة ionCube Loader غير موجودة أو قديمة جدًا، أو إصدار PHP أقدم من 8.1، أو رُفعت الملفات بوضع النص (ASCII). تحقّق من System Health Status، وأعد الرفع بالوضع الثنائي (binary). |
| شاشة التفعيل تعود للظهور باستمرار | المفتاح خاطئ، أو الترخيص غير نشط، أو خادمك لا يستطيع الوصول إلى https://me.arahoster.com. انسخ المفتاح مجددًا من منطقة العملاء لديك، وتحقّق من اتصالات HTTPS الصادرة، ثم انقر Check now. |
| عاد WHMCS إلى ثيم Twenty-One من تلقاء نفسه | الترخيص غير نشط (منتهٍ، أو غير مدفوع، أو تعذّر الوصول إلى الخادم بعد انقضاء فترة السماح). جدّد الترخيص وانقر Check now؛ فيعود AraTheme إلى العمل بكل إعداداتك. |
| يظهر شريط يقول "AraTheme is not activated on this site" | الثيم محدَّد، لكن الإضافة أو الترخيص غير نشط. راجع دليل التثبيت، الخطوتين 2 و3. |
| بعض المنتجات ما زالت تستخدم سلة الطلب القديمة | مجموعات المنتجات هذه لها سلة طلب خاصة بها. عدّل المجموعة واختر Use System Default أو arahoster_cart. |
| يبقى المظهر القديم بعد التحديث | أفرغ ذاكرة التخزين المؤقت للقوالب في WHMCS (Utilities → System → System Cleanup) وأعد تحميل الصفحة بالضغط على Ctrl/Cmd + Shift + R. |
| زر "Update to …" غير موجود | إما أنك تستخدم أحدث إصدار، أو أن الترخيص غير نشط، أو أن أحد فحوصات الخادم في لوحة Updates باللون الأحمر. أصلح الفحص أو حدّث يدويًا. |
| الأيقونات مفقودة في صفحة إحدى الوحدات | فعّل Features → Load Font Awesome. |
| الرسائل البريدية ما زالت تبدو كما كانت | لا يُستخدم تصميم الرسائل البريدية إلا بعد النقر على Use this style for client emails في Emails & invoice. |
| الشعار في الرسائل البريدية أو فاتورة PDF هو الشعار القديم | ارفع الشعار في Emails & invoice (PNG أو JPG، أبيض أو فاتح للترويسات الداكنة). الحقول الفارغة تعود إلى شعار WHMCS. |
| أحد العروض لا يظهر | رمز الخصم الخاص به غير موجود أو منتهي الصلاحية في WHMCS، أو التواريخ خارج الوقت الحالي، أو الخيار On غير محدَّد. |
| الحالة المباشرة تعرض "unknown" | عنوان صفحة الحالة خاطئ أو محجوب، أو مهمة cron في WHMCS لا تعمل. انقر Check now في Support → Live status. |
| فشل رفع صورة الملف الشخصي | امتداد PHP GD غير موجود، أو حجم الصورة أكبر من 8 MB. |
| لا تظهر لافتة الكوكيز | مع الخيار Automatically لا تظهر اللافتة إلا بعد استخدامك أداة تتبع أو شيفرتك الخاصة. وهذا صحيح: فمن دون كوكيز اختيارية لا حاجة إلى لافتة. |
| صفحة من منشئ الصفحات تعرض "not found" | ما زالت مسودة (لا يرى المسودات إلا المسؤولون)، أو أن العنوان خاطئ. |
| تظهر في العناوين "&" | أُصلحت في 1.3.1. افتح القسم، وتحقّق من النص واحفظه مرة واحدة. |
الأسئلة الشائعة
هل يمكنني تعديل ملفات القوالب؟
نعم، القوالب وCSS وJavaScript مفتوحة. لكن التحديث يستبدلها، لذا ضع تعديلاتك في Custom CSS وAll texts وبقية الإعدادات — فهذه لا تمسّها التحديثات أبدًا.
هل يعمل AraTheme مع وحداتي وبوابات الدفع لديّ؟
نعم. تحتفظ منطقة العملاء بترميز WHMCS الأصلي في المواضع التي ترتبط بها الوحدات، وأسماء أصناف Bootstrap منسَّقة، وتحتفظ سلة الطلب بمعرّفات Standard Cart وأصنافه. إذا بدا شيء غير سليم، أخبرنا باسم الوحدة.
ما اللغات المدعومة؟
كل لغات WHMCS. نصوص الثيم متوفرة بالإنجليزية والعربية والنرويجية والإسبانية، ويمكن تعديل كل نص لكل لغة. والاتجاه من اليمين إلى اليسار تلقائي للعربية والفارسية والعبرية والأردية والكردية والبشتو.
هل سيُعطّل تحديثُ WHMCS الثيم؟
يدعم AraTheme إصدار WHMCS 9.0 وما بعده، وهو مبني على قوالب WHMCS نفسها. نختبر إصدارات WHMCS الجديدة ونوفّر الإصلاحات عبر التحديثات بنقرة واحدة.
هل أحتاج إلى ترخيص لموقعي التجريبي (staging)؟
نعم، يحتاج كل تثبيت إلى مفتاح نشط. افتح تذكرة واسأل عن مفتاح للنسخة التجريبية.
ماذا يحدث لإعداداتي إذا أوقفت الترخيص؟
تبقى في قاعدة بياناتك. يستخدم WHMCS ثيمه الخاص إلى أن تجدّد الترخيص؛ ثم يعود كل شيء.
إزالة AraTheme
- صدّر إعداداتك (Custom CSS & backup → Export)، تحسّبًا لعودتك.
- System Settings → General Settings: اضبط System Theme على
twenty-oneوDefault Order Form Template علىstandard_cart. وتحقّق من مجموعات المنتجات التي كانت تستخدمarahoster_cart. - إذا كنت قد استخدمت تصميم الرسائل البريدية، فانقر Restore في Emails & invoice.
- System Settings → Addon Modules → AraTheme → Deactivate. ألغِ تحديد Keep settings on deactivate أولًا فقط إذا كنت تريد حذف الإعدادات.
- احذف المجلدات
templates/arahosteroneوtemplates/orderforms/arahoster_cartوmodules/addons/arahoster_theme.
