README

An admin interface to easily add/edit/remove Gallery, using Laravel Backpack.

It uses Glide and provides helper methods to serve the images in frontend blade templates.

Install

1. In your terminal:

$ composer require webstone/laravel-backpack-gallery-crud

1. If your Laravel version does not have package autodiscovery then add the service provider to your config/app.php file:

Cviebrock\EloquentSluggable\ServiceProvider::class,
SeanDowney\BackpackGalleryCrud\GalleryCRUDServiceProvider::class,

1. Publish the config file & run the migrations

$ php artisan vendor:publish --provider="SeanDowney\BackpackGalleryCrud\GalleryCRUDServiceProvider" #publish config, view  and migration files
$ php artisan migrate #create the gallery table

1. Configuration of file storage in config/filesystems.php.

'galleries' => [
    'driver' => 'local',
    'root' => storage_path('app/galleries'),
],

1. Configuration of file storage in config/elfinder.php:

'roots' => [
    [
        'driver'        => 'GalleryCrudLocalFileSystem',         // driver for accessing file system (REQUIRED)
        'path'          => '../storage/app/galleries',           // path to files - relative to `public` (REQUIRED)
        'URL'           => '/galleries', // URL to files (REQUIRED)
        'accessControl' => 'Barryvdh\Elfinder\Elfinder::checkAccess',
        'autoload'      => true,
        'tmbPath'       => '',
        'tmbSize'       => 150,
        'tmbCrop'       => false,
        'tmbBgColor'    => '#000',
    ],
],

1. [Optional] Configuration of Glide image path in config/seandowney/gallerycrud.php.

'glide_path' => 'image',

1. [Optional] Add a menu item for it in resources/views/vendor/backpack/base/inc/sidebar.blade.php or menu.blade.php:

<li><a href="{{ url(config('backpack.base.route_prefix', 'admin').'/gallery') }}"><i class="la la-picture-o"></i> <span>Galleries</span></a></li>

How to use the package

This package relies heavily on the elFinder File Manager in Bakpack.

• First create a gallery
• Select some images or upload new ones
• Save the gallery and edit it again
• Now you can edit the captions for the selected images
• Helper methods are now available to load the images using Glide.
  • image_url can be used where the images is from a browse field type so it may already include the disk path

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

// TODO

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email sean at considerweb dot com instead of using the issue tracker.

Credits

• Seán Downey - Lead Developer
• All Contributors

License

The MIT License (MIT). Please see License File for more information.