imagina/bcrud-module

Crud Module for AsgardsCMS based on https://backpackforlaravel.com/

Backpack\CRUD

, _(*1)

Quickly build an admin interface for your Eloquent models, using Laravel 5. Erect a complete CMS at 10 minutes/model, max., _(*2)

Features: - 33+ field types - 1-n relationships - n-n relationships - Table view with search, pagination, click column to sort by it - Reordering (nested sortable) - Back-end validation using Requests - Translatable models (multi-language) // TODO - Easily extend fields (customising a field type or adding a new one is as easy as creating a new view with a particular name) - Easily overwrite functionality (customising how the create/update/delete/reorder process works is as easy as creating a new function with the proper name in your EntityCrudCrontroller), _(*3)

Subscribe to the Mailchimp list to be announced of any major features or breaking changes (once every 1-3 months)., _(*4)

, _(*5)

Install

1) In your terminal:, _(*6)

``` bash $ composer require backpack/crud, <sub>(*7)</sub>

2) Add this to your config/app.php, under "providers":
```php
        Backpack\CRUD\CrudServiceProvider::class,

3) Run:, <sub>(*8)</sub>

$ php artisan elfinder:publish #published elfinder assets
$ php artisan vendor:publish --provider="Backpack\CRUD\CrudServiceProvider" --tag="public" #publish CRUD assets
$ php artisan vendor:publish --provider="Backpack\CRUD\CrudServiceProvider" --tag="lang" #publish the lang files
$ php artisan vendor:publish --provider="Backpack\CRUD\CrudServiceProvider" --tag="config" #publish the config file
$ php artisan vendor:publish --provider="Backpack\CRUD\CrudServiceProvider" --tag="elfinder" #publish overwritten elFinder assets

4) Define an 'uploads' disk. In your config/filesystems.php add this disk:, <sub>(*9)</sub>

'uploads' => [
            'driver' => 'local',
            'root' => public_path('uploads'),
        ],

5) If you haven't already, go through steps 3-5 from the Backpack\Base installation (it provides the general views for the admin panel - layout, menu, notification bubbles, etc)., <sub>(*10)</sub>

6) [Optional] You can now the file manager to the menu, in resources/views/vendor/backpack/base/inc/sidebar.blade.php or menu.blade.php:, <sub>(*11)</sub>

<li><a href="{{ url(config('backpack.base.route_prefix').'/elfinder') }}"><i class="fa fa-files-o"></i> <span>File manager</span></a></li>

Usage

Check out the documentation at https://laravelbackpack.com, <sub>(*12)</sub>

In short:, <sub>(*13)</sub>

1. Make your model use the CrudTrait., <sub>(*14)</sub>

2. Create a controller that extends CrudController., <sub>(*15)</sub>

3. Create a new resource route., <sub>(*16)</sub>

4. (optional) Define your validation rules in a Request files., <sub>(*17)</sub>

(Optional) Enable Revisions

CRUD supports tracking and restoring Model change Revisions with the help of VentureCraft/revisionable., <sub>(*18)</sub>

To enable revisions on your Model do the following:, <sub>(*19)</sub>

1. Run:

$ php artisan migrate --path=vendor/venturecraft/revisionable/src/migrations #run revisionable migrations

1. Add the \Venturecraft\Revisionable\RevisionableTrait Trait to your Model. E.g:

namespace MyApp\Models;

class Article extends Eloquent {
    use \Backpack\CRUD\CrudTrait, \Venturecraft\Revisionable\RevisionableTrait;

    // If you are using another bootable trait the be sure to override the boot method in your model
    public static function boot()
    {
        parent::boot();
    }
}

1. Enable access to Revisions in your CrudController with:

$this->crud->allowAccess('revisions');

Head on over to the VentureCraft/revisionable GitHub repo to see the full documentation and extra configuration options., <sub>(*20)</sub>

Screenshots

• List view pictured above.
• Create/update view:
• File manager (elFinder):

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*21)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*22)</sub>

Security

If you discover any security related issues, please email hello@tabacitu.ro instead of using the issue tracker., <sub>(*23)</sub>

Credits

• Cristian Tabacitu - architect, designer, manager, main coder, PR guy, customer service guy & chief honcho
• Cristian Tone - architecture improvements
• Marius Constantin - bug fixing & improvements
• Federico Liva - bug fixing
• All Contributors

Special thanks go to: - John Skoumbourdis - Grocery CRUD for CodeIgniter was the obvious inspiration for this package. - Jaroen Noten - creator of AdminLTE, <sub>(*24)</sub>

License

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