توثيق ثيم تقنكس للواجهة الخلفية

ما الذي تحصل عليه

إذا كنت تستضيف أودو بنفسك

1. فُكَّ ضغط الحزمة التي نزّلتها. بداخلها الملف taqnix_backend_theme.zip. فُكَّ ضغطه فتحصل على مجلد باسم taqnix_backend_theme.
2. انسخ هذا المجلد إلى أحد addons paths في أودو (المجلدات المدرجة في addons_path داخل ملف odoo.conf)، مثل /opt/odoo/custom-addons/.
3. أعد تشغيل أودو حتى يتعرف على الوحدة الجديدة.
4. سجّل الدخول كمدير، وفعّل Developer mode (الوضع المطوّر) من Settings → Activate the developer mode، ثم افتح Apps (التطبيقات) واضغط Update Apps List وأكّد.
5. أزل عامل التصفية «Apps» من مربع البحث، وابحث عن Taqnix Backend Theme ثم اضغط Install.
6. تُعاد تحميل الصفحة وتظهر الواجهة الخلفية بالمظهر الجديد.

من سطر الأوامر

# install (or update) the module in your database
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_backend_theme --stop-after-init
./odoo-bin -c odoo.conf -d YOUR_DATABASE -u taqnix_backend_theme --stop-after-init   # after a new version

Docker وOdoo.sh وغيرهما

ضع المجلد taqnix_backend_theme في المسار الذي تربطه أو تنشره كإضافات مخصصة، ثم أعد التشغيل وحدّث قائمة التطبيقات وثبّت كما سبق. في Odoo.sh: أضف المجلد إلى المستودع وادفعه (push).

1. افتحه في أي وقت بالضغط على Alt+H أو بالنقر على أيقونة الشبكة في أعلى اليسار. يغلقه الضغط على Esc.
2. اكتب بضعة أحرف: يُبحث في التطبيقات وعناصر القوائم معًا، ويظهر المسار تحت كل نتيجة (مثل Sales / Configuration).
3. تنقّل بمفاتيح الأسهم واضغط Enter. النقر مع Ctrl (أو Cmd) يفتح التطبيق في تبويب جديد.

الشريط الجانبي

داخل أي تطبيق، يتيح لك شريط جانبي نحيف على اليسار التنقل بين التطبيقات بنقرة واحدة. يوسّعه الزر ذو الخطوط الثلاثة في أعلاه ليعرض الأسماء، ويتذكر أودو اختيارك على ذلك الحاسوب.

الشريط العلوي فقط

هل تفضّل التخطيط الكلاسيكي؟ اختر Top bar only في Theme Studio أو في Settings → Theme فيختفي الشريط الجانبي.

1. انقر أيقونة الشمس أو القمر في الشريط العلوي.
2. اختر Light أو Dark أو Follow device ضمن Appearance. يُطبَّق الاختيار فورًا ويُحفظ لمستخدمك.
3. على الهاتف، افتح More في الشريط السفلي لتجد المفتاح نفسه.

إنه وضع داكن حقيقي وليس مرشّح ألوان. يوفّر الثيم لوحة الألوان الداكنة التي تتوقعها أنماط أودو الداكنة نفسها، فتظهر الوحدات التي تأتي بأنماط داكنة بالشكل الصحيح أيضًا.

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

الافتراضي للشركة

يحدد المديرون ما يبدأ به المستخدمون الجدد من Settings → Theme → Default appearance (Light أو Dark أو Follow device). ومن اختار لنفسه يحتفظ باختياره.

1. انقر أيقونة الشمس أو القمر في الشريط العلوي واختر Customize theme (للمديرين فقط).
2. اختر لوحة ألوان جاهزة، أو اضبط الألوان بنفسك.
3. انظر إلى الواجهة الخلفية خلف اللوحة: فهي تعرض اختيارك بالفعل.
4. اضغط Save theme لتطبيقه على الجميع في هذه الشركة، أو Discard للتراجع.

لوحات الألوان

