acacha/users

User managment with Laravel and adminlte-laravel

users

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads] , _(*1)

Acacha users is a Laravel package that add Users managment support yo your Laravel app., _(*2)

Installation

Via Composer please first create a new fresh Laravel Project:, _(*3)

``` bash laravel new laravel_with_users cd laravel_with_users, <sub>(*4)</sub>

Install adminlte-laravel template with:

``` bash
adminlte-laravel install

Then install this Laravel Package using:, <sub>(*5)</sub>

``` bash composer require acacha/users, <sub>(*6)</sub>

Now install Javascript Vue components using:

npm install --save acacha-users, <sub>(*7)</sub>

Modify your app.js Bundle to use acacha-users Vue components adding:

//Acacha Users management components require('users-bootstrap');, <sub>(*8)</sub>

Just after Vue installation. Now compile with:

npm install npm run dev, <sub>(*9)</sub>

Install also Spatie Laravel Permission Package:

composer require spatie/laravel-permission php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations" php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="config" php artisan migrate, <sub>(*10)</sub>

Configure **App\User** adding the following traits:

class User extends Authenticatable { use Notifiable, HasRoles, HasApiTokens, ExposePermissions, RevisionableTrait,HasUserMigrations;, <sub>(*11)</sub>

Also install spatie/laravel-menu usign wizard:

php artisan adminlte:menu, <sub>(*12)</sub>

Use llum boot to run migrations and other common firt execution tasks:

llum boot, <sub>(*13)</sub>

Finally assure Laravel Passport (https://laravel.com/docs/5.5/passport) is installed and configured. Composer package is a dependency so no need 
to install explicitly but be sure to add CreateFreshApiToken midleware to Http/Kernel.php file

protected $middlewareGroups = [ 'web' => [ ... \Laravel\Passport\Http\Middleware\CreateFreshApiToken::class, ],, <sub>(*14)</sub>

And change auth configuration to use passport:

'guards' => [ ... 'api' => [ 'driver' => 'passport', 'provider' => 'users', ], ],, <sub>(*15)</sub>

### Installation on development

Via Composer please first create a new fresh Laravel Project:

``` bash
laravel new laravel_with_users
cd laravel_with_users

Install adminlte-laravel template with:, <sub>(*16)</sub>

``` bash adminlte-laravel install, <sub>(*17)</sub>

Install Studio (https://github.com/franzliedke/studio) on your system or use Composer path repositories (https://getcomposer.org/doc/05-repositories.md#path)

With Composer Path repositories add in composer.json file just before require section

"repositories": [ { "type": "path", "url": "./users" }, { "type": "path", "url": "./users-ebre-escool-migration" } ],, <sub>(*18)</sub>

Create folders users and users-ebre-escool-migration with packages (you can clone it):

https://github.com/acacha/users https://github.com/acacha/users-ebre-escool-migration, <sub>(*19)</sub>

Then install this Laravel Package using:

``` bash
composer require acacha/stateful-eloquent:dev-master
composer require acacha/users:dev-master
composer require scool/ebre_escool_model:dev-master
composer require acacha/users-ebre-escool-migration:dev-master

Now is time to configure npm dependencies. Modify file webpack.mix.js adding:, <sub>(*20)</sub>

  .js .....
  .sourceMaps()
  .webpackConfig({
    resolve: {
      modules: [
        path.resolve(__dirname, './users/resources/assets/js'),
        path.resolve(__dirname, './users-ebre-escool-migration/resources/assets/js'),
        path.resolve(__dirname, 'node_modules')
      ]
    }
  })

Compile Javascript bundle with Laravel Mix/webpack:, <sub>(*21)</sub>

npm install
npm run dev

Requirements

• Laravel
• Spatie Laravel permission package
• Acacha AdminLTE Laravel template
• Javascript npm packages
  • Vue
  • Axios
  • adminlte-vue
  • vuetable-2
  • password-generator
  • vue-events (TODO migrate to Vuex Store!)
  • vue-scrollto

Vuetable-2 problem with transform-runtime (see also http://acacha.org/mediawiki/Vuetable2):, <sub>(*22)</sub>

npm install --save-dev babel-plugin-transform-runtime babel-preset-stage-2

Tests

Add the suites to phpunit.xml file:, <sub>(*23)</sub>

<testsuite name="Users">
    <directory suffix="Test.php">./users/tests/Feature</directory>
</testsuite>
<testsuite name="UsersEbreEscoolMigration">
    <directory suffix="Test.php">./users-ebre-escool-migration/tests/Feature</directory>
</testsuite>

And run phpunit., <sub>(*24)</sub>

Usage

``` php $skeleton = new Acacha\Users(); echo $skeleton->echoPhrase('Hello, League!');, <sub>(*25)</sub>

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*26)</sub>

Security

If you discover any security related issues, please email sergiturbadenas@gmail.com instead of using the issue tracker., <sub>(*27)</sub>

Credits

• Sergi Tur Badenas
• All Contributors

TODO Javascript/Npm dependencies

• adminlte-vue
• password-generator https://www.npmjs.com/package/password-generator

License

The MIT License (MIT). Please see License File for more information., <sub>(*28)</sub>