The manual applies to
- Rokin Gallery v3.6.0
- PWFramework v1.8.0
After downloading the File:RokinGalleryPack UNZIP ME FIRST.zip and extracting them, you'll end up with 2 files, Rokin Gallery and PWFramework. Rokin Gallery is joomla Component and PwFramework is a Joomla Plugin. Install both. For the installation manual of the PWFramework check here
At the image below, you can see the first screen on the administration end. This screen can be very useful since it tells you if you can use Rokin Gallery.
5 checks are performed and not all have to be green.
- Simple xml : this one is required so should be green
- Php file get content :Either this one or Curl support should be green
- Curl support :Either this one or Php file get content should be green
- Zip archive: Only required if you install new addon's, most likely to be green sind's you've managed to install this component. If red you can still [[install addon's manually]
- File persmission: Some extensions might not work correct and you may experience problems installing new ones.
If the checks are off check the forum for a solution or request for support.
Setup the gallery
Rokin Gallery has native support for Picasa and for local files, by an extra addon you can get support for Flickr. The configuration for all galleries however is almost in the same fashion. Ill be describing the most commonly used namely picasa gallery.
Adding a new gallery is easy. Press the [configuration] button from the menu. Select the [Gallery Administration] tab and then select [Picasa Gallery Manager]
The Picasa Gallery Manager screen appears. Rokin Gallery supports multiple galleries. Each gallery is defined by a username in picasaweb. You can add edir or remove galleries in this screen as shown above.
Press the add button and the screen as below is displayed. Just add your username as you are using with picasaweb, fill in the name as you want to display the gallery to the viewers, set ordering and that is basically it. Press Apply and then the Load Gallery button. This will retrieve data from google containing information about your albums en pictures. Please do note that only public albums will be downloaded.
After a successful data retrieval all your albums will be displayed in the list. With the checkbox you can either enable or disable the album. A disabled album will not be rendered to the viewers.
Rokin gallery is not a live feed of your online picture gallery, it only updates if you say it to. Update is simple. Navigate to your gallery and press the load gallery button again. Data will be synced. If you have comments placed for instance by the comment addon don't worry, this data will not be removed unless you removed the picture from your gallery.
Some users have large galleries, and I mean large (over 50.000 pics). If you are such heavy user Pressing the Load Gallery button migth cause some time outs and out of memory problems. To overcome this problem Picasa Gallery has a way to do a partial loading mechanism. It goes in step sort of speak. You can do so by pressing the Load Albums button. This will retrieve just the album data, and no picture data. Now to get the picture data you'll notice (after the load album has been pressed and albums are succesfully retrieved). an update button on the right of each album. Press the update button will retrieve the picture data for this album. You can use it to to update the album after you added or removed pictures with the picasaweb backend or via picasa it self.
The sub extensions/Addon's
The sub extension are like the joomla modules. Some will be usable among all stages (Gallery, Album, Picture stage), some just at a specific one. This depends on where it was developed for. Sub extensions can be positioned just like modules. The sub extension will be positional within the joomla content area, not the joomla module positions. To help you decide an image is provided showing what is where. Placing a sub extension on a specific position can mess up your viewers page so always test on the front end to see how it looks.
To enable an extension or subextension just click on the cross/extension icon. If it shows you the red cross it means it is disabled. Clicking on it should change the icon, notifiing you that it is live. If you have installed a new extension always go to the settings by clicking on the name. This will show you a screen like above. Some extensions use this to roundup the installation that may be required. Press save to close the screen and go back, or press apply just to save the changes, so you can tweak the parameters a bit while looking on the frontpage for the result.
Rokin Gallery comes with a variety of default plugins, but more are available through the download section. When you downloaded a new extension you can easily install them by clicking on the install tab. Navigate to your newly downloaded extension and click on the install button to upload and install the plugin.
Adding the gallery to your site
Although this topic belongs to the Joomla documentation I describe it here since it's a frequently asked question.:
So I configured Rokin Galler but it does not appear on my site. How do I add it to my site?
Note: on the list of internal links you should find Rokin Gallery.
Sometimes I get an email (20 a day or so) saying that Rokin Gallery does not work. But there is no error or warning just a blank screen. Well I had that too on my online site once but not when I test locally. After a while I figured out why this is. Apparently most of the hosting providers turn on a php feature that suppresses warnings and it won't be displayed on your site. This is nice for visitors but it keeps us site administrators in the dark. Anyway here is a way to turn it on in the root of your joomla site there should be a .htaccess file if not just create on. and put the following line in to it save it.
php_flag display_errors on Now it shows what's wrong. You can turn it off again by removing it again. Hopefully now it shows what's wrong You can check the forum for solutions that already might be available. If you still have problems you can use the contact form. If you have an issue that needs to be solved quickly you can hire support, use the contact form for more information about that.