منصوبے کے بارے میں
AdminLTE ایک اوپن سورس ایڈمن ڈیش بورڈ UI ٹیمپلیٹ ہے جسے AdminLTE.io کی جانب سے MIT لائسنس کے تحت تقسیم کیا گیا ہے۔ یہ ریپوزٹری HTML/Bootstrap کور ایڈیشن ہے؛ یہی ڈیزائن دیگر اسٹیکس کے لیے الگ الگ ریپوزٹریز کے طور پر بھی برقرار رکھا گیا ہے۔
ٹیکنالوجی اور لے آؤٹ
- Bootstrap 5.3 اور vanilla JavaScript پر مبنی ہے، v4 میں jQuery پر انحصار نہیں ہے۔
- ریسپانسیو لے آؤٹ جو چھوٹے موبائل اسکرینز سے لے کر بڑے ڈیسک ٹاپس تک فٹ ہونے کے لیے بنائے گئے ہیں۔
- ڈارک موڈ کے لیے کسٹم باڈی کلاس کے بجائے Bootstrap 5.3 کی نیٹیو data-bs-theme ایٹریبیوٹ استعمال کرتا ہے۔
- RTL سپورٹ، اور اختیاری کلر اسٹائل شیٹس: dist/css/adminlte-colors.css (ری ڈیزائن شدہ رنگ، سفید متن کی پڑھنے کی صلاحیت، 17 اسکن پری سیٹس، اور برانڈنگ کے لیے data-lte-primary ہک) یا dist/css/adminlte-colors-v3.css، جو AdminLTE 3 کے 18 رنگوں کو برقرار رکھتا ہے۔ adminlte.css میں کچھ بھی شامل نہیں کیا گیا ہے۔
انسٹالیشن اور ڈویلپمنٹ
- CDN: jsDelivr سے admin-lte@4 CSS اور JS لنک کریں، کسی بلڈ اسٹیپ کی ضرورت نہیں۔
- npm: npm install admin-lte@4.
- Composer: composer require almasaeed2010/adminlte.
- AdminLTE پر کام کرنا: npm install کریں، پھر لائیو رিলোڈ کے ساتھ پورٹ 3000 پر ڈویلپمنٹ سرور کے لیے npm start چلائیں؛ ڈویلپمنٹ اثاثوں کے لیے npm run build؛ اور مکمل لنٹ، آپٹیمائز اور بنڈل واچ پائپ لائن کے لیے npm run production استعمال کریں۔ الگ سے npm run css، npm run js، اور npm run lint ٹاسکس کی دستاویزات موجود ہیں۔
v4 میں تبدیلیاں
README میں v4 لائن کو Bootstrap 5.3 پر jQuery کے بغیر مکمل طور پر نئے سرے سے لکھا گیا بتایا گیا ہے۔ اس میں 18 ڈیمو صفحات شامل کیے گئے ہیں اور دستاویزات کو دوبارہ ترتیب دیا گیا ہے۔ ڈیمو صفحات میں ایپس (FullCalendar کے ساتھ کیلنڈر، SortableJS کے ساتھ کانبان، چیٹ، فائل مینیجر، پروجیکٹس، میل باکس ان باکس/ریڈ/کمپوز)، فارمز (ویلیڈیشن کے ساتھ چار مرحلہ وار وزارڈ)، ٹیبلز (Tabulator پر مبنی ڈیٹا ٹیبلز، jQuery سے پاک)، صفحات (پروفائل، سیٹنگز، انوائس، پرائسنگ، FAQ) اور ایرر صفحات (404، 500، مینٹیننس) شامل ہیں۔
4.3 ریلیز نوٹس میں SidebarSearch پلگ ان کا ذکر ہے جو ٹائپنگ کے دوران سائیڈ بار مینو کو فلٹر کرتا ہے، متعلقہ سب مینو کو پھیلاتا ہے، اور کلیئر کرنے پر مینو کو بحال کرتا ہے؛ تین سائزوں میں ربن کارنر بینرز جو RTL میں عکس بناتے ہیں؛ سوشل اور پوسٹ وجٹس (.user-block, .post, .widget-user, .widget-user-2, .description-block)؛ اور تین نئے ڈیمو صفحات (گیلری، سرچ رزلٹس، ربنز) شامل ہیں۔ جنرل UI شوکیس میں نیو ٹیبز، موڈلز اور آف کینوس شامل کیے گئے، اور دستاویزات میں کارڈ، متفرق اور لینگویج سوئچر صفحات شامل کیے گئے تاکہ ہر کمپوننٹ جس کی 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" اور ٹری ویو کے لیے بھی اسی طرح؛ ڈارک موڈ کا data-bs-theme پر منتقل ہونا۔ بنڈل شدہ plugins/ فولڈر کو ہٹا دیا گیا ہے، اور ایک متبادل ٹیبل ہر v3 jQuery وجٹ کو vanilla-JS جانشین سے جوڑتا ہے (مثال کے طور پر Select2 کو Tom Select، DataTables کو Tabulator، Summernote کو Quill)۔
فریم ورک ایڈیشنز
الگ الگ ریپوزٹریز اسی ڈیش بورڈ کو React اور Next.js، Vue 3 اور Nuxt، Laravel (Blade components، config-driven menu، auth scaffolding)، Django (reusable app، menu filter pipeline، themed admin)، Symfony (Twig components، AssetMapper، EasyAdmin theme)، Angular، ASP.NET Core (Blazor components پلس MVC/Razor Pages tag helpers) اور Drupal کے لیے مربوط کرتی ہیں۔ ہر ایک کو اس کے اپنے پیکیج مینیجر انٹری پوائنٹ کے ذریعے انسٹال کیا جاتا ہے۔
ڈیپلائمنٹ اور سیکیورٹی
AdminLTE ایک UI ٹیمپلیٹ ہے: پروڈکشن ڈیپلائمنٹ میں صرف کمپائل شدہ dist اثاثے اور ایپلی کیشن فائلیں بھیجنی چاہئیں، کبھی بھی node_modules، ڈیمو HTML صفحات یا src/ نہیں بھیجنا چاہیے۔ README میں بتایا گیا ہے کہ CVE-2021-36471 متنازع ہے اور یہ ان ڈیمو صفحات کے قابل رسائی ہونے سے متعلق ہے جب مثال فائلیں غلط طریقے سے ڈیپلائے کی جاتی ہیں، اور SECURITY.md میں تصدیق اور بہترین طریقوں پر تفصیلی رہنمائی موجود ہے۔
براؤزر سپورٹ، تعاون اور لائسنسنگ
Bootstrap 5.3 کروم، فائر فاکس، سفاری اور ایج کے موجودہ ورژنز کو سپورٹ کرتا ہے، اور بلڈ اسکرپٹس کو ونڈوز، میک او ایس اور لینکس پر کراس پلیٹ فارم بتایا گیا ہے۔ تعاون master برانچ کے لیے ہے: Node.js LTS انسٹال کریں، npm install اور npm start چلائیں، کمٹ کرنے سے پہلے لنٹ کریں، اور پل ریکویسٹ کھولیں۔ یہ پروجیکٹ MIT لائسنس شدہ ہے، اور README میں مفت ایڈیشن کے ساتھ ساتھ پریمیم ٹیمپلیٹس اور GitHub Sponsors یا PayPal عطیات کے اختیارات کی نشاندہی بھی کی گئی ہے۔
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.