Un paquete de Laravel que cambia el andamio/repetitivo predeterminado de Laravel a la plantilla AdminLTE con Bootstrap 3.0 y Pratt Landing Page
Ver demostración aquí:
http://demo.adminlte.acacha.org/
Si está buscando la versión Laravel 4, use la versión/etiqueta 0.1.5 y consulte OLD-README.md
composer require " acacha/admin-lte-template-laravel "
Finalmente publicar archivos con:
php artisan vendor:publish --tag=adminlte --force
Estos paquetes utilizan (no es necesario instalar):
brew install gnu-sed --with-default-names
Este paquete supone que tienes en la ruta la carpeta bin del compositor:
/YOUR_PATH_TO_HOME/.composer/vendor/bin
Por ejemplo agregando esta línea:
export PATH= ${PATH} : ~ /.composer/vendor/bin
a su archivo ~/.bashrc
Nota: en algunos sistemas la ruta puede ser diferente, por ejemplo:
export PATH= ${PATH} : ~ /.config/composer/vendor/bin
Asegúrese de comprobar su entorno.
Este paquete instala rutas Laravel que no las encontrará en el archivo route.php. Las rutas instaladas por paquete se encontrarían en el archivo:
https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php
Un archivo incluido por AdminLTETemplateServiceProvider:
https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETemplateServiceProvider.php
Puede anular estas rutas cambiando el orden de los proveedores de servicios en el archivo config/app.php, por lo que si coloca:
App Providers RouteServiceProvider::class
Después
Acacha AdminLTETemplateLaravel Providers AdminLTETemplateServiceProvider::class
Sus rutas en el archivo route.php anularán las rutas predeterminadas de adminlte-laravel.
También puede instalar manualmente las rutas en el archivo route.php. Adminlte-laravel usa las mismas rutas que Laravel make:auth usa el comando, consulte:
https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub
para que puedas agregar estas líneas al archivo route.php:
Route:: auth ();
Route:: get ( ' /home ' , ' HomeController@index ' );
Y deshabilite AdminLTETemplateServiceProvider en el archivo config/app.php (tenga en cuenta que Adminte-laravel Facades y los comandos personalizados no estarán disponibles).
Consulte el número 69 para obtener más información.
Una vez instalado el paquete, debe seguir los pasos habituales de cualquier proyecto de Laravel para iniciar sesión en la interfaz de administración:
AdminLTE es un tema de panel de control de administración premium gratuito basado en Bootstrap 3.x creado por Abdullah Almsaeed. Ver:
https://github.com/almasaeed2010/AdminLTE
Adminlte-laravel admite avatar reconocido globalmente (http://gravatar.com) utilizando el paquete creativeorange/gravatar (https://github.com/creativeorange/gravatar).
Este comando agrega una vista a la carpeta recursos/vistas usando el diseño administrativo predeterminado:
php artisan make:view about
Este comando agrega una entrada de menú al archivo config/menu.php :
php artisan make:menu link menuname
Ejemplo:
php artisan make:menu /contact
Este comando agrega una ruta al archivo de rutas usando:
php artisan make:route linkname
Por ejemplo, puede agregar un archivo de ruta route /web.php con URI /about usando:
php artisan make:route about
Estos comandos agregan esta entrada a rutas/web.php
Puedes crear 3 tipos de rutas con el tipo de opción:
Ejemplos:
php artisan make:route about --type=controller
esto agrega lo siguiente:
Route:: get ( ' about ' , ' AboutController@index ' );
al archivo rutas/web.php . Puede elegir el nombre y el método del controlador con:
php artisan make:route about MyController@method --type=controller
Si desea crear un controlador de recursos:
php artisan make:route about --type=resource
esto agrega lo siguiente:
Route:: resource ( ' about ' , ' About@index ' );
al archivo rutas/web.php .
También puedes crear rutas con otros métodos HTTP usando el método de opción:
php artisan make:route save --method=post
También puedes agregar rutas a la API usando la opción API :
php artisan make:route save --api
Luego las rutas se agregarán a route/api.php .
Finalmente use la opción -a para agregar acciones después de la creación de la ruta:
php artisan make:route about -a
El último comando también crea una vista con el nombre about.blade.php . Usando:
php artisan make:route about -a --type=controller
Creará un archivo de controlador con el nombre AboutController y el índice del método.
Puedes consultar todas las opciones con:
php artisan make:route --help
Este comando ya se ejecuta durante la instalación; puede (re)ejecutarlo manualmente con:
php artisan adminlte:publish
Publique todos los archivos necesarios del paquete al proyecto Laravel.
Publicar solo la barra lateral del paquete en el proyecto Laravel permitiendo personalizar la barra lateral:
php artisan adminlte:sidebar
Nota: la barra lateral ya está publicada cuando usa el comando de instalación adminlte-laravel .
Reemplaza la vista de la barra lateral con una barra lateral usando spatie/laravel-menu:
php artisan adminlte:menu
Este comando también instala el paquete spatie/laravel-menu y crea un menú predeterminado ubicado en config/menu.php .
IMPORTANTE : El menú Spatie Laravel requiere PHP7.0 o superior para funcionar
Ejecuta el comando artesanal make:adminUserSeeder (consulte la siguiente sección) y ejecuta seed. Este comando agrega un usuario administrador predeterminado a la base de datos.
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 !
Este comando utiliza (si existe) variables de entorno (archivo .env) ADMIN_USER, ADMIN_EMAIL y ADMIN_PWD. Si estas variables de entorno no existen, utilice git config (~/.gitconfig) para obtener datos y si esta información no existe, utilice Admin ([email protected]) y la contraseña 123456 de forma predeterminada.
Cree una nueva semilla para agregar un usuario administrador a la base de datos. Usar:
php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
Es muy fácil agregar soporte (opcional) de inicio de sesión/registro social a Laravel Adminlte usando el paquete acacha/laravel-social. Ejecute en la carpeta raíz de su proyecto:
adminlte-laravel social
Siga el asistente para configurar los datos Oauth de sus proveedores sociales y ¡disfrútelo!
Más información en https://github.com/acacha/laravel-social.
Quitar línea
@ include ( ' auth.partials.social_login ' )
en los archivos resources/views/auth/login.blade.php
y register.blade.php
https://packagist.org/packages/acacha/admin-lte-template-laravel
http://acacha.org/mediawiki/AdminLTE#adminlte-laravel
Utilice phpunit al ejecutar la prueba del script del compositor:
$ composer test
Una vez que este paquete está instalado en un proyecto de Laravel, se instalan algunas pruebas para probar las características del paquete. Hay dos tipos de pruebas: pruebas de funciones/unidades y pruebas de navegador. Para ejecutar pruebas de características/unidades, ejecute:
./vendor/bin/phpunit
En un nuevo proyecto laravel creado con acacha-admintle.laravel instalado para probar que el paquete está instalado correctamente. También puede ejecutar pruebas del navegador con Laravel Dusk (instale primero manualmente el paquete Dusk siguiendo https://laravel.com/docs/master/dusk):
php artisan dusk:install
touch database/testing.database.sqlite
php artisan serve --env=dusk.local &
php artisan dusk
También puede probar este paquete en un entorno limitado sin necesidad de instalarlo. Ejecutar script:
./test.sh
Todas las cadenas están localizadas utilizando el soporte de localización de Laravel: https://laravel.com/docs/master/localization
En su archivo config/app.php puede cambiar la configuración regional para cambiar el idioma. Puede instalar solo archivos localizados usando la etiqueta adminlte_lang:
php artisan vendor:publish --tag=adminlte_lang --force
Los siguientes idiomas son compatibles de forma predeterminada con este paquete: inglés, catalán, español, holandés y portugués de Brasil. Si lo desea, no dude en enviar una nueva solicitud de extracción en otros idiomas.
NOTA: no es necesario en Laravel 5.5+
Acacha llum necesita GNU sed para funcionar, así que reemplace BSD sed con GNU sed usando:
brew install gnu-sed --with-default-names
Verifique su versión de sed con:
man sed
La ruta de la versión sed GNU es:
$ which sed
/usr/local/bin/sed
En lugar de la ruta predeterminada de BSD sed (instalada de forma predeterminada en MAC OS):
/usr/bin/sed
Más información en el #58
Ejecutar comando:
php artisan adminlte:username
Y luego puedes usar el nombre de usuario en lugar del correo electrónico para iniciar sesión.
NOTA: cuando utilizamos el inicio de sesión por nombre de usuario, si el inicio de sesión por nombre de usuario falla, el sistema intenta utilizar el nombre de usuario introducido como correo electrónico para iniciar sesión. De modo que los usuarios también pueden iniciar sesión mediante el correo electrónico.
Para volver al inicio de sesión por correo electrónico, elimine la opción de campo del archivo config/auth.php :
' providers ' = > [
' users ' => [
' driver ' => ' eloquent ' ,
' model ' => App U ser::class,
' field ' => ' username ' // Adminlte laravel. Valid values: ' email ' or ' username '
],
NOTA: La migración requerida para agregar el campo de nombre de usuario a la tabla de usuarios requiere:
composer require doctrine/dbal
Opcionalmente, puede definir un nombre de dominio predeterminado para el inicio de sesión con el nombre de usuario. Agregar opción de dominio:
' defaults ' => [
' guard ' => ' web ' ,
' passwords ' => ' users ' ,
' domain ' => ' defaultdomain.com ' ,
],
al archivo config/auth.php . Luego, si un usuario intenta iniciar sesión sin un dominio, se agregará el dominio predeterminado al iniciar sesión.
Entonces, con el ejemplo anterior, puedes escribir al iniciar sesión:
sergiturbadenas
y system/javascript lo reemplazará con:
El paquete adminlte de Laravel publica de forma predeterminada las traducciones de Laravel en Javascript/Vue.js agregando al encabezado HTML el siguiente script:
< 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 >
Este script se encuentra en un archivo Blade parcial (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)
Entonces, la variable global window.trans contiene todas las traducciones de Laravel y se puede usar en cualquier archivo Javascript.
También en la sección de código del archivo resources/assets/js/bootstrap.js :
Vue.prototype.trans = (key) => {
return _.get(window.trans, key, key);
};
Permite utilizar directamente la función trans en plantillas de vue:
{{ trans('auth.failed') }}
También puedes usar el código de los componentes internos de Vue:
this.trans('auth.failed')
Los mensajes de administración de Laravel están disponibles usando el prefijo adminlte_lang_message :
{{ trans('adminlte_lang_message.username') }}
No dude en eliminar/adaptar este archivo según sus necesidades.
Consulte CHANGELOG para obtener más información sobre los cambios recientes.
Consulte CONTRIBUCIÓN y CONDUCTA para obtener más detalles.
Si descubre algún problema relacionado con la seguridad, envíe un correo electrónico a [email protected] en lugar de utilizar el rastreador de problemas.
La Licencia MIT (MIT). Consulte el archivo de licencia para obtener más información.
https://github.com/acacha/adminlte-laravel-installer