MirrorORG Admin Themes

التثبيت والتفعيل

1. «الإضافات ← أضف إضافة جديدة ← رفع إضافة»، اختار ملف ZIP وثبّت وفعّل.
2. افتح «تصميم اللوحة ← التفعيل والتحديثات» وحط كود الترخيص. من غير كود ساري لوحة التحكم بتفضل بتصميم ووردبريس الأصلي ومفيش أي جزء من التصميم بيشتغل.
3. بعد التفعيل افتح «تصميم اللوحة ← الثيمات والتخصيص»، اختار ثيم ودوس «حفظ التغييرات». اللوحة كلها بتتغيّر فورًا.
4. لو إنت وكالة بتدير الموقع لعميل: من تبويب «الصلاحيات» علّم نفسك «مستخدم وكالة» — هتشوف ووردبريس الأصلي، والعميل يشوف التصميم.

المتطلبات: WordPress 6.2 أو أحدث، PHP 7.4 أو أحدث، وامتداد openssl (التفعيل بيتحقق من توقيع رقمي).

الثيمات الجاهزة

كل ثيم تصميم كامل مش مجرد ألوان: لون الهوية، خلفية الصفحة، شكل القائمة الجانبية (فاتحة، بلون خفيف، داكنة، بلون الهوية)، الشريط العلوي، استدارة الحواف، الظلال، الخط، عرض القائمة والكثافة.

• هادئ (الافتراضي): أزرق هادئ وقائمة بلون خفيف.
• وردي: وردي عميق مع رمادي أردوازي وقائمة بيضاء.
• غابة: أخضر مزرق وقائمة داكنة.
• منتصف الليل: نيلي، قائمة وشريط علوي داكنين، كروت مرفوعة.
• محيط: القائمة بلون الهوية نفسه والشريط العلوي زيها.
• ورق: أبيض وأسود، حواف شبه مستقيمة، بلا ظلال، كثافة عالية وخط النظام.
• رملي: دافئ، لون كهرماني، حواف دائرية واسعة وخط Cairo.
• برقوقي: بنفسجي هادئ بخط IBM Plex Sans Arabic.

كل كارت في معرض الثيمات بيعرض معاينة مصغّرة للوحة بنفس ألوان وشكل الثيم. اختيار ثيم جديد مابيمسحش تخصيصك: أي حقل خصّصته بيفضل فوق الثيم الجديد.

التخصيص والمعاينة المباشرة

تبويب «التخصيص» فيه كل اختيارات الثيم، وكل حقل فاضي بياخد قيمة الثيم. زر ↺ جنب الحقل بيرجّعه لقيمة الثيم.

• الألوان: لون الهوية (الأزرار والروابط)، خلفية الصفحة، لون الكروت، لون النص، ولون القائمة الجانبية.
• الشكل: شكل القائمة الجانبية، الشريط العلوي (فاتح / مثل القائمة / داكن)، الكروت (مسطّحة / بإطار / مرفوعة)، الكثافة، الخط (Tajawal مدمج، وCairo وIBM Plex وAlmarai وNoto Kufi من Google Fonts، أو خط النظام)، الاستدارة من 0 لـ 2، وعرض القائمة من 200 لـ 320 بكسل.

المعاينة جنب الحقول بتتحدّث فورًا بنفس الحسابات اللي بتطبّقها اللوحة. التصميم كله بيتغيّر بعد «حفظ التغييرات».

التباين مضمون: لو اخترت لون هوية فاتح، النص المكتوب بيه (الروابط، العنصر المختار في القائمة) بيتغمّق تلقائيًا لحد ما يبقى مقروء بمعيار WCAG AA، ولون الكتابة على الأزرار بيتختار أبيض أو غامق حسب اللي أوضح.

الهوية والشريط العلوي

