https://github.com/statamic/plugin-image
Statamic Plugin for resizing images in your templates
https://github.com/statamic/plugin-image
Last synced: 8 months ago
JSON representation
Statamic Plugin for resizing images in your templates
- Host: GitHub
- URL: https://github.com/statamic/plugin-image
- Owner: statamic
- Created: 2012-08-13T15:45:06.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2016-04-27T13:54:16.000Z (over 9 years ago)
- Last Synced: 2025-03-22T04:41:25.926Z (9 months ago)
- Language: PHP
- Size: 21.5 KB
- Stars: 19
- Watchers: 10
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
*This plugin is no longer being maintained and has been replaced by the native [Transform](http://statamic.com/learn/documentation/tags/transform) tag. Cheers!*
Statamic Image Plugin 
================================
The Image plugin is used for resizing, cropping, and manipulating your images on the fly, right from your template code. All images are cached and timestamped so caches are refreshed when files update.
## Installing
1. Download the zip file (or clone via git) and unzip it or clone the repo into `/_add-ons/`.
2. Ensure the folder name is `image` (Github timestamps the download folder).
3. Enjoy.
## Example Tag
{{ image src="/url_path/to/image" dim="400x300" }}
{{ /image }}
## Parameters
### Quality `quality`
Pass an integer from 1 to 100 to set your desired quality.
quality="80"
### Dimension `dim`
The dimension parameter is a swiss-army knife, all-in-one style parameter. Pass it your width x height (WxH), and your resize/crop flag and you're done.
dim="400x300>"
#### Resize/Crop Flags
**WxH#**
Center Crop to W/H, new image will be WxH, sized up if necessary
For example, with an image that is 150x150px and `dim=400x200#`, the image would be scaled up to 400x400 and then center cropped to fit 400x200
**WxH!**
Rescale the image to W/H. For example, with an image that is 150x150px and `dim=400x200!`, the image would be scaled to 200px high and by 400px wide
**WxH<**
Image will be rescaled to fit W/H with a fixed **width**
**WxH>**
Image will be rescaled to fit W/H with a fixed **height**
**WxH(**
Image will be cropped to fit W/H with a fixed **width**
**WxH)**
Image will be cropped to fit W/H with a fixed **height**
## Variables
### Image URL `{{ image_url }}`
The processed and cached image URL to reference.
### Width `{{ width }}`
The final width of the image
### Height `{{ height }}`
The final width of the image