Recently I upgraded my gallery from 2.2.6 to major release 2.3, which was released on 2008-OCT-19. I was excited about this release mainly because of the Media RSS support in gallery's slideshow module, which is used by cooliris (formly named "PicLens") - a perfect way to watch pictures on web.
The update process of gallery was fine without any major error (except some language file missing). But, I was dissatisfied to see slideshow module was not functioning.
Going to Site Admin > Slideshow gave me following error:
After searching through google and gallery, I found, people referring this issue as webserver being behind the firewall or for somereason my server is restricting the web access to get the required PicLens files.
I was desperate and decided to install the module manually. Step-by-step instruction is given below :
Step 1: (optional if you already have the slideshow module installed)
Download Slideshow module from http://downloads.sourceforge.net/gallery/g2-module-slideshow-2.0.0.zip and upload the extracted file to your gallery installation root.
Step 2: Download required cooliris PicLens files
There are two files required by this module according to http://gallery.menalto.com/versioncheck/piclens/release
version=18.104.22.1687 jsUrl=http://lite.piclens.com/releases/22.214.171.1247/lite/piclens_optimized.js swfUrl=http://lite.piclens.com/releases/126.96.36.1997/lite/PicLensLite.swf
both of these files can be downloaded directly visiting the site (don't forget to rename 'piclens_optimized.js' to 'piclens.js'). For your convenience I've included them with this article.
Step 3: Upload these two files('piclens.js' & 'PicLensLite.swf') to gallery
Gallery's module related files resides inside your gallery-data folder which is by default g2data. So, you should upload these files to
[Gallery2-ROOT]/g2data/plugins_data/modules/slideshow/ (Assuming your installation data dir is named "g2data")
Step 4: Update database to indicate that you already installed the files
Please note: Your table and column name may vary depending on the table name prefix and or case-sensitivity of database.
Before you add piclens record, you can make sure if there is not already existing record/variable value for PicLens by executing following SQL statement:
SELECT * FROM `g2_PluginParameterMap` WHERE `g_pluginType`='module' AND `g_pluginId`='slideshow';
In "g_parameterName" column there should not be any value starting piclens.*******
Insert plugin variable and value to table "g2_PluginParameterMap". Execute following SQL statement :
INSERT INTO `g2_PluginParameterMap` (`g_pluginType`, `g_pluginId`, `g_itemId`, `g_parameterName`, `g_parameterValue`) VALUES ('module', 'slideshow', '0', 'piclens.version', '188.8.131.527');
If you are using phpMyAdmin, then you can navigate to the "g2_PluginParameterMap" table and click insert button to insert data. Check the screen shot.
Step 5: Finally clear your gallery cache and web-browser cache to reflect your changes
Go to Site Admin > Maintenance and "run" the Delete database cache action to delete old cache and force gallery to reload fresh information.
Clear your web-browser cache. In most browsers, you can hold SHIFT button and press reload button to reload updated content.
Now, browse to any album at your gallery and click on the slideshow icon/link - vola!!! you've got PicLens slideshow.
Thanks for being with me.
Please add comments if you face any problem or if it really helped you.
THE NEXT STEP:
Now that you've slideshow module installed, the first thing you would encounter while viewing the piclens slideshow is the slow-load time for pictures. This will happen if you have 5MP-10MP/hi-res images. By default, even if you have built resizes for your hi-res images, cooliris-slideshow module will pick the original image format.
To overcome this, suprsidr aka Wayne Patterson, owner of FlashYourWeb was kind enough to tweak the slideshow module to resolve this issue.
You can find more about this at: http://gallery.menalto.com/node/82813
His tweaked module can be found here: http://www.flashyourweb.com/filemgmt/index.php?id=21