• الاسم والسطر تحته: بيظهروا أعلى القائمة الجانبية. فاضي = اسم الموقع و«لوحة إدارة الموقع».
• العلامة: أيقونة، أو الشعار، أو الحروف الأولى من الاسم بلون الهوية.
• الشعار: من مكتبة الوسائط؛ بيُستخدم كمان في صفحة الدخول لو مفيش شعار خاص بيها.
• التذييل: نص خاص (يسمح بالروابط)، وسطر «تصميم وتطوير MirrorORG» بيتقفل ويتفتح، وإخفاء رقم نسخة ووردبريس عن العميل.
• الشريط العلوي: علّم العناصر اللي تختفي (شعار ووردبريس، التعليقات، «+ جديد»، التخصيص…)، وتقدر تكتب معرّفات عناصر تانية سطر لكل واحد. عدّاد التحديثات بيظهر للوكالة بس.

قائمة «خيارات الشاشة / مساعدة» بقت ترس صغير في الشريط العلوي بدل الشريط اللي تحته.

مدير القائمة الجانبية

تبويب «القائمة» بيعرض كل عناصر القائمة زي ما الإضافات سجّلتها:

• الترتيب: اسحب الصف لمكانه (أو Alt + السهم لفوق/لتحت من الكيبورد).
• المكان: «ظاهر» دايمًا، «المزيد» جوّه طيّة في آخر القائمة، «مخفي» مايظهرش للعميل — والرابط نفسه بيفضل شغّال، مافيش صفحة بتتقفل أو تتشال من ووردبريس.
• الأسماء: اسم عربي يظهر لمن لوحته بالعربي، واسم إنجليزي للباقي. فاضي = الاسم الأصلي. عدّادات الطلبات والتعليقات بتفضل جنب الاسم الجديد.
• عناوين الأقسام: «إضافة عنوان قسم» وبعدين اسحبه فوق العناصر اللي تحته.
• الصفحات الفرعية: افتح «الصفحات الفرعية» تحت أي عنصر: إخفاء أو اسم جديد لكل صفحة. لو أول صفحة في القسم اتخفت، أول صفحة ظاهرة بتتقدّم عشان القسم يفتح عليها.
• العناصر الجديدة: اختار مكان العناصر اللي إضافات تتثبّت بعدين هتضيفها (ظاهرة / المزيد / مخفية).

في البحث السريع أعلى القائمة (Ctrl K أو ⌘K) بتلاقي أي قسم أو صفحة فرعية ظاهرة، وبيفهم الكتابة بالعربي من غير همزات.

شاشة إعدادات التصميم نفسها مابتختفيش أبدًا عن اللي مسموح له يديرها.

القوائم كروت وصفحات التعديل

كل جدول في اللوحة (المقالات، الصفحات، المنتجات، الطلبات، المستخدمين، التعليقات، الوسائط في وضع القائمة، التصنيفات، وجداول أي إضافة مبنية على جداول ووردبريس) بيتحوّل لكروت:

• الكارت فيه العنوان، وشارة الحالة (منشور، مسودة، معلّق، مكتمل، منتهي…)، وباقي الأعمدة الظاهرة كسطور «اسم العمود · القيمة»، وأزرار الصف (تعديل، تعديل سريع، حذف…).
• شريط فلتر واحد فوق الكروت بثلاث صفوف: التبويبات (الكل، المنشور…) والبحث؛ ثم «تحديد الكل» والإجراءات الجماعية والفلاتر؛ ثم الترتيب حسب الأعمدة وعدد العناصر والصفحات.
• التعديل السريع والجماعي، الترتيب، الصفحات، وإظهار وإخفاء الأعمدة من «خيارات الشاشة» شغّالين زي ما هم — الجدول نفسه ماتغيّرش، شكله بس.

من تبويب «الشاشات»: أصغر عرض للكارت، إخفاء الخانات الفاضية («—»)، وأزرار الصف تبان دايمًا أو عند المرور بس. وتقدر تقفل أي جزء من التصميم لوحده (إطار القائمة، مدير القائمة، الشريط العلوي، الكروت، صفحات التعديل، التنبيهات، الدخول).