17 لوحة ألوان جاهزة: Taqnix Violet وOdoo Aubergine وDeep Ocean وForest وNord وMidnight Teal وGraphite Lime وRoyal Gold وSlate Ruby وCarbon Orange وRose Mocha وEmerald City وCorporate Grey وSandstone وCherry Blossom وDracula وHigh Contrast. تحدد اللوحة اللونين ونمط التنقل، ويمكنك بعد ذلك ضبط أي منها بدقة.

كل ما يمكنك ضبطه

الشكل والكثافة

خلفيات المشغّل

• Palette preset يملأ لك الألوان ونمط التنقل.
• المديرون فقط يرون هذه الصفحة والعنصر Customize theme.
• اضغط Save في الأعلى، كما في أي صفحة إعدادات في أودو.

تُخزَّن الألوان ونمط التنقل والخطوط والخلفية والمظهر الافتراضي لكل شركة. يمكن لكل شركة أن تكون لها علامتها الخاصة. يعتمد الثيم المعروض على الشركة النشطة في مبدّل الشركات أعلى اليمين. تُطبَّق التغييرات دون إعادة بناء الأصول (assets) ودون وميض الألوان القديمة.

• يتنحّى الشريط جانبًا أثناء الكتابة وفي الشاشات التي تأتي بشريطها الخاص، مثل Discuss.
• تحصل الهواتف ذات الحواف المقطوعة (notch) على هوامش آمنة، ويأخذ شريط أدوات المتصفح لون الشريط العلوي.
• لا تُمرَّر النماذج وحقول HTML أفقيًا أبدًا.
• يمكنك إيقاف الشريط السفلي من Studio أو من Settings → Theme.

غيّر لغة المستخدم إلى العربية أو العبرية أو الفارسية فتنعكس الواجهة كلها: ينتقل الشريط الجانبي إلى اليمين، وتنقلب القوائم وأعمدة كانبان والنماذج. وتشمل الخطوط المتاحة Cairo وTajawal وIBM Plex Sans Arabic.

ما الذي تضيفه الوحدة

متغيرات CSS

يضبط الثيم وقت التشغيل رموز تصميم (design tokens) على :root يمكنك استخدامها أو تجاوزها في وحدتك:

:root {
  --tx-primary: #6B3FE0;        /* brand color                      */
  --tx-primary-hover: ...;       /* hover / active shades            */
  --tx-secondary: #14B8A6;      /* sidebar highlight, badges        */
  --tx-on-primary: #fff;        /* readable text on the brand color */
}

/* in your own module's scss */
.my-card { border-color: var(--tx-primary-subtle-border); }

قراءة الألوان من تطبيق آخر

تُرجع نقطة نهاية عامة ألوان العلامة للشركة الحالية، وهي مفيدة لتطبيق جوال مرافق (تُرجع بيانات العلامة العامة فقط):

curl https://your-odoo.example.com/api/taqnix/theme_colors

تغيير ثيم شركة من الكود

company = env.company
company.write({
    'tx_primary_color': '#0B6BCB',
    'tx_secondary_color': '#38BDF8',
    'tx_nav_style': 'midnight',
    'tx_default_scheme': 'dark',
})

تُطبَّق الإعدادات عند تحميل الصفحة التالية؛ ولا حاجة إلى إعادة بناء الأصول.

التحديث

استبدل مجلد الوحدة بالمجلد الجديد، وأعد تشغيل أودو ونفّذ -u taqnix_backend_theme (أو اضغط Upgrade على الوحدة في Apps). ثم نفّذ تحديثًا كاملًا للصفحة في المتصفح. تبقى ألوانك واختيارات المظهر عند المستخدمين.

القادم من الإصدار 1

كان الإصدار 1 يخزّن ألوانه كمعاملات نظام. عند التثبيت تنسخها الوحدة (اللون الأساسي ولون التمييز ولون التنقل) تلقائيًا إلى كل شركة.

الإزالة

أزل تثبيت Taqnix Backend Theme من Apps. يعود مظهر أودو القياسي فورًا. ويتوقف الوضع الداكن معه، لأن نسخة Community من أودو لا تفعّله إلا عبر هذه الوحدة.

المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر، مع تحديثات مدى الحياة. تواصل معنا عبر صفحة العنصر في السوق التي اشتريت منها الوحدة، أو راسل support@taqnix.com مع ذكر إصدار أودو وما فعلته ولقطة شاشة لما تراه.