Bonckolen CoolIris Plugin Istruction
Last Updated on Thursday, 09 June 2011 13:09 Thursday, 28 May 2009 07:37
The concept is simple.
You want to add image galleries inside your articles (content items)!
1. First set the "Root folder" of all galleries in the plugin's settings. By default it's the "root" folder.
2. Now create a new folder anywhere inside your root folder, for example call it mygallery and upload there all your images.
3. Go ahead and create a new content item (or open an existing one) and simply insert
{ boncko}/mygallery/{/boncko} or
{ boncko msg="title different from default" music="mymp3.mp3"}/mygallery/{/boncko}, where you want your image gallery to appear inside your text. It doesn't have to be at the end of your article, it can be anywhere you insert it inside your content item.
WARNING: no space beetween { and boncko
That's it! Fire up your favorite browser, navigate to the above content item et voila! An image gallery inside your content item!
You can have as many galleries as you want inside each content item, since caching takes care of performance.
If you want to create a gallery from subfolders inside the ROOT folder, simply add them like this:
{ boncko}/folder/subfolder/othersubfolder/{/boncko}.
In other words, write the path to your target folder with slashes at the beginning and at the end of your path.
You can create gallery from more folders just writing something like this
{ boncko}/mygallery/¦/mygallery2/{/boncko}
Don't forget to adjust the width and height of the thumbnails. Decreasing the width means you are adding more thumbnails in each row of the gallery. So, experiment before going public.
For performance issues, prefer not to use more than 5 - 10 images per content item, otherwise you're just overweighing your pages.You can change your default plugin parameter specify new value inside boncko tag, e.g.
Dir: /home/boncko/public_html/home/images/stories/mygallery inesistente
replace default gallery title with title different from default.
Available parameters:
| parameter | description | usage | From Version |
| width | thumbnails width | width=”200px” | 1.8 |
| height | thumbnails height |
height=”200px” | 1.8 |
| URl | thumbnail url. If you set numebre to 1 yu can specify a thumnail URS to set a pecific thumnail | URL=”http://www.mysyte.it/pippo.jpg” | 1.8 |
| number | · number numbers of thumbnails in article |
number=”6” | 1.8 |
| random | enable/disable random choose of thumbnails 0=disable 1=enable |
random=”1” | 1.8 |
| columns | number of columns to display more thumbnails 1 vertical layout 1000 horizontal layout 2,3,4…. Table layout. If you have 6 thumbnails and set columns to 3 you’ll obtain a table with 2 row an 3 cols | usage: columns=”3” | 1.8 |
| openmode |
type of control to open gallery 0 use a button, 1 use a link, 2 use thumbnail | openmode="0" |
1.8 |
| imglink |
use this to show / hide img url in gallery show 1 show img url ,0 hide img url |
imglink="1" | 1.8 |
| msg | text message linked to gallery display | msg=”Click to open gallery” | 1.8 |
| caption | ext to display when mouse roll over thumbnail | caption=”My holiday gallery” | 1.8 |
| music | the relative or absolute URL of a mp3 file to play during gallery show | music=”/mymusic/pippo.mp3” or music="http://mysite//images/stories/mymusic.mp3" | 1.8 |
| startimg | if set to "1" gallery sliding start from selected thumbnail | startimg="1" | 1.11 |
| loop | gallery looping enable 1, disable 0 | loop="0" | 1.11 |
| paused | set paused to 0 to start sliding automatic | paused="1" | 1.11 |
| maxscale | -1 for normal, images fill the stage, 0 for none never scale up, otherwise scale value |
maxscale="3" | 1.11 |
| bstyle | border style in table layout solid|double|grooved|dotted|dashed|inset|outset|ridge|hidden | bstyle="solid" | 2.1.0 |
| bcolor | bordercolor in table layout #000000..#FFFFFF|black|red|hinerit|,.... | bcolor="red" | 2.1.0 |
| bsize | border size in table layout in pixel | bsize="3" | 2.1.0 |
| padding | cell padding in table layout in pixel | padding="2" | 2.1.0 |
For ech qustion improvement suggestion contact us.
What’s NEW
Version 2.1.0
- bsize,bcolor,bstyle,padding parameters to manage table layout
Version 2.0.1
- filter to exclude images from gallery
- thumbnails autogeneration
Version 1.11:
- selection of starting img
- enable disable gallery loop
- autostart gallery enable disable
- zoom enable disable
Version 1.10:
- Text thumbnail position
- feed files extesion customization
Version 1.9:
· Freach translation
Version 1.8:
· URL parameter
Version 1.7:
· Thumbnails table layout
· This help
· Chage gallery files extension from rss to htm foe some http server without correct mime-type
· Added width height number random columns parameter
Version 1.6:
· Bacground Music
· Added music parameter



