Un package Laravel qui bascule l'échafaudage/passe-partout Laravel par défaut vers le modèle AdminLTE avec Bootstrap 3.0 et Pratt Landing Page
Voir la démo ici :
http://demo.adminlte.acacha.org/
Si vous recherchez la version Laravel 4, utilisez la version/tag 0.1.5 et consultez OLD-README.md
composer require " acacha/admin-lte-template-laravel "
Enfin, publiez les fichiers avec :
php artisan vendor:publish --tag=adminlte --force
Ces packages utilisent (pas besoin d'installer) :
brew install gnu-sed --with-default-names
Ce package suppose que vous avez dans le chemin votre dossier bin composer :
/YOUR_PATH_TO_HOME/.composer/vendor/bin
Par exemple en ajoutant cette ligne :
export PATH= ${PATH} : ~ /.composer/vendor/bin
dans votre fichier ~/.bashrc
Remarque : dans certains systèmes, le chemin peut être différent, par exemple :
export PATH= ${PATH} : ~ /.config/composer/vendor/bin
Assurez-vous de vérifier votre environnement.
Ce package installe les routes Laravel que vous ne trouverez pas dans le fichier routes.php. Les routes installées par package se trouveraient dans le fichier :
https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php
Un fichier inclus par AdminLTETemplateServiceProvider :
https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETemplateServiceProvider.php
Vous pouvez remplacer ces routes en modifiant l'ordre des fournisseurs de services dans le fichier config/app.php, donc si vous mettez :
App Providers RouteServiceProvider::class
Après
Acacha AdminLTETemplateLaravel Providers AdminLTETemplateServiceProvider::class
Vos routes dans le fichier routes.php remplaceront les routes adminlte-laravel par défaut.
Vous pouvez également installer manuellement les routes dans le fichier routes.php. Adminlte-laravel utilise les mêmes routes que la commande Laravel make:auth, voir :
https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub
vous pouvez donc ajouter ces lignes au fichier routes.php :
Route:: auth ();
Route:: get ( ' /home ' , ' HomeController@index ' );
Et désactivez AdminLTETemplateServiceProvider dans le fichier config/app.php (tenez compte du fait que les façades Adminte-laravel et les commandes personnalisées ne seront pas disponibles).
Voir le numéro 69 pour plus d'informations
Une fois le package installé, vous devez suivre les étapes habituelles de tout projet Laravel pour vous connecter à l'interface d'administration :
AdminLTE est un thème de panneau de configuration d'administration Premium gratuit basé sur Bootstrap 3.x créé par Abdullah Almsaeed. Voir:
https://github.com/almasaeed2010/AdminLTE
Adminlte-laravel prend en charge l'avatar reconnu mondialement (http://gravatar.com) à l'aide du package creativeorange/gravatar (https://github.com/creativeorange/gravatar).
Cette commande ajoute une vue au dossier ressources/vues en utilisant la disposition d'administration par défaut :
php artisan make:view about
Cette commande ajoute une entrée de menu au fichier config/menu.php :
php artisan make:menu link menuname
Exemple:
php artisan make:menu /contact
Cette commande ajoute une route au fichier de routes en utilisant :
php artisan make:route linkname
Par exemple, vous pouvez ajouter un fichier route routes /web.php avec l'URI /about en utilisant :
php artisan make:route about
Ces commandes ajoutent cette entrée à routes/web.php
Vous pouvez créer 3 types d'itinéraires avec le type d'option :
Exemples :
php artisan make:route about --type=controller
cela ajoute ce qui suit :
Route:: get ( ' about ' , ' AboutController@index ' );
dans le fichier routes/web.php . Vous pouvez choisir le nom et la méthode du contrôleur avec :
php artisan make:route about MyController@method --type=controller
Si vous souhaitez créer un contrôleur de ressources :
php artisan make:route about --type=resource
cela ajoute ce qui suit :
Route:: resource ( ' about ' , ' About@index ' );
dans le fichier routes/web.php .
Vous pouvez également créer des routes avec d'autres méthodes HTTP en utilisant la méthode option :
php artisan make:route save --method=post
Vous pouvez également ajouter des routes à l'API en utilisant l'option api :
php artisan make:route save --api
Ensuite, les routes seront ajoutées à routes/api.php .
Enfin, utilisez l'option -a pour ajouter des actions après la création de la route :
php artisan make:route about -a
La dernière commande crée également une vue avec le nom about.blade.php . En utilisant:
php artisan make:route about -a --type=controller
Créera un fichier Controller avec le nom AboutController et l'index de méthode.
Vous pouvez consulter toutes les options avec :
php artisan make:route --help
Cette commande est déjà exécutée lors de l'installation vous pouvez (ré)exécuter manuellement avec :
php artisan adminlte:publish
Publiez tous les fichiers nécessaires du package vers le projet Laravel.
Publiez uniquement la barre latérale du package sur le projet Laravel permettant de personnaliser la barre latérale :
php artisan adminlte:sidebar
Remarque : la barre latérale est déjà publiée lorsque vous utilisez la commande d'installation adminlte-laravel .
Remplace la vue de la barre latérale par une barre latérale en utilisant spatie/laravel-menu :
php artisan adminlte:menu
Cette commande installe également le package spatie/laravel-menu et crée un menu par défaut situé config/menu.php .
IMPORTANT : Spatie Laravel Menu nécessite PHP7.0 ou supérieur pour fonctionner
Exécute la commande artisanale make:adminUserSeeder (voir la section suivante) et exécute la graine. Cette commande ajoute un utilisateur administrateur par défaut à la base de données.
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 !
Cette commande utilise (si elle existe) les variables d'environnement (fichier .env) ADMIN_USER, ADMIN_EMAIL et ADMIN_PWD. Si ces variables d'environnement n'existent pas, utilisez git config (~/.gitconfig) pour obtenir des données et si ces informations n'existent pas, utilisez Admin ([email protected]) et le mot de passe 123456 par défaut.
Créez une nouvelle graine pour ajouter un utilisateur administrateur à la base de données. Utiliser:
php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
C'est un jeu d'enfant d'ajouter (facultatif) la prise en charge de la connexion/inscription sociale à Laravel Adminlte à l'aide du package acacha/laravel-social. Exécutez dans le dossier racine de votre projet :
adminlte-laravel social
Suivez l'assistant pour configurer les données Oauth de vos fournisseurs sociaux et profitez-en !
Plus d'informations sur https://github.com/acacha/laravel-social.
Supprimer la ligne
@ include ( ' auth.partials.social_login ' )
dans les fichiers resources/views/auth/login.blade.php
et register.blade.php
https://packagist.org/packages/acacha/admin-lte-template-laravel
http://acacha.org/mediawiki/AdminLTE#adminlte-laravel
Utilisez phpunit pour exécuter le test du script composer :
$ composer test
Une fois ce package installé dans un projet Laravel, certains tests sont installés pour tester les fonctionnalités du package. Il existe deux types de tests, les tests de fonctionnalités/unités et les tests de navigateur. Pour exécuter des tests de fonctionnalités/unités, exécutez :
./vendor/bin/phpunit
Dans un nouveau projet Laravel créé avec acacha-admintle.laravel installé pour tester, ce package est correctement installé. Vous pouvez également exécuter des tests de navigateur avec Laravel Dusk (veuillez d'abord installer manuellement le package Dusk en suivant https://laravel.com/docs/master/dusk) :
php artisan dusk:install
touch database/testing.database.sqlite
php artisan serve --env=dusk.local &
php artisan dusk
Vous pouvez également tester ce package dans un bac à sable sans avoir besoin de l'installer. Exécuter le script :
./test.sh
Toutes les chaînes sont localisées à l'aide du support de localisation de Laravel : https://laravel.com/docs/master/localization
Dans votre fichier config/app.php, vous pouvez modifier les paramètres régionaux pour changer de langue. Vous pouvez installer uniquement les fichiers localisés en utilisant la balise adminlte_lang :
php artisan vendor:publish --tag=adminlte_lang --force
Les langues suivantes sont prises en charge par défaut sur ce package : anglais, catalan, espagnol, néerlandais et portugais brésilien. N'hésitez pas à soumettre une nouvelle pull request dans d'autres langues si vous le souhaitez.
REMARQUE : non nécessaire dans Laravel 5.5+
Acacha llum a besoin de GNU sed pour fonctionner, alors remplacez BSD sed par GNU sed en utilisant :
brew install gnu-sed --with-default-names
Vérifiez votre version de sed avec :
man sed
Le chemin de la version sed GNU est :
$ which sed
/usr/local/bin/sed
Au lieu du chemin par défaut de BSD sed (installé par défaut sur MAC OS) :
/usr/bin/sed
Plus d'infos au #58
Exécuter la commande :
php artisan adminlte:username
Et puis vous pouvez utiliser le nom d'utilisateur au lieu de l'e-mail pour vous connecter.
REMARQUE : lorsque nous utilisons la connexion par nom d'utilisateur, si la connexion par nom d'utilisateur échoue, le système essaie d'utiliser le nom d'utilisateur introduit comme e-mail pour la connexion. Les utilisateurs peuvent donc également se connecter par courrier électronique.
Pour revenir à la connexion par e-mail, supprimez l'option de champ du fichier config/auth.php :
' providers ' = > [
' users ' => [
' driver ' => ' eloquent ' ,
' model ' => App U ser::class,
' field ' => ' username ' // Adminlte laravel. Valid values: ' email ' or ' username '
],
REMARQUE : La migration requise pour ajouter le champ de nom d'utilisateur à la table des utilisateurs nécessite :
composer require doctrine/dbal
En option, vous pouvez définir un nom de domaine par défaut pour la connexion par nom d'utilisateur. Option Ajouter un domaine :
' defaults ' => [
' guard ' => ' web ' ,
' passwords ' => ' users ' ,
' domain ' => ' defaultdomain.com ' ,
],
dans le fichier config/auth.php . Ensuite, si un utilisateur tente de se connecter sans domaine, le domaine par défaut sera ajouté lors de la connexion.
Ainsi, avec l'exemple précédent, vous pouvez taper lors de la connexion :
sergiturbadenas
et system/javascript remplacera cela par :
Le package d'administration Laravel publie par défaut les traductions Laravel dans Javascript/Vue.js en ajoutant à l'en-tête HTML le script suivant :
< 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 >
Ce script se trouve dans le fichier lame partiel (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)
Ainsi, la variable globale window.trans contient toutes les traductions Laravel et peut être utilisée dans n'importe quel fichier Javascript.
Également dans la section de code du fichier resources/assets/js/bootstrap.js :
Vue.prototype.trans = (key) => {
return _.get(window.trans, key, key);
};
Permet d'utiliser directement la fonction trans dans les modèles vue :
{{ trans('auth.failed') }}
Vous pouvez également utiliser le code des composants Vue :
this.trans('auth.failed')
Les messages d'administration Laravel sont disponibles en utilisant le préfixe adminlte_lang_message :
{{ trans('adminlte_lang_message.username') }}
N'hésitez pas à supprimer/adapter ce fichier à vos besoins.
Veuillez consulter CHANGELOG pour plus d'informations sur ce qui a changé récemment.
Veuillez consulter CONTRIBUTION et CONDUITE pour plus de détails.
Si vous découvrez des problèmes liés à la sécurité, veuillez envoyer un e-mail à [email protected] au lieu d'utiliser le suivi des problèmes.
La licence MIT (MIT). Veuillez consulter le fichier de licence pour plus d'informations.
https://github.com/acacha/adminlte-laravel-installer