عن المشروع

AdminLTE هو قالب واجهة مستخدم مفتوح المصدر للوحات التحكم الإدارية يتم توزيعه بموجب ترخيص MIT من قبل AdminLTE.io. يمثل هذا المستودع إصدار HTML/Bootstrap الأساسي، بينما يتم صيانة نفس التصميم في مستودعات منفصلة لبيئات عمل أخرى. التكنولوجيا والتخطيط - مبني على Bootstrap 5.3 وJavaScript الخام، بدون الاعتماد على jQuery في الإصدار v4. - تخطيطات متجاوبة مصممة لتناسب الشاشات الصغيرة للهواتف المحمولة وصولاً إلى أجهزة الكمبيوتر المكتبية الكبيرة. - يستخدم الوضع الداكن سمة data-bs-theme الأصلية في Bootstrap 5.3 بدلاً من فئة body مخصصة. - دعم RTL (من اليمين إلى اليسار)، بالإضافة إلى أوراق أنماط ألوان اختيارية: dist/css/adminlte-colors.css (ألوان معاد تصميمها، نصوص بيضاء مقروءة، 17 إعداداً مسبقاً للمظهر، وخطاف data-lte-primary للعلامة التجارية) أو dist/css/adminlte-colors-v3.css التي تحافظ على ألوان AdminLTE 3 الثمانية عشر كما كانت. لا يتم إضافة أي شيء إلى adminlte.css. التثبيت والتطوير - CDN: ربط CSS وJS الخاص بـ admin-lte@4 من jsDelivr، دون الحاجة لخطوة بناء. - npm: تنفيذ الأمر npm install admin-lte@4. - Composer: تنفيذ الأمر composer require almasaeed2010/adminlte. - العمل على AdminLTE نفسه: تنفيذ npm install، ثم npm start لخادم تطوير على المنفذ 3000 مع تحديث مباشر؛ npm run build لأصول التطوير؛ npm run production لعملية الفحص (lint) والتحسين والربط الكاملة. كما تتوفر مهام منفصلة مثل npm run css وnpm run js وnpm run lint موثقة. تغييرات الإصدار v4 يوصف خط الإصدار v4 في ملف README بأنه إعادة كتابة شاملة بناءً على Bootstrap 5.3 بدون jQuery. يضيف 18 صفحة تجريبية ويعيد صياغة التوثيق. تغطي الصفحات التجريبية التطبيقات (التقويم مع FullCalendar، وKanban مع SortableJS، والدردشة، ومدير الملفات، والمشاريع، وصندوق البريد)، والنماذج (معالج من أربع خطوات مع التحقق من الصحة)، والجداول (جداول بيانات تعتمد على Tabulator، بدون jQuery)، والصفحات (الملف الشخصي، الإعدادات، الفاتورة، التسعير، والأسئلة الشائعة) وصفحات الخطأ (404، 500، والصيانة). تذكر ملاحظات الإصدار 4.3 إضافة إضافة SidebarSearch التي تقوم بتصفية قائمة الشريط الجانبي أثناء الكتابة، وتوسيع أي قائمة فرعية تحتوي على تطابق، واستعادة القائمة عند المسح؛ ولافتات زاوية (ribbon) بثلاثة أحجام تدعم RTL؛ وأدوات اجتماعية ومنشورات (.user-block, .post, .widget-user, .widget-user-2, .description-block)؛ وثلاث صفحات تجريبية جديدة (المعرض، نتائج البحث، والشرائط). كما تمت إضافة علامات تبويب التنقل، والنوافذ المنبثقة (modals)، والـ offcanvas إلى عرض الواجهة العام، واكتسب التوثيق صفحات للبطاقات والمتنوعات ومبدل اللغة بحيث يكون لكل مكون CSS صفحة مرجعية. الانتقال من الإصدار v3 يسرد ملف README التغييرات الجوهرية: إعادة تسمية الفئات مثل .wrapper إلى .app-wrapper، و.main-header إلى .app-header، و.main-sidebar إلى .app-sidebar، و.content-wrapper إلى .app-main؛ وتغييرات في سمات البيانات مثل data-toggle إلى data-bs-toggle، وdata-widget="pushmenu" إلى data-lte-toggle="sidebar" وما يعادلها لـ treeview؛ وانتقال الوضع الداكن إلى data-bs-theme. تم إزالة مجلد plugins/ المدمج، واستبداله بجدول يربط كل أداة jQuery في v3 ببديل يعمل بـ vanilla-JS (على سبيل المثال Select2 إلى Tom Select، وDataTables إلى Tabulator، وSummernote إلى Quill). إصدارات أطر العمل تدمج مستودعات منفصلة نفس لوحة التحكم لـ React وNext.js، وVue 3 وNuxt، وLaravel (مكونات Blade، قائمة مدفوعة بالتكوين، وهيكل مصادقة)، وDjango (تطبيق قابل لإعادة الاستخدام، خط أنابيب تصفية القائمة، ولوحة تحكم ذات مظهر مخصص)، وSymfony (مكونات Twig، وAssetMapper، ومظهر EasyAdmin)، وAngular، وASP.NET Core (مكونات Blazor بالإضافة إلى مساعدات علامات MVC/Razor Pages) وDrupal. يتم تثبيت كل منها من خلال نقطة دخول مدير الحزم الخاص به. النشر والأمان AdminLTE هو قالب واجهة مستخدم: يجب أن تشمل عمليات النشر الإنتاجية فقط أصول dist المجمعة وملفات التطبيق، ولا يجب شحن node_modules أو صفحات HTML التجريبية أو src/ أبداً. يذكر ملف README أن الثغرة CVE-2021-36471 متنازع عليها وتشير إلى إمكانية الوصول إلى الصفحات التجريبية عند نشر ملفات الأمثلة بشكل خاطئ، وأن ملف SECURITY.md يحتوي على إرشادات مفصلة حول المصادقة وأفضل الممارسات. دعم المتصفحات، المساهمة والترخيص يدعم Bootstrap 5.3 الإصدارات الحالية من Chrome وFirefox وSafari وEdge، وتوصف سكربتات البناء بأنها متوافقة مع أنظمة Windows وmacOS وLinux. تستهدف المساهمات فرع master: تثبيت Node.js LTS، وتشغيل npm install وnpm start، وإجراء lint قبل الالتزام (commit)، وفتح طلب سحب (pull request). المشروع مرخص بموجب MIT، ويشير ملف README أيضاً إلى القوالب المميزة وخيارات التبرع عبر GitHub Sponsors أو PayPal إلى جانب الإصدار المجاني.