Installation

Note: the next steps are only valid for a fresh installation procedure, if you are updating the package, refers to the Updating section.

1. On the root folder of your Laravel project, require the package using composer:

   composer require jeroennoten/laravel-adminlte

2. Install the required package resources using the next command:

   php artisan adminlte:install

   The command will install the AdminLTE template and its dependencies (Bootstrap, jQuery, etc.) on your public/vendor folder, the package configuration on the config/adminlte.php file, and the package translations on the resources/lang/vendor/adminlte/ folder (or lang/vendor/adminlte/ folder for Laravel >= 9.x versions).

   You can use --force option to overwrite existing files.

   You can use --interactive option to be guided through the process and choose what you want to install.

   You can check the installation status of the package resources with the command php artisan adminlte:status

3. Optionally, and for Laravel 7+ only, the package offers a set of AdminLTE styled authentication views that you can use in replacement of the ones provided by the legacy laravel/ui authentication scaffolding. If you are planning to use these views, then first require the laravel/ui package using composer and install the bootstrap scaffolding:

   composer require laravel/ui
   php artisan ui bootstrap --auth

   Then, you can make the view replacements executing the next artisan command:

   php artisan adminlte:install --only=auth_views

   Important: The authentication scaffolding offers features like login, logout and registration. It is a recommendation to always read the Laravel Authentication Documentation for details about the authentication scaffolding. Note that Laravel offers some starter kits (like Laravel-Breeze) besides the legacy laravel/ui package. So, using the authentication views from this package is OPTIONALLY and UP TO YOU.

4. Jump to the Usage Section to read how to use the main blade template provided by this package.