صفحات التعديل والإضافة (المقالات والصفحات والمنتجات، المستخدم والملف الشخصي، التصنيف) بنفس التصميم: حقل عنوان كبير، المحرّر والصناديق كروت، صندوق نشر أوضح، وكل قسم إعدادات في كارت.

محرّر المكوّنات (Gutenberg) وشاشات ووكومرس التفاعلية بتفضل بتصميمها الأصلي.

الرئيسية

تبويب «الرئيسية» بيحدد شكل صفحة لوحة التحكم الرئيسية:

• رئيسية MirrorORG: بتحل محل ودجات ووردبريس. فوق الودجات: وتفضل ودجات الإضافات تحتها. بدون: رئيسية ووردبريس كما هي.
• الأرقام: مع ووكومرس — إيراد الشهر ومقارنته بالشهر اللي فات، طلبات الشهر، الطلبات اللي مستنياك، ومتوسط الطلب (بعملة المتجر، من الطلبات المكتملة وقيد التنفيذ). من غير ووكومرس — المقالات والصفحات والتعليقات المستنية والمستخدمين.
• أحدث الطلبات (أو آخر التعديلات من غير ووكومرس)، رسم الإيراد لآخر ٦ شهور، واختصارات تكتبها بنفسك (فاضية = اختصارات تلقائية).
• كارت الترحيب: عنوان ونص لحد ٣ أزرار.
• كارت الوكالة: نسخة ووردبريس وPHP والتحديثات وحالة الترخيص — للوكالة بس.

الأرقام بتتحسب كل ١٠ دقايق وبتتحدّث فورًا مع أي طلب جديد أو تغيير حالة طلب.

صفحة الدخول

• كارت في المنتصف: هادئ وبسيط.
• مقسوم: لوحة بلون الهوية (أو صورة) جنب النموذج فيها اسم الموقع وسطر تكتبه. على الموبايل بيرجع كارت.
• صورة كاملة: صورة خلفية والنموذج فوقها.

كمان: شعار خاص (فاضي = شعار الهوية) بعرض وارتفاع، عنوان وسطر تحته، لون خلفية، إخفاء اختيار اللغة، وإخفاء رابط «الرجوع للموقع». زر «افتح صفحة الدخول» بيفتحها في تاب جديد.

الوكالة والعميل

مستخدمو الوكالة (تبويب «الصلاحيات»): بيشوفوا ووردبريس الأصلي بكل أدواته وتحديثاته. زر «عرض العميل» في الشريط العلوي بيحوّلهم للتصميم زي ما العميل شايفه بالظبط، وزر «ووردبريس الأصلي» بيرجّعهم. الاختيار بيتحفظ لكل مستخدم.

• «يبدأ مستخدمو الوكالة على»: ووردبريس الأصلي أو عرض العميل.
• «إعدادات التصميم لمستخدمي الوكالة فقط»: باقي المديرين مايشوفوش شاشة الإعدادات. لو مفضلش ولا مستخدم وكالة مدير، أي مدير يقدر يفتحها — فالموقع عمره ما يتقفل. اللي بيحفظ الإعدادات بيتضاف للوكالة تلقائيًا لو القفل شغّال.
• «الأدوار التي ترى التصميم»: فاضي = كل اللي بيدخل لوحة التحكم. لو علّمت أدوار، الباقيين يشوفوا ووردبريس الأصلي.

للعميل: تنبيهات الإضافات الدعائية بتختفي (رسائل الحفظ والأخطاء بتفضل)، وتبويبات «مساعدة» بتاعة ووردبريس بتختفي. للوكالة في «عرض العميل» التنبيهات بتتجمع في درج «تنبيهات الإضافات».

أدوات: CSS، تصدير، استيراد

• CSS إضافي: بيتطبّق بعد التصميم على كل شاشات اللوحة. استخدم متغيرات الثيم زي var(--mxt-accent) وvar(--mxt-panel) وvar(--mxt-radius) عشان الـCSS يتبع أي ثيم.
• تصدير: ملف JSON بكل الإعدادات (من غير مستخدمي الوكالة لأنهم خاصين بالموقع) — لنقل نفس التصميم لموقع تاني.
• استيراد: بيستبدل الإعدادات الحالية بملف تصدير، ومستخدمو الوكالة بيفضلوا زي ما هم.
• إرجاع الافتراضي: كل الإعدادات ترجع للوضع الافتراضي، ومستخدمو الوكالة بيفضلوا.

