Пакет Laravel, который переключает стандартные шаблоны/шаблоны Laravel на шаблон AdminLTE с помощью Bootstrap 3.0 и целевой страницы Pratt.
Смотрите демо здесь:
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 по умолчанию.
Также вы можете вручную установить маршруты в файле маршруты.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).
Эта команда добавляет представление в папку ресурсов/представлений, используя макет администрирования по умолчанию:
php artisan make:view about
Эта команда добавляет пункт меню в файл config/menu.php :
php artisan make:menu link menuname
Пример:
php artisan make:menu /contact
Эта команда добавляет маршрут в файл маршрутов, используя:
php artisan make:route linkname
Например, вы можете добавить файл маршрута маршруты/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, используя метод option:
php artisan make:route save --method=post
Вы также можете добавить маршруты в API, используя опцию 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-menu:
php artisan adminlte:menu
Эта команда также устанавливает пакет spatie/laravel-menu и создает меню по умолчанию, расположенное в config/menu.php .
ВАЖНО : для работы Spatie Laravel Menu требуется PHP 7.0 или более поздняя версия.
Выполняет ремесленную команду make:adminUserSeeder (см. следующий раздел) и выполняет начальное значение. Эта команда добавляет в базу данных пользователя-администратора по умолчанию.
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 config (~/.gitconfig) для получения данных, а если эта информация не существует, используйте администратора ([email protected]) и пароль 123456 по умолчанию.
Создайте новое начальное число, чтобы добавить пользователя-администратора в базу данных. Использовать:
php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
Добавить (необязательно) поддержку входа/регистрации через социальные сети в администрацию Laravel с помощью пакета 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
и system/javascript заменит это на:
Пакет администрирования Laravel по умолчанию публикует переводы 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.
Также в разделе кода файла resources/assets/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_lang_message :
{{ trans('adminlte_lang_message.username') }}
Не стесняйтесь удалить/адаптировать этот файл под свои нужды.
Пожалуйста, посетите CHANGELOG для получения дополнительной информации о том, что изменилось за последнее время.
Подробную информацию см. в разделах ВКЛАД и ПОВЕДЕНИЕ.
Если вы обнаружите какие-либо проблемы, связанные с безопасностью, отправьте электронное письмо по адресу [email protected] вместо использования системы отслеживания проблем.
Лицензия MIT (MIT). Дополнительную информацию см. в файле лицензии.
https://github.com/acacha/adminlte-laravel-installer