Download the PHP package prolix/image-bundle without Composer
On this page you can find all versions of the php package prolix/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 local/remote images before uploading them through a classic form. It uses Cropper jQuery plugin.
Installation
Require the bundle as a Composer dependency
Enable the bundles in the kernel
You must add the following bundles into app/AppKernel.php
:
Configure the bundle
You must use the image_widget.html.twig
form theme into app/config.yml
.
You must include the routing into app/config/routing.yml
:
See VichUploader documentation to configure the bundle.
Install assets
See Cropper quick start section to install assets.
Note that jQuery and Bootstrap are required.
Don't forget to include the following assets in your page:
/path/to/cropper/dist/cropper.min.css
/path/to/cropper/dist/cropper.min.js
@PrestaImageBundle/Resources/public/css/cropper.css
@PrestaImageBundle/Resources/public/js/cropper.js
Usage
Initialize cropper
Use the form type
Available options for the ImageType
:
aspect_ratio
(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
(int
): the max width to use when displaying the image preview (default:320
)preview_height
(int
): the max height to use when displaying the image preview (default:180
)download_uri
(string
): the path where the image is located (default:null
, automatically set)download_link
(bool
): whether the end user should be able to add a remote image by URL (default:true
)upload_mimetype
(string
): format of the image to be uploaded (default:image/png
)
(Note: If choosen mimetype is not supported by 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 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 be easily manipulated client side. ALWAYS validate the image-data, -size, -format at 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
symfony/form Version ^3.4|^4.0|^5.0
vich/uploader-bundle Version 1.15.*