Initial release

Author: Ghitu

changelog.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to `Argon` frontend preset for Laravel will be documented in this file.
+
+## Version 1.0.0
+
+### Added
+- Argon v1.0.0 frontend theme
+- Laravel Auth preset
+- Change user profile
+- User CRUD

composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "laravel-frontend-presets/argon",
+    "description": "Laravel 5.x Front-end preset for argon",
+    "license": "MIT",
+    "homepage": "https://github.com/creativetimofficial/argon-dashboard",
+    "keywords": ["Laravel", "Preset", "Argon"],
+    "require": {
+        "laravel/framework": "5.5.*"
+    },
+    "autoload": {
+        "psr-4": {
+            "LaravelFrontendPresets\\ArgonPreset\\": "src/"
+        }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "LaravelFrontendPresets\\ArgonPreset\\ArgonPresetServiceProvider"
+            ]
+        }
+    }
+}

license.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2019 [Updivision](https://updivision.com)  [Creative Tim](https://www.creative-tim.com) 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

readme.md

@@ -0,0 +1,145 @@
+# Argon Frontend Preset For Laravel Framework 5.5 and Up
+
+Argon Frontend Preset For Laravel Framework 5.5 and Up
+
+*Current version*: Argon v1.0.0. More info at https://github.com/creativetimofficial/argon-dashboard.
+
+## Note
+
+We recommend installing this preset on a project that you are starting from scratch, otherwise your project's design might break.
+
+## Installation
+
+After initializing a fresh instance of Laravel (and making all the necessary configurations), install the preset using one of the provided methods:
+
+### Via composer
+
+1. `Cd` to your Laravel app
+2. Install this preset via `composer require laravel-frontend-presets/argon`. No need to register the service provider. Laravel 5.5 & up can auto detect the package.
+3. Run `php artisan preset argon` command to install the Argon preset. This will install all the necessary assets and also the custom auth views, it will also add the auth route in `routes/web.php`
+(NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries in routes/web.php)
+4. Run `php artisan migrate --seed` to create basic users table
+
+### By using the archive
+
+1. In your application's root create a presets folder
+2. Paste the files from the archive in it
+3. Open `composer.json` file 
+4. Add `"LaravelFrontendPresets\\ArgonPreset\\": "presets/LaravelFrontendPresets/ArgonPreset/src"` to `autoload/psr-4` and to `autoload-dev/psr-4`
+5. Add `LaravelFrontendPresets\ArgonPreset\ArgonPresetServiceProvider::class` to `config/app.php` file
+6. In your terminal run `composer dump-autoload`
+7. Run `php artisan preset argon` command to install the Argon preset. This will install all the necessary assets and also the custom auth views, it will also add the auth route in `routes/web.php`
+(NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries in routes/web.php)
+8. Run `php artisan migrate --seed` to create basic users table
+
+
+## Usage
+
+Register a user or login using **admin@argon.com** and **secret** and start testing the preset (make sure to run the migrations and seeders for these credentials to be available).
+
+Besides the dashboard and the auth pages this preset also has a user management example and an edit profile page. All the necessary files (controllers, requests, views) are installed out of the box and all the needed routes are added to `routes/web.php`. Keep in mind that all of the features can be viewed once you login using the credentials provided above or by registering your own user. 
+
+### Dashboard
+
+You can access the dashboard either by using the "**Dashboard**" link in the left sidebar or by adding **/home** in the url. 
+
+### Profile edit
+
+You have the option to edit the current logged in user's profile (change name, email and password). To access this page just click the "**User profile**" link in the left sidebar or by adding **/profile** in the url.
+
+The `App\Htttp\Controlers\ProfileController` handles the update of the user information. 
+
+```
+public function update(ProfileRequest $request)
+{
+    auth()->user()->update($request->all());
+
+    return back()->withStatus(__('Profile successfully updated.'));
+}
+```
+
+Also you shouldn't worry about entering wrong data in the inputs when editing the profile, validation rules were added to prevent this (see `App\Http\Requests\ProfileRequest`). If you try to change the password you will see that other validation rules were added in `App\Http\Requests\PasswordRequest`. Notice that in this file you have a custom validation rule that can be found in `App\Rules\CurrentPasswordCheckRule`.
+
+```
+public function rules()
+{
+    return [
+        'old_password' => ['required', 'min:6', new CurrentPasswordCheckRule],
+        'password' => ['required', 'min:6', 'confirmed', 'different:old_password'],
+        'password_confirmation' => ['required', 'min:6'],
+    ];
+}
+```
+
+### User management
+
+The preset comes with a user management option out of the box. To access this click the "**User Management**" link in the left sidebar or add **/user** to the url.
+The first thing you will see is the listing of the existing users. You can add new ones by clicking the "**Add user**" button (above the table on the right). On the Add user page you will see the form that allows you to do this. All pages are generate using blade templates:
+
+```
+<div class="form-group{{ $errors->has('name') ? ' has-danger' : '' }}">
+    <label class="form-control-label" for="input-name">{{ __('Name') }}</label>
+    <input type="text" name="name" id="input-name" class="form-control form-control-alternative{{ $errors->has('name') ? ' is-invalid' : '' }}" placeholder="{{ __('Name') }}" value="{{ old('name') }}" required autofocus>
+
+    @if ($errors->has('name'))
+        <span class="invalid-feedback" role="alert">
+            <strong>{{ $errors->first('name') }}</strong>
+        </span>
+    @endif
+</div>
+```
+
+Also validation rules were added so you will know exactely what to enter in the form fields (see `App\Http\Requests\UserRequest`). Note that these validation rules also apply for the user edit option.
+
+```
+public function rules()
+{
+    return [
+        'name' => [
+            'required', 'min:3'
+        ],
+        'email' => [
+            'required', 'email', Rule::unique((new User)->getTable())->ignore($this->route()->user->id ?? null)
+        ],
+        'password' => [
+            $this->route()->user ? 'nullable' : 'required', 'confirmed', 'min:6'
+        ]
+    ];
+}
+```
+
+Once you add more users, the list will get bigger and for every user you will have edit and delete options (access these options by clicking the three dotted menu that appears at the end of every line). 
+
+All the sample code for the user management can be found in `App\Http\Controllers\UserController`. See store method example bellow:
+
+```
+public function store(UserRequest $request, User $model)
+{
+    $model->create($request->merge(['password' => bcrypt($request->get('password'))])->all());
+
+    return redirect()->route('user.index')->withStatus(__('User successfully created.'));
+}
+```
+
+## Change log
+
+Please see the [changelog](changelog.md) for more information on what has changed recently.
+
+## Credits
+
+- [Creative Tim](https://creative-tim.com/)
+- [Updivision](https://updivision.com)
+
+## License
+
+The MIT License (MIT).
+
+## Screen shots
+
+![Argon Login](/screens/Login.png)
+
+![Argon Dashboard](/screens/Dashboard.png)
+
+![Argon Users](/screens/Users.png)
+
+![Argon Profile](/screens/Profile.png)

screens/Dashboard.png

@@ -0,0 +1,175 @@
+<?php
+
+namespace LaravelFrontendPresets\ArgonPreset;
+
+use Illuminate\Filesystem\Filesystem;
+use Illuminate\Foundation\Console\Presets\Preset;
+
+class ArgonPreset extends Preset
+{
+    const STUBSPATH = __DIR__.'/argon-stubs/';
+
+    /**
+     * Install the preset.
+     *
+     * @return void
+     */
+    public static function install()
+    {
+        static::updatePackages();     
+        static::updateAssets();      
+        
+        static::updateWelcomePage();
+        static::updateAuthViews();
+        static::updateLayoutViews();
+        static::updateDashboardPage();
+        
+        static::addUserManagement();
+        
+        // static::removeNodeModules();
+    }
+
+    /**
+     * Update the given package array.
+     *
+     * @param  array  $packages
+     * @return array
+     */
+    protected static function updatePackageArray(array $packages)
+    {
+        return $packages;
+    }
+
+    /**
+     * Update the assets
+     *
+     * @return void
+     */
+    protected static function updateAssets()
+    {
+        static::copyDirectory('resources/assets', public_path('argon'));
+    }
+
+    /**
+     * Update the default welcome page file.
+     *
+     * @return void
+     */
+    protected static function updateWelcomePage()
+    {
+        // remove default welcome page
+        static::deleteResource(('views/welcome.blade.php'));
+
+        // copy new one from your stubs folder
+        static::copyFile('resources/views/welcome.blade.php', resource_path('views/welcome.blade.php'));
+    }
+
+    /**
+     * Update the default dashboard page file.
+     *
+     * @return void
+     */
+    protected static function updateDashboardPage()
+    {
+        // remove default welcome page
+        static::deleteResource(('views/dashboard.blade.php'));
+
+        // copy new one from your stubs folder
+        static::copyFile('resources/views/dashboard.blade.php', resource_path('views/dashboard.blade.php'));
+    }
+
+    /**
+     * Update the default layout files
+     *
+     * @return void
+     */
+    protected static function updateLayoutViews()
+    {
+        // copy new one from your stubs folder
+        static::copyDirectory('resources/views/layouts', resource_path('views/layouts'));
+    }
+
+    /**
+     * Copy Auth view templates.
+     *
+     * @return void
+     */
+    protected static function updateAuthViews()
+    {
+        // Add Home controller
+        static::copyFile('app/Http/Controllers/HomeController.php', app_path('Http/Controllers/HomeController.php'));
+
+        // Add Auth routes in 'routes/web.php'
+        file_put_contents(
+            './routes/web.php', 
+            "Auth::routes();\n\nRoute::get('/home', 'HomeController@index')->name('home');\n\n", 
+            FILE_APPEND
+        );
+        
+        // Copy argon auth views from the stubs folder
+        static::deleteResource('views/home.blade.php');
+        static::copyDirectory('resources/views/auth', resource_path('views/auth'));
+    }
+    
+    /**
+     * Copy user management and profile edit files
+     *
+     * @return void
+     */
+    public static function addUserManagement()
+    {
+        // Add seeder, controllers, requests and rules
+        static::copyDirectory('database/seeds', app_path('../database/seeds'));
+               
+        static::copyFile('app/Http/Controllers/UserController.php', app_path('Http/Controllers/UserController.php'));
+        static::copyFile('app/Http/Controllers/ProfileController.php', app_path('Http/Controllers/ProfileController.php'));
+        static::copyDirectory('app/Http/Requests', app_path('Http/Requests'));
+        static::copyDirectory('app/Rules', app_path('Rules'));
+
+        // Add routes
+        file_put_contents(
+            './routes/web.php', 
+            "Route::group(['middleware' => 'auth'], function () {\n\tRoute::resource('user', 'UserController', ['except' => ['show']]);\n\tRoute::get('profile', ['as' => 'profile.edit', 'uses' => 'ProfileController@edit']);\n\tRoute::put('profile', ['as' => 'profile.update', 'uses' => 'ProfileController@update']);\n\tRoute::put('profile/password', ['as' => 'profile.password', 'uses' => 'ProfileController@password']);\n});\n\n", 
+            FILE_APPEND
+        );
+
+        // Copy views
+        static::copyDirectory('resources/views/users', resource_path('views/users'));
+        static::copyDirectory('resources/views/profile', resource_path('views/profile'));
+    }
+
+    /**
+     * Delete a resource
+     *
+     * @param string $resource
+     * @return void
+     */
+    private static function deleteResource($resource)
+    {
+        (new Filesystem)->delete(resource_path($resource));
+    }
+
+    /**
+     * Copy a directory
+     *
+     * @param string $file
+     * @param string $destination
+     * @return void
+     */
+    private static function copyFile($file, $destination)
+    {
+        (new Filesystem)->copy(static::STUBSPATH.$file, $destination);
+    }
+
+    /**
+     * Copy a directory
+     *
+     * @param string $directory
+     * @param string $destination
+     * @return void
+     */
+    private static function copyDirectory($directory, $destination)
+    {
+        (new Filesystem)->copyDirectory(static::STUBSPATH.$directory, $destination);
+    }
+}