1.5
Core concepts
Customization
Troubleshooting
Overriding files
Overriding BREAD Views
You can override any of the BREAD views for a single BREAD by creating a new folder in
resources/views/vendor/voyager/slug-name where slug-name is the slug that you have assigned for that table. There are 4 files that you can override:- browse.blade.php
- edit-add.blade.php
- read.blade.php
- order.blade.php
Alternatively you can override the views for all BREADs by creating any of the above files under
resources/views/vendor/voyager/breadOverriding submit button:
You can override the submit button without the need to override the whole
edit-add.blade.php by extending the submit-buttons section:1
@extends('voyager::bread.edit-add')
2
@section('submit-buttons')
3
@parent
4
<button type="submit" class="btn btn-primary save">Save And Publish</button>
5
@endsection
Copied!
Using custom Controllers
You can override the controller for a single BREAD by creating a controller which extends Voyagers controller, for example:
1
<?php
2
​
3
namespace App\Http\Controllers;
4
​
5
class VoyagerCategoriesController extends \TCG\Voyager\Http\Controllers\VoyagerBaseController
6
{
7
//...
8
}
Copied!
After that go to the BREAD-settings and fill in the Controller Name with your fully-qualified class-name:
Overriding Voyagers Controllers
Only use this method if you know what you are doing
We don't recommend or support overriding all controllers as you won't get any code-changes made in future updates.
If you want to override any of Voyagers core controllers you first have to change your config file
config/voyager.php:1
/*
2
|--------------------------------------------------------------------------
3
| Controllers config
4
|--------------------------------------------------------------------------
5
|
6
| Here you can specify voyager controller settings
7
|
8
*/
9
​
10
'controllers' => [
11
'namespace' => 'App\\Http\\Controllers\\Voyager',
12
],
Copied!
Then run
php artisan voyager:controllers, Voyager will now use the child controllers which will be created at App/Http/Controllers/VoyagerOverriding Voyager-Models
You are also able to override Voyagers models if you need to.
To do so, you need to add the following to your AppServiceProviders register method:
1
Voyager::useModel($name, $object);
Copied!
Where name is the class-name of the model and object the fully-qualified name of your custom model. For example:
1
<?php
2
​
3
namespace App\Providers;
4
​
5
use Illuminate\Support\ServiceProvider;
6
use Illuminate\Events\Dispatcher;
7
use TCG\Voyager\Facades\Voyager;
8
​
9
class AppServiceProvider extends ServiceProvider
10
{
11
public function boot()
12
{
13
Voyager::useModel('DataRow', \App\DataRow::class);
14
}
15
// ...
16
}
Copied!
The next step is to create your model and make it extend the original model. In case of
DataRow:1
<?php
2
​
3
namespace App;
4
​
5
class DataRow extends \TCG\Voyager\Models\DataRow
6
{
7
// ...
8
}
Copied!
If the model you are overriding has an associated BREAD, go to the BREAD settings for the model you are overriding and replace the Model Name with your fully-qualified class-name. For example, if you are overriding the Voyager
Menu model with your own App\Menu model:
Last modified 6mo ago