للمطوّرين

• mxt_themes — إضافة ثيمات جاهزة أو تعديلها.
• mxt_tokens — تعديل أي متغير تصميم بعد حسابه.
• mxt_design_on — إيقاف التصميم لطلب أو مستخدم.
• mxt_screen_kind — إيقاف الكروت أو تصميم صفحات التعديل لشاشة معيّنة (القيمة 'list' أو 'edit' أو '').
• mxt_dashboard_stats وmxt_dashboard_side — أرقام وكروت إضافية في الرئيسية.
• mxt_brand_mark — علامة خاصة بجانب الاسم.

كل الألوان متغيرات CSS بتبدأ بـ --mxt-، والجسم بياخد كلاسات زي mxt-skin وmxt-theme-calm وmxt-side-dark وmxt-cards.

التحديثات

• التحديثات بتوصل من مركز MirrorORG في «الإضافات» و«التحديثات» زي أي إضافة، طول ما الترخيص ساري.
• من «تصميم اللوحة ← التفعيل والتحديثات» تقدر تشوف آخر نسخة متاحة وتفحص يدويًا، وتختار إذا كان التحديث اللي بيوصل من المركز يتثبّت لوحده أو يستنى ضغطة «حدّث دلوقتي» من البنر.
• الإعدادات بتتحفظ في خيار واحد (mxt_settings) ومابتتغيّرش مع التحديث. خد «تصدير» من تبويب «أدوات» قبل أي تغيير كبير لو حابب نسخة احتياطية.
• لو المركز وقع أو الفحص الدوري فشل، الإضافة مابتتقفلش فورًا: الحكم الموقّع معاه مهلة، والقفل بيحصل بعد انتهائها أو لو الكود اتلغى.
• حذف الإضافة من «الإضافات» بيمسح إعداداتها، واللوحة بترجع لتصميم ووردبريس الأصلي.
• 1.0.1: «تحديد الكل» وأزرار الترتيب كانت بتظهر مرتين (في الشريط وتحته) — بقت في الشريط بس؛ مربع «تحديد الكل» بقى بحجمه الطبيعي في شاشات ووكومرس؛ والترتيب وعدد العناصر بقوا في صف لوحدهم أسفل الشريط. مفيش تغيير في الإعدادات.

مشاكل وحلول

• اللوحة لسه بتصميم ووردبريس الأصلي: اتأكد إن الترخيص مفعّل، وإنك مش «مستخدم وكالة» على ووردبريس الأصلي (زر «عرض العميل» في الشريط العلوي)، وإن «التصميم كله» شغّال في تبويب «الشاشات»، وإن دورك من الأدوار اللي ترى التصميم.
• الألوان القديمة لسه ظاهرة بعد الحفظ: ملفات التصميم بتتنسخ برقم مرتبط بتاريخ الملف، فالكاش بيتجدد لوحده؛ لو لسه، امسح كاش المتصفح أو الـCDN.
• عنصر اختفى من القائمة ومحتاجه: رابطه بيفضل شغّال. رجّعه «ظاهر» من تبويب «القائمة»، أو ادخل كوكالة على ووردبريس الأصلي.
• إضافة تانية بتغيّر شكل اللوحة كمان (زي WPShapere أو Admin Menu Editor أو قوالب أدمن تانية): اقفلها — تصميمين للوحة مع بعض بيتعارضوا.
• جدول إضافة شكله غريب ككروت: اقفل الكروت للشاشة دي بالفلتر mxt_screen_kind، أو اقفل «القوائم ككروت» كلها من تبويب «الشاشات».

سجل الإصدارات

هذه التغييرات مأخوذة مباشرة من الإصدارات المنشورة على الـHub.