Glide is a wonderfully easy on-demand image manipulation library written in PHP. Its straightforward API is exposed via HTTP, similar to cloud image processing services like Imgix and Cloudinary. Glide leverages powerful libraries like Intervention Image (for image handling and manipulation) and Flysystem (for file system abstraction).
Please check the documentation for usage examples.
Requirements
- PHP 7.4 or higher
- October CMS 2.x
Installation
composer require vdlp/oc-glide-plugin
Configuration
To configure this plugin execute the following command:
php artisan vendor:publish --provider="Vdlp\Glide\ServiceProvider" --tag="config"
This will create a config/glide.php
file in your app where you can modify the configuration.
Modify the environment file by adding the following lines:
GLIDE_IMAGE_DRIVER = "gd" GLIDE_SIGN_KEY = "[YOUR SIGN KEY HERE]"
Add an url to your disk in the config/filesystem.php
to display the images properly, for example:
... 'disks' => [ 'local' => [ 'driver' => 'local', 'root' => storage_path('app'), 'url' => 'storage/app/', ], ], ...
Example
Here you can see some basic examples of how to use this plugin. Out of the box, the default configuration used is main
.
<!-- URL: images/main/media/test.jpg?s=5ef7c430ebb5a3b0fbfce160ae6de275 --> <img src="{{ 'media/test.jpg'|thumb() }}" /> <!-- URL: images/main/media/test.jpg?w=50&h=50&s=36b0575d9556f32e7e7a3bc2e551ccb2 --> <img src="{{ 'media/test.jpg'|thumb({w: 50, h: 50}) }}" />
Questions? Need help?
If you have any question about how to use this plugin, please don't hesitate to contact us at octobercms@vdlp.nl. We're happy to help you. You can also visit the support forum and drop your questions/issues there.
3.2.0 |
Add support for October CMS 3.0 May 27, 2022 |
---|---|
3.1.0 |
Maintenance release Mar 05, 2022 |
3.0.1 |
Add missing CHANGELOG file Jul 21, 2021 |
3.0.0 |
!!! Drop support for PHP 7.1 (minimum required PHP version 7.4) - Review implementation (see README.md) Jul 06, 2021 |
2.0.1 |
Update plugin dependencies May 28, 2021 |
2.0.0 |
!!! October Build 1.1.0 required, make laravel 6 compatible. Oct 19, 2020 |
1.1.0 |
Move thumbnail generation logic to a (re-usable) Helper. Mar 22, 2019 |
1.0.1 |
Catch exception when file cannot be found or image could not be created. Jan 25, 2019 |
1.0.0 |
First version of Vdlp.Glide Jan 24, 2019 |