adminlte laravel
vel 8
حزمة Laravel تقوم بتحويل سقالات Laravel الافتراضية/النموذج المعياري إلى قالب AdminLTE باستخدام Bootstrap 3.0 وPratt Landing Page
انظر العرض هنا:
http://demo.adminlte.acacha.org/
إذا كنت تبحث عن إصدار Laravel 4، فاستخدم الإصدار/العلامة 0.1.5 وراجع OLD-README.md
composer require " acacha/admin-lte-template-laravel "أخيرًا قم بنشر الملفات باستخدام:
php artisan vendor:publish --tag=adminlte --forceتستخدم هذه الحزم (لا حاجة للتثبيت):
brew install gnu-sed --with-default-namesتفترض هذه الحزمة أن لديك مجلد الملحن الخاص بك في المسار:
/YOUR_PATH_TO_HOME/.composer/vendor/bin
على سبيل المثال إضافة هذا السطر:
export PATH= ${PATH} : ~ /.composer/vendor/binإلى ملف ~/.bashrc الخاص بك
ملحوظة: في بعض الأنظمة قد يختلف المسار، على سبيل المثال:
export PATH= ${PATH} : ~ /.config/composer/vendor/binيرجى التأكد من التحقق من البيئة الخاصة بك.
تقوم هذه الحزمة بتثبيت مسارات Laravel التي لن تجدها في ملف Routes.php. يمكن العثور على المسارات المثبتة بواسطة الحزمة في الملف:
https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php
ملف تم تضمينه بواسطة AdminLTETemplateServiceProvider:
https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETemplateServiceProvider.php
يمكنك تجاوز هذه المسارات عن طريق تغيير ترتيب ServiceProviders في ملف config/app.php لذلك إذا قمت بوضع:
App Providers RouteServiceProvider::classبعد
Acacha AdminLTETemplateLaravel Providers AdminLTETemplateServiceProvider::classستتجاوز المسارات الخاصة بك في ملف Routes.php مسارات adminlte-laravel الافتراضية.
كما يمكنك أيضًا تثبيت المسارات يدويًا في ملف Routes.php. يستخدم Adminlte-laravel نفس المسارات التي يستخدمها أمر Laravel make:auth، راجع:
https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub
حتى تتمكن من إضافة هذه السطور إلى ملف Routes.php:
Route:: auth ();
Route:: get ( ' /home ' , ' HomeController@index ' );وقم بتعطيل AdminLTETemplateServiceProvider في ملف config/app.php (ضع في الاعتبار أن واجهات Adminte-laravel والأوامر المخصصة لن تكون متاحة).
راجع العدد رقم 69 لمزيد من المعلومات
بمجرد تثبيت الحزمة، يجب عليك اتباع الخطوات المعتادة لأي مشروع Laravel لتسجيل الدخول إلى واجهة الإدارة:
AdminLTE هو سمة لوحة تحكم إدارية مميزة مجانية تعتمد على Bootstrap 3.x تم إنشاؤها بواسطة عبد الله المساعيد. يرى:
https://github.com/almasaeed2010/AdminLTE
يدعم Adminlte-laravel الصورة الرمزية المعترف بها عالميًا (http://gravatar.com) باستخدام الحزمة Creativeorange/gravatar (https://github.com/creativeorange/gravatar).
تضيف هذه الأوامر طريقة عرض إلى مجلد الموارد/طرق العرض باستخدام تخطيط adminlte الافتراضي:
php artisan make:view aboutيضيف هذا الأمر إدخال قائمة إلى الملف config/menu.php :
php artisan make:menu link menunameمثال:
php artisan make:menu /contactتضيف هذه الأوامر مسارًا إلى ملف المسارات باستخدام:
php artisan make:route linknameعلى سبيل المثال، يمكنك إضافة ملف مسارways /web.php باستخدام URI /about باستخدام:
php artisan make:route aboutتضيف هذه الأوامر هذا الإدخال إلى المسارات/web.php
يمكنك إنشاء 3 أنواع من المسارات مع نوع الخيار:
أمثلة:
php artisan make:route about --type=controllerهذا يضيف ما يلي:
Route:: get ( ' about ' , ' AboutController@index ' );لملف المسارات/web.php . يمكنك اختيار اسم وطريقة وحدة التحكم باستخدام:
php artisan make:route about MyController@method --type=controllerإذا كنت ترغب في إنشاء وحدة تحكم الموارد:
php artisan make:route about --type=resourceهذا يضيف ما يلي:
Route:: resource ( ' about ' , ' About@index ' );لملف المسارات/web.php .
يمكنك أيضًا إنشاء مسارات بطرق HTTP أخرى باستخدام طريقة الخيار:
php artisan make:route save --method=postيمكنك أيضًا إضافة مسارات إلى واجهة برمجة التطبيقات باستخدام خيار API :
php artisan make:route save --apiثم ستتم إضافة المسارات إلى المسارات/api.php .
أخيرًا استخدم الخيار -a لإضافة إجراءات بعد إنشاء المسار:
php artisan make:route about -aيقوم الأمر الأخير أيضًا بإنشاء عرض بالاسم about.blade.php . استخدام:
php artisan make:route about -a --type=controllerسيتم إنشاء ملف وحدة تحكم بالاسم AboutController وفهرس الطريقة.
يمكنك استشارة جميع الخيارات مع:
php artisan make:route --helpتم تنفيذ هذا الأمر بالفعل أثناء التثبيت، ويمكنك (إعادة) تنفيذه يدويًا باستخدام:
php artisan adminlte:publishانشر جميع الملفات الضرورية من الحزمة إلى مشروع Laravel.
قم فقط بنشر الشريط الجانبي للحزمة في مشروع Laravel مما يسمح بتخصيص الشريط الجانبي:
php artisan adminlte:sidebarملاحظة: تم نشر الشريط الجانبي بالفعل عند استخدام أمر تثبيت adminlte-laravel .
يستبدل عرض الشريط الجانبي بشريط جانبي باستخدام قائمة spatie/laravel:
php artisan adminlte:menuيقوم هذا الأمر أيضًا بتثبيت حزمة قائمة spatie/laravel وإنشاء قائمة افتراضية تقع في config/menu.php .
هام : تتطلب قائمة Spatie Laravel PHP7.0 أو أعلى للعمل
ينفذ الأمر make:adminUserSeeder artisan (انظر القسم التالي) وينفذ البذرة. يضيف هذا الأمر مستخدمًا مسؤولًا افتراضيًا إلى قاعدة البيانات.
php artisan adminlte:admin
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
User Sergi Tur Badenas([email protected]) with the environemnt password (env var ADMIN_PWD) created succesfully !يستخدم هذا الأمر (إن وجد) متغيرات البيئة (ملف .env) ADMIN_USER وADMIN_EMAIL وADMIN_PWD. إذا لم تكن متغيرات env هذه موجودة، فقم بتكوين المستخدم git (~/.gitconfig) للحصول على البيانات وإذا لم تكن هذه المعلومات موجودة، فاستخدم Admin ([email protected]) وكلمة المرور 123456 كإعداد افتراضي.
قم بإنشاء بذرة جديدة لإضافة مستخدم مسؤول إلى قاعدة البيانات. يستخدم:
php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php createdمن السهل إضافة (اختياري) دعم تسجيل الدخول/التسجيل الاجتماعي إلى Laravel Adminlte باستخدام حزمة acacha/laravel-social. نفذ في المجلد الجذر لمشروعك:
adminlte-laravel socialاتبع المعالج لتكوين بيانات Oauth الخاصة بمقدمي خدمات التواصل الاجتماعي واستمتع بها!
مزيد من المعلومات على https://github.com/acacha/laravel-social.
إزالة الخط
@ include ( ' auth.partials.social_login ' ) في الملفات resources/views/auth/login.blade.php و register.blade.php
https://packagist.org/packages/acacha/admin-lte-template-laravel
http://acacha.org/mediawiki/AdminLTE#adminlte-laravel
استخدم phpunit عند تشغيل اختبار البرنامج النصي للملحن:
$ composer testبمجرد تثبيت هذه الحزمة في مشروع Laravel، يتم تثبيت بعض الاختبارات لاختبار ميزات الحزمة. هناك نوعان من الاختبارات: اختبارات الميزات/الوحدة واختبارات المتصفح. لتنفيذ اختبارات الميزة/الوحدة، قم بتنفيذ ما يلي:
./vendor/bin/phpunit
في مشروع laravel الذي تم إنشاؤه حديثًا مع تثبيت acacha-admintle.laravel لاختبار تثبيت الحزمة بشكل صحيح. يمكنك أيضًا تنفيذ اختبارات المتصفح باستخدام Laravel Dusk (يُرجى تثبيت حزمة Dusk يدويًا أولاً باتباع https://laravel.com/docs/master/dusk):
php artisan dusk:install
touch database/testing.database.sqlite
php artisan serve --env=dusk.local &
php artisan dusk
يمكنك أيضًا اختبار هذه الحزمة في وضع الحماية دون الحاجة إلى التثبيت. تشغيل البرنامج النصي:
./test.shتتم ترجمة جميع السلاسل باستخدام دعم الترجمة Laravel: https://laravel.com/docs/master/localization
في ملف config/app.php الخاص بك، يمكنك تغيير الإعدادات المحلية لتغيير اللغة. يمكنك تثبيت الملفات المترجمة فقط باستخدام العلامة adminlte_lang:
php artisan vendor:publish --tag=adminlte_lang --forceيتم دعم اللغات التالية افتراضيًا في هذه الحزمة: الإنجليزية والكتالونية والإسبانية والهولندية والبرتغالية البرازيلية. لا تتردد في إرسال طلب سحب جديد بلغات أخرى إذا كنت ترغب في ذلك.
ملاحظة: غير مطلوب في Laravel 5.5+
يحتاج Acacha llum إلى GNU sed ليعمل لذا استبدل BSD sed بـ GNU sed باستخدام:
brew install gnu-sed --with-default-namesتحقق من إصدار sed باستخدام:
man sedمسار إصدار sed GNU هو:
$ which sed
/usr/local/bin/sedبدلاً من المسار الافتراضي لـ BSD sed (المثبت افتراضيًا على نظام التشغيل MAC OS):
/usr/bin/sedمزيد من المعلومات في رقم 58
تنفيذ الأمر:
php artisan adminlte:username
وبعد ذلك يمكنك استخدام اسم المستخدم بدلاً من البريد الإلكتروني لتسجيل الدخول.
ملاحظة: عندما نستخدم تسجيل الدخول بواسطة اسم المستخدم إذا فشل تسجيل الدخول بواسطة أسماء المستخدمين، فسيحاول النظام استخدام اسم المستخدم المقدم كبريد إلكتروني لتسجيل الدخول. بحيث يمكن للمستخدمين أيضًا تسجيل الدخول باستخدام البريد الإلكتروني.
للعودة إلى تسجيل الدخول عبر البريد الإلكتروني، قم بإزالة خيار إزالة الحقل من ملف config/auth.php :
' providers ' = > [
' users ' => [
' driver ' => ' eloquent ' ,
' model ' => App U ser::class,
' field ' => ' username ' // Adminlte laravel. Valid values: ' email ' or ' username '
],ملاحظة: الترحيل المطلوب لإضافة حقل اسم المستخدم إلى جدول المستخدمين يتطلب ما يلي:
composer require doctrine/dbalاختياريًا، يمكنك تحديد اسم المجال الافتراضي لتسجيل الدخول باسم المستخدم. إضافة خيار المجال:
' defaults ' => [
' guard ' => ' web ' ,
' passwords ' => ' users ' ,
' domain ' => ' defaultdomain.com ' ,
],لملف config/auth.php . ثم إذا حاول المستخدم تسجيل الدخول بدون مجال، فسيتم إلحاق المجال الافتراضي عند التسجيل.
لذلك مع المثال السابق يمكنك الكتابة عند تسجيل الدخول:
sergiturbadenas
وسيستبدل النظام/جافا سكريبت ذلك بـ:
تقوم حزمة Laravel adminlte افتراضيًا بنشر ترجمات Laravel إلى Javascript/Vue.js مع إضافة النص التالي إلى رأس HTML:
< script >
//See https://laracasts.com/discuss/channels/vue/use-trans-in-vuejs
window.trans = @php
// copy all translations from /resources/lang/CURRENT_LOCALE/* to global JS variable
$lang_files = File::files(resource_path() . '/lang/' . App::getLocale());
$trans = [];
foreach ($lang_files as $f) {
$filename = pathinfo ( $f ) [ 'filename' ] ;
$trans [ $filename ] = trans ( $filename ) ;
}
$trans['adminlte_lang_message'] = trans('adminlte_lang::message');
echo json_encode($trans);
@endphp
</ script >يوجد هذا البرنامج النصي في ملف نصي جزئي (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)
لذا فإن المتغير العام window.trans يحتوي على جميع ترجمات Laravel التي يمكن استخدامها في أي ملف Javascript.
يوجد أيضًا في قسم التعليمات البرمجية لموارد الملف/الأصول/js/bootstrap.js :
Vue.prototype.trans = (key) => {
return _.get(window.trans, key, key);
};
يسمح باستخدام وظيفة trans مباشرة في قوالب vue:
{{ trans('auth.failed') }}
كما يمكنك استخدام رمز مكونات Vue داخل:
this.trans('auth.failed')
تتوفر رسائل Laravel Adminlte باستخدام البادئة adminlte_lang_message :
{{ trans('adminlte_lang_message.username') }}
لا تتردد في إزالة/تكييف هذا الملف حسب احتياجاتك.
الرجاء مراجعة سجل التغيير لمزيد من المعلومات عما تغير مؤخرًا.
يرجى الاطلاع على المساهمة والسلوك للحصول على التفاصيل.
إذا اكتشفت أي مشكلات متعلقة بالأمان، فيرجى إرسال بريد إلكتروني إلى [email protected] بدلاً من استخدام أداة تعقب المشكلات.
رخصة معهد ماساتشوستس للتكنولوجيا (MIT). يرجى الاطلاع على ملف الترخيص لمزيد من المعلومات.
https://github.com/acacha/adminlte-laravel-installer
