Download the PHP package presta/image-bundle without Composer
On this page you can find all versions of the php package presta/image-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package image-bundle
PrestaImageBundle
Overview
PrestaImageBundle is a Symfony bundle providing tools to resize uploaded and remote images before sending them through a classic form. It uses the Cropper.js library.
Installation
Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.
Applications that use Symfony Flex
Open a command console, enter your project directory and execute:
Applications that don't use Symfony Flex
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the config/bundles.php
file of your project:
Configuration
You must configure the form_layout.html.twig
form theme into config/packages/twig.yaml
.
Note: you can also create your own form theme instead.
You must include the routing into config/routes.yaml
:
See VichUploader documentation to configure the bundle.
Assets
See Cropper.js documentation to install assets.
Don't forget to include the following assets in your page:
@PrestaImageBundle/public/css/cropper.css
@PrestaImageBundle/public/js/cropper.js
How to: implementation examples
Usage
Initialize cropper
Use the form type
Available options for the ImageType
:
aspect_ratios
(array
): a list of aspect ratio to apply when resizing an imagecropper_options
(array
): a list of options supported by cropper (default:['autoCropArea' => 1]
)max_width
(int
): the max width of the cropped image send to server (default:320
)max_height
(int
): the max height of the cropped image send to server (default:180
)preview_width
(string
): the max width to use when displaying the image preview - can be in px, % or other css value (default:'320px'
)preview_height
(string
): the max height to use when displaying the image preview - can be in px, % or other css value (default:'180px'
)upload_button_class
(string
): CSS class of the "upload" button (default:''
)cancel_button_class
(string
): CSS class of the "cancel" button (default:''
)save_button_class
(string
): CSS class of the "save" button (default:''
)download_uri
(string
): the path where the image is located (default:null
, automatically set)show_image
(bool
): whether the image should be rendered in the form or not (default:true
)file_upload_enabled
(bool
): whether to enable the file upload widget or not (default:true
)remote_url_enabled
(bool
): whether to enable the remote url widget or not (default:true
)rotation_enabled
(bool
): whether to enable the rotation or not (default:false
)upload_mimetype
(string
): format of the image to be uploaded (default:image/png
)
(Note: If the chosen mimetype is not supported by the browser, it will silently fall back toimage/png
)upload_quality
(float
): quality (0..1) of uploaded image for lossy imageformats (eg.image/jpeg
) (default:0.92
)
Notes
You can find Cropper.js options here.
The max_width
and max_height
options are used to define maximum size the cropped uploaded image will be.
Bigger images (after cropping) are scaled down.
Security Note: NEVER rely on this size constraints and the format settings as
they can easily be manipulated client side. ALWAYS validate the image-data
, image-size,
image-format
server side!
Contributing
Pull requests are welcome.
Thanks to everyone who has contributed already.
This project is supported by PrestaConcept
Lead Developer : @J-Ben87
Released under the MIT License
All versions of image-bundle with dependencies
ext-fileinfo Version *
ext-json Version *
symfony/form Version ^5.4|^6.4|^7.0
vich/uploader-bundle Version ^2.0