# Extending Modules

## Overwriting views

If you want to extend one of the modules and add new fields (or remove some) you will need to overwrite the views first. To do that just copy a view from the vendor folder to the resources folder:

{% hint style="info" %}
To edit the`admin/user`view simply copy `vendor/taffovelikoff/hotcoffee/resources/views/admin/user.blade.php` to `resources/views/vendor/hotcoffee/admin/user.blade.php`
{% endhint %}

## Extending the user module

If you need to add more fields in the user module you first have to copy the `user.blade.php` from `vendor/taffovelikoff/hotcoffee/resources/views/admin` to `resources/views/vendor/hotcoffee/admin` and add your new field where you desire (for example right after "job title"):

```markup
<!-- Job Title -->
<div class="col-lg-6">
  <div class="form-group">
    <label class="form-control-label" for="input-last-name">{{ __('hotcoffee::admin.user_job') }}</label>
    <div @if($errors->has('job_title')) class="has-danger" @endif>
      <input type="text" name="job_title" id="input-last-name" class="form-control form-control-alternative @if($errors->has('job_title')) is-invalid-alt @endif" @if(session('post')) value="{{ session('post.job_title') }}" @elseif(isset($edit)) value="{{ $edit->address->job_title }}" @endif>
    </div>
  </div>
</div>

<!-- NEW FIELD -->
<!-- Phone -->
<div class="col-lg-6">
  <div class="form-group">
    <label class="form-control-label" for="input-phone">Phone Number</label>
    <div @if($errors->has('phone')) class="has-danger" @endif>
      <input type="text" name="phone" id="input-phone" class="form-control form-control-alternative @if($errors->has('phone')) is-invalid-alt @endif" @if(session('post')) value="{{ session('post.phone') }}" @elseif(isset($edit)) value="{{ $edit->address->phone}}" @endif>
    </div>
  </div>
</div>
```

It's recommended to keep the user information in the `user_address` table, instead of the `users` table. Now create a migration to add the new fields to the table.

```
php artisan make:migration add_surname_field_to_user_addresses_table
```

```php
<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class AddPhoneFieldToUserAddressesTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('user_addresses', function (Blueprint $table) {
            $table->string('phone')->nullable();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('user_addresses', function (Blueprint $table) {
           $table->dropColumn('phone');
        });
    }
}
```

Now you need to publish the user configuration file:

```bash
php artisan vendor:publish --tag=hotcoffee_config_users
```

In this file you can change some user configurations, but most importantly you can change the UserAddress namespace.

```php
return [

    /*
    |--------------------------------------------------------------------------
    | User Address Model
    |--------------------------------------------------------------------------
    | This allows to extend the model.
    |
    */

    'address_model'    => \App\Models\UserAddress,

```

Now create a new UserAddress model and populate the `fillable` attribute.

```php
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class UserAddress extends Model
{
    protected $fillable = ['city', 'country', 'job_title', 'company', 'bio', 'phone'];
}

```

If you need to do some validations you can add the rules and messages again in the `users.php` config file:

```php
/*
|--------------------------------------------------------------------------
| Additional validation rules
|--------------------------------------------------------------------------
| Any additional validation rules and messages when updating or creating
| user. You can also overwrite the defaults.
*/

'validations' => [
    'normal'    => [
        'phone' => 'required', // This will add a new validation for "phone".
    ],
    'translatable'  => [], // Add rules for translatable fields heree
],

'messages' => [
    'normal'    => [
        'phone.required' => 'Please provide a phone number.',
    ],
    'translatable'  => [], // Add messages for translatable fields heree
],
```

If you need to do something very specific you can copy the UserController.php from `vendor/taffovelikoff/hotcoffee/src/Http/Controllers/Admin` to `app/Http/Controllers/Admin` and re-define all the routes in your `routes/web.php`:

```php
<?php
/**
 * ADMIN
 * Below are all custom admin routes for your application.
 */
HotCoffee::routes();

Route::group(['prefix' => config('hotcoffee.prefix'), 'middleware' => ['hotcoffee']], function () {

    // Dashboard
    Route::get('/dashboard', 'Admin\DashboardController@index')->name('hotcoffee.admin.dashboard');

    // ===== OVERWRITING USERS MODULE ROUTES ===== //
    
    // Users (keep route names the same)
    Route::group(['prefix' => 'users'], function () {
        Route::get('/', 'Admin\UserController@index')->name('hotcoffee.admin.users.index');

        Route::get('/create', 'Admin\UserController@create')->name('hotcoffee.admin.users.create');
        Route::post('/', 'Admin\UserController@store')->name('hotcoffee.admin.users.store');

        Route::get('/{user}', 'Admin\UserController@edit')->name('hotcoffee.admin.users.edit');
        Route::post('/{user}', 'Admin\UserController@update')->name('hotcoffee.admin.users.update');

        Route::delete('/{user}', 'Admin\UserController@destroy')->name('hotcoffee.admin.users.destroy');
    });
});
```

Now the admin panel will use the controller from the `app/Http/Controllers/Admin` folder, instead the one in `vendor/taffovelikoff/hotcoffee/src/Http/Controllers/Admin` meaning you can edit the controller.

{% hint style="info" %}
If you are not sure about the route names of a module you can check them either with `php artisan route:list` or open `vendor/taffovelikoff/hotcoffee/routes/web.php`.
{% endhint %}

## Extending the article and info page modules

You can extend or change the **article** or **info page** modules in a very similar way.

```php
php artisan vendor:publish --tag=hotcoffee_config_articles
php artisan vendor:publish --tag=hotcoffee_config_infopages
```

You can create new models, that will extend the ones from the package.

```php
<?php

namespace App\Models;

class InfoPage extends \TaffoVelikoff\Hotcoffee\InfoPage
{
    //
}
```

Now change `model` in the configuration:

```php
<?php

/*
|--------------------------------------------------------------------------
| Info Pages
|--------------------------------------------------------------------------
| Configuration concerning the info pages.
|
*/

return [

    /*
    |--------------------------------------------------------------------------
    | Models
    |--------------------------------------------------------------------------
    | This allows to extend the model.
    |
    */
    'model' => App\Models\InfoPage::class,
```