E-mail
Cliche is an Image Gallery Component for MODx Revolution 2.2.
Installation
- Install the component via the Package Manager.
- Reload the page
- Select Cliche under Components main menu
- Create an Album and upload some images
- Use the Cliche snippet to display your Albums
Features
- Simple Image Management : The cmp focuses on simplicity
- Multiple File Upload : Batch upload of images and/or zip upload are available for your convenience
- Easy to template: You can use the html markup that you want (either in a tpl file or in a chunk via the manager) along with any CSS style that you need
- Javascript Effect : Use any popular image effect with the library of your choice
Roadmap
- Copy or Move images between albums
- Watermark
- Sorting options
- Tag support
- Custom field
- Meta data (EXIF, IPTC or XMP meta data )
- Cliche Custom Resource types to manage album per resource which can be useful to manage portfolios
- More examples : Coming soon on a dedicated website
- Custom snippet : To allow easy sidebar integration
Before Public release
- Cliche Thumbnail Template variable : An easy way to manage Post thumbnail for your resource
- Gallerific Plugin
- More complete documentation
Usage
Use the Cliche Snippet to show your galleries as you want
Simply drop the following line in your document :
[[Cliche]]
To show all albums list:
[[Cliche?
&view=`albums`
]]
To show a specific album:
[[Cliche?
&id=`your_album_id`
&view=`album`
]]
To show a single image:
[[Cliche?
&id=`your_image_id`
&view=`image`
]]
Available Parameters
| Parameter |
Description |
Default Value |
|---|---|---|
| thumbWidth | Thumbnail width in pixels |
120 |
| thumbHeight | Thumbnail height in pixels |
120 |
| wrapperTpl | The wrapper html chunk, shared for all view | Albums : albumwrapper |
| itemTpl | Each item html chunk, shared for all view |
Albums : albumcover |
| plugin | The plugin controller, a PHP file which handle the display options |
default |
| columns | The number of columns to show |
3 |
| columnBreak | The HTML markup used to break columns with the default viewer |
<br style="clear: both;"> |
| browse |
Used for Album list and album view. Tell the script whether the thumbnail should link a page or directly the image |
1 |
Notes
By default, all chunks are filebased and are located in : "assets/components/cliche/plugins/[plugin]/[chunkName].tpl"
However, you still can use any normal chunk if you want.
Cliche will search first for the chunk in the db and if it does not exist, the file in the plugin directory (as a *.tpl file).
You can bypass the search in db to use only filebased chunks by using the parameter "use_filebased_chunks"
Have fun !
Bugs and Issues
Cliche is developed on GitHub at this adress: https://github.com/lossendae/Cliche