BonckoWall Cooliris Plugin instructions

Last Updated on Thursday, 09 June 2011 13:09 Tuesday, 16 June 2009 20:02

The concept is simple.
You want to add image galleries inside your articles (content items)!

Imager from your filesystem :

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

{ bonckowall}/mygallery/{/bonckowall} or
{ bonckowall backgroundColor="#FF0000"}/mygallery/{/bonckowall}, 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.

4. If showLink parameter is set to Customizzable , in gallery folder you will find a php file for each medi than you cna modify to customize media link

5. If showDescription is enable you can create a txt file with image name and its content will apears on selected image eg: img1.jpg --> img1.jpg.txt

Images from  Flickr:

1. Define the criteria for image search: query string, album, user, group.
   
   To find an album number, open a Flickr set in your browser. The album number can be copied from the last part of the URL, e.g.: http://www.flickr.com/photos/thomashawk/sets/72157594567688537/
   
   To find a group ID, open a Flickr group and then click the RSS feed button in your browser's address bar. The group ID can be copied from the URL, e.g.: http://api.flickr.com/services/feeds/groups_discuss.gne?id=645450@N20&lang=en-us&format=rss_200
   
   
2. Set source="1" fkey="search|user|group|album" fvalue="Stringa_di_ricerca|utente|IDGruppo|IDAlbum"
   e.g. { bonckowall source="1" fkey="search" fvalue="winter"}{/bonckowall}
   e.g. { bonckowall source="1" fkey="album" fvalue="thomashawk" fvalue2="72157594567688537" }{/bonckowall}

Images from  Picasa:

1. Define the criteria for image search: query string, album, user
   
   The user and album parameters can be found in your Picasa album's URL, e.g.: the last example above corresponds to this URL: http://picasaweb.google.com/jajonet/BLIJDORP/
   album=BLIJDORP user=jajonet
   
   
2. Set source="2" fkey="search|user|album" pvalue="query_string|user" [pvalue2="IDAlbum"]

es { bonckowall source="2" pkey="album" pvalue="jajonet" pvalue2="BLIJDORP" }{/bonckowall}

or { bonckowall source="2" pkey="search" pvalue="red cars" }{/bonckowall}

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:
{ bonckowall}/folder/subfolder/othersubfolder/{/bonckowall}.
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
{ bonckowall}/mygallery/¦/mygallery2/{/bonckowall}

You can change your default plugin parameter specify new value inside boncko tag,
e.g. { bonckowall backgroundColor="#FF0000"}/mygallery/{/bonckowall} replace default gallery bacground with title different from default.

Available parameters:

param	description	usage	from version
width	gallery width in pixel usage	width="600"	1.0
height	gallery height in pixel usage	height="400"	1.0
align	gallery allign:left|center|right	align="center"	1.2
backgroundColor	Background gallery color. This can be specified in either of the usual HTML color formats (#FFFFFF or #FFF), or as a hexidecimal number (0xFFFFFF) e.g. red=#ff0000  Overrided by style patameter	backgroundColor="#ff0000"	1.0
backgroundImage	Specifies a background image for the wall. The background image can be a PNG, GIF, or JPG. The background image covers the background color	backgroundImage="http://www.boncko.it/logo.jpg"	1.0
targetURL	Adds a custom button in the lower right corner of the toolbar linked specified URL. Need imageURL parameter	targetURL=http://www.boncko.it/	1.0
imageURL	Image of a custom botton linked to targetURL. Need targetURL parameter	imageURL="http://www.boncko.it/logo.jpg"	1.0
descriptionHeigh	Sets the percentage height of the name and description overlay when items are selected	descriptionHeigh="45"	1.0
glowColor	Changes the color of the glow around the selected cell (Default is white). The color string can be specified as it is for backgroundColor param	glowColor="#000022"	1.0
numRows	Sets how many rows of images to show in the UI. Note that as you show more rows, the wall is more CPU intensive and may run slower for older computers	numRows="5"	1.0
numColl	Sets how many columns of images to show in the UI. Less Columns -> larger thumbnails	numColl="3"	2.1
showChrome	Shows or hides the bottom toolbar background values: true | false	showChrome="false"	1.0
showDescription	Shows or hides the item description overlay values: true | false	showDescription ="false"	1.0
showReflections	Shows or hides the reflections under the images. Hiding the reflections will improve performance. values: true | false	showReflections ="true"	1.0
showEmbed	Shows or hides the Embed Code,Twitter and FaceBook button from bottom bar . values: true | false	showEmbed="true"	1.0
showSearch	Shows or hides the Search button. values: true | false	showSearch="false"	1.0
showNavArrows	Shows or hides the left/right navigation arrows values: true | false	showNavArrows="false"	1.0
style	Sets the theme to use for the wall. This sets up different default background colors and button appearances values: none | black | dark | light | white . Overrides backgroundColor	style="light"	1.0
itemGUID	numer of images preselect a gallery startup , 0= noone	itemGUID="3"	1.0
source	Images source, 0 local, 1 flickr , 2 picasa	source="2"	2.0
fkey	search key on flickr. user,group,album,search	fkey="search"	2.0
fvalue	Value of selected fkey: userid flickr groupid flickr albumid flickr search string How to get keys	fvalue="estate al mare"	2.0
pkey	search key on picasa user,album,search	pkey="album"	2.0
pvalue	Value of selected pkey userid picasa search string	pvalue="myuserid"	2.0
pvalue2	If pkey is album pvalue must be user owner the album and pvalue2=album id how to get key	pvalue2="myalbumid"	2.0
showTitles	enable or disable image title showing: true|false	showTitles="true"	2.3
showLink	show  hide or customizelink to original media: 0:no link 1:link to origina media 2:link customizable via php file 3:link all media to link parameter	showLink="0" hide link	2.4.0
link	URL  to link to all media if showLink parameter is set to 3	link="http://www.boncko.it"	2.4.0
cellWidth	Thumbnail width in pixel	cellWidth="600"	2.5.0
cellHeight	Thumbnail height in pixel	cellHeight="500"	2.5.0
cellSpacingX	This number is a fraction of the Thumbnail width (e.g., 0.18 == 18% of Thumbnail width).	cellSpacingX="0.9"	2.5.0
cellSpacingY	This number is a fraction of the Thumbnail height (e.g., 0.18 == 18% of Thumbnail height).	cellSpacingY="0.01"	2.5.0
cellBorder	Adds a White Border to each thumbnail 0=no border	cellBorder="3"	2.5.0
showItemEmbed	Show/Hide Twitter an FaceBook buttons from image right side.values: true | false	showItemEmbed="true"	2.5.3
sortorder	images sort order	0 = no order 1 = File Name 2 = FIle Path 3 = Date 4 = Date inverse 5 = Random 6 = FileName inverse
linkTarget	image's link open target	_blank=new page _top=same page	2.5.5
browseChache	enable disable bowser gallery caching	0=cache disable 1=cache enable	2.5.5
introText	enable disable plugin in intro text	0=disable 1=enable	2.5.8

Note:

1 - Plugin try to create a file called crossdomain.xml in your joomla home directory, if filecreation fails you have to create it:
File name : crossdomain.xml
File contents: 
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM  "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
<allow-access-from domain="*.cooliris.com" secure="false" />
</cross-domain-policy>

2 - You can create an content item (article) contain only a gallery ank limk it to a menu item obtaining a component like behavior

if you like to stay updated subscribe to Gruppo BonckoNews
Email: or Visit it