Ozio Gallery Documentation
Da Il wiki di Joomla.it.
On this page, we want to tell all the advices, guidelines and instructions about using Ozio Gallery3 for Joomla 1.6 - 1.7 - 2.5. User's comments and contributions are welcome.
Ozio Gallery 3 is freely released under GPL license. If you find it useful please submit your vote and review on Joomla Extensions Directory (registration on JED is required). Your vote is important for Ozio Gallery growing. Thank you for helping.
Warning. Ozio Gallery3 is not fully compatible with Windows Servers yet, and some features could not work in such enviroments.
Indice |
Installation
Minimum requirements: Joomla 1.6, 1.7 or 2.5 (then PHP 5.2 or newer)
Download Ozio Gallery from the official download page.
Install Ozio Gallery component from Extensions -> Extension Manager, then upload your images on images/oziogallery3 directory. You can create more than one Ozio Gallery menu items, each one can be associated to a different skin. Available skins are Accordion - Carousel - Flashgallery - Flickrphoto - Flickrslidershow - Imagerotator - Tiltviewer - mediaGallery - Cooliris.
If you need a new category for your images, simply create a new menu item.
That's all. Isn't it simple?
Recommended images width is 640 pixels.
Before proceeding please ensure that files and directories permissions are correct using Components > Ozio Gallery 3. Here search for System information section.
Images upload
Images need to be uploaded using FTP on each directory previously assigned to the different menu items. By default the images/oziogallery3/ directory will be used. It already contains some sample images.
You can delete or upload additions images after menu item creation, and the current images structure will be shown on your site. This means that every time you upload new images to an existing gallery, you are not required to access your Joomla Admin side. There's nothing more easy and simple.
File names limitations - Ozio Gallery only accepts jpg, png and gif extensions for images. Please note that jpeg is not a valid extension and is not supported.
File names must not contain accented or special characters, such as à, è, ?, !, ", nor empty spaces, and they should not contain capital letters.
How to let you users upload images
- Using jsmallfib plugin you can allow some of your users to upload their images.
- Using JEPUM software, you can allow some of your users to upload images from their desktop's PC.
- Using Windows Live Writer and the Movable Type XML-RPC Plugin you can allow some of your users to upload images from their desktop's PC.
Using
Notes
After every modification of the menu item's parameter you are required to press Reset XML button before saving the menu item, in order to actually apply your modifications.
Ozio Gallery 3 doesn't resize images stored on server's filesystem, but it shows your images resized "on the fly". To improve load performances you are encouraged to resize images fitting your preferred size before uploading them.
For the skins who support it, to display images from Flickr it is required that permissions on your Flickr pictures allow public access to all people.
Gallery title
On the top of the gallery it is shown the title, initially taken from the menu item's name.
The gallery title can be changed in component's parameters using "Page Display Options" -> "Browser Page Title". Please note that this parameter will affect the Browser Page Title too, as its name suggest.
To completely disable the gallery title visualization, choose "No" on "Basic Options" -> "Title".
Ozio Gallery plugin
Our Ozio Gallery plugin gives you the ability to insert galleries within your Joomla articles or modules. All you have to do, is to add the code {oziogallery id} in your article or html custom module, paying attention to the position where you want the gallery to be displayed. Example: Top of your article ... {oziogallery 118} ... bottom of your article.
To know what the id of your gallery is, go to "Menu Manager" and search for your Ozio Gallery menu item. The last column contains the component id.
It is strongly discouraged using more than one plugin call per page. Keep it in mind especially when you are about to use it within custom html modules.
If you want to publish a gallery without showing a corresponding menu item in the main menu, for example to be used within an article or a module, you need an hidden menu.
Go to "Menu Manager" and add a new menu. Call it as you prefer. "Hidden menu", or something similar would be a good practice.
Create an Ozio Gallery item. Ensure that it's published and associate its "Menu Location" to your hidden menu.
Now your hidden item is active, but not displayed anywhere, because you didn't create a "menu module" for it.
How to create more different galleries on the same site
Every Ozio Gallery menu item points to a different folder, with different pictures inside. Set the proper folder for every menu item using "Required Settings" -> "Gallery folder path" field in its options.
How to remove references to Joomla.it at the bottom of the gallery
Ozio Gallery is released under GPL license, so you are allowed to freely change every piece of code inside it, but please consider that such link points to our italian Joomla community who shoulders big efforts every days supporting this project.
Known problems
Pictures are not shown in the gallery: Someone reported that trying to load pictures from a different domain, the gallery seems empty. To fix this, you need to upload a crossdomain.xml file on your website's document root.
Pictures are not shown when accessing the gallery without the www part on the URL and vice versa.: Please read specific section about cooliris skin if you experience this problem.
The left or right margin of the gallery appear cutted off: With some templates, it can happen that the gallery appears cutted off. The following CSS code solved this problem in many cases. Put in on your Joomla template.
#oziogallery {
margin-left:-30px !important;
}
Upgrade procedure
Before upgrading any extension, you are encouraged to perform a complete backup of your Joomla site.
A complete backup of all files and directories, united to a full database backup is enough to restore the whole website in case of problems.
Manual update
Uninstall previous version of Ozio Gallery, using "Extensions" -> "Extension Manager". Go to "Manage" tab, search for "Ozio", then ensure to select both items (component and plugin) and finally click "Uninstall" button.
After uninstall procedure, both Ozio Gallery menu items and uploaded images are still present.
Now your system is good for a fresh install.
After that, you should go to "Menu Manager". Here open then save and close every Ozio Gallery menu items, without any changes in order to reflect the changes happened to the component "id".
Automatic update
You can automate Ozio Gallery upgrading procedure using "Extensions" -> "Extension Manager".
Go to "Update" tab, then click on "Find Updates" button. If you see "Ozio Gallery" as available for upgrade, ensure to select it and finally click "Update" button. The latest version will be automatically downloaded and installed on your system.
Skins
Tilt 3D viewer Skin
For Tilt skin, the width of thumbnails depends on the width of the whole gallery. The bigger the gallery, the bigger the thumbnails inside.
Tilt skin can work with both local pictures and Flickr images.
When working with local filesystem its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
When working with Flickr the following settings are supported:
- User ID (example: 26100973@N05). To know your Flickr user ID, type your Flickr username here.
- Set ID - Group ID - Relevance - Tag mode - Tag - Text
How to manually set the rear side text of your images
Zip Download. Activate zip download in "General Gallery Settings" -> "Enable download/link mode". When active, a download link will be present on the rear side of each image. You are required to manually generate zip archives and upload them in images/oziodownload/ directory. Be sure you are using exactly the same name of the original image. Example: images/oziogallery3/foo.jpg should be zipped as images/oziodownload/foo.zip. As usually, avoid accented or special characters, empty spaces, and capital letters.
To avoid that thumbnails appear overlapped it's important to know the largest image in your gallery. Find it, and keep note of the biggest value between its width and height. Now write this value in "General Gallery Settings" -> "Max image size". It will be used to proportionately scale all thumbnails within this gallery. Its default value is 640 pixel, which means you should increase this value if you plan to upload larger images.
Flashgallery Skin
When working with local filesystem its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
When working with Flickr the following settings are supported:
- User ID (example: 26100973@N05). To know your Flickr user ID, type your Flickr username here.
This skin allows a better integration with your Joomla template, by making available various colour parameters in "General Gallery Settings".
Please remember that thumbnails on the bottom side are sent to the client in their original size, then processed client side, so that too many images on this gallery, may slow down the loading phase.
Futura Skin
This skin supports categories and sub-categories concept.
Directories within its working directory (default is images/oziogallery3/) are considered categories. Sub-directories within categories are considered sub-categories.
Choose your favourite transition effect between images in "General Gallery Settings" -> "Transition".
This skin has deep linking capabilities, so that you can link a category or even a single image within your gallery. Refer to your URL bar while you are browsing the gallery to know the URL pointing to single images or categories.
This skin allows a better integration with your Joomla template, by making available various colour parameters in "General Gallery Settings".
Carousel Skin
This skin works only with local filesystem and its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
If you want to set the same target link for all images go to "General Gallery Settings" and set "Action at click" parameter to "Compiled link", but remember to fill out the "Web link" property with your desired target URL in the form "http://...". Moreover, you can specify to open the link in the same window, or in a new window using "Target" property.
Otherwise if you want yo set a different target link for each image, go to "Basic Options" and set "XML method" parameter to "Manual XML", but remember to edit the xml file components/com_oziogallery3/skin/carousel/manual-xml/carousel.ozio with a text editor. Insert here correct images references and target links.
Imagerotator Skin
When working with local filesystem its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
When working with Flickr the following settings are supported:
- User ID (example: 26100973@N05). To know your Flickr user ID, type your Flickr username here.
Audio | This skin supports an audio soundtrack. Enable it in "General Gallery Settings" -> "Audio". Once enabled, you have to specify the file name (including path) of your mp3 soundtrack in "Audio path" parameter. The selected file must be placed on the server filesystem. For a good user experience, you are warned to use a lightweight mp3 file, encoded as mono at a low bitrate, like 64 kbps.
Watermark | This skin also supports watermarks. Enable it in "General Gallery Settings" -> "Logo". Once enabled, you have to specify the file name (including path) of your png logo in "Logo path" parameter, to be used as watermark on the upper-right corner of all images. As usually, the selected file must reside on the server filesystem.
Accordion Skin
This skin shows at least two images, using overlapped and transparency effects. It works only with local filesystem and its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
If you want to set the same target link for all images go to "General Gallery Settings" and fill out the "Web link" property with your desired target URL in the form "http://...". You can specify to open the link in the same window, or in a new window using "Target" property.
Otherwise if you want yo set a different target link for each image, go to "Basic Options" and set "XML method" parameter to "Manual XML", but remember to edit the xml file components/com_oziogallery3/skin/carousel/manual-xml/carousel.ozio with a text editor. Insert here correct images references and target links.
The "Starting photo" parameter indicates what's the image that has to be shown after page load. You must use a number as "image index" starting from zero.
Mediagallery Skin
This skin allows not only to view images, but also to play video and audio track. File types supported are .flv and .mp3. All media files can be organized under categories and sub-categories.
Directories within its working directory (default is images/oziogallery3/) are considered categories. Sub-directories within categories are considered sub-categories. Each directory (category) must contain files of the same type. Do not mix file types within the same directory.
The appearance can be changed in "General Gallery Settings" -> "Gallery style". You can choose between "black" and "white", depending on your Joomla template.
If you experience problems related to z-order or layers, like dropdown menu partially disappeared behind your gallery or something similar, enable the "General Gallery Settings" -> "Behind" parameter to keep your gallery always behind everything else.
Cooliris Skin
Cooliris skin can work with both local pictures and Flickr images, using an attractive 3D layout.
When working with local filesystem its default directory is images/oziogallery3. You can change it, but only images in selected directory will be used. Content in sub-directories will be ignored
When working with Flickr the following settings are supported:
- User ID (example: 26100973@N05). To know your Flickr user ID, type your Flickr username here.
- Set ID - Group ID - Text
Background image | Use "General Gallery Settings" -> "Background image path" to set a global gallery wallpaper. The selected file must be placed on the server filesystem. png and jpg file types are supported.
Thumbnails | You can manually specify a size in pixels for the thumbnails, rather than an automatic size. Use "Thumb width" and "Thumb height" under "General Gallery Settings".
If you choose this skin, please check if your gallery is working properly with both "http://yourdomain" and "http://www.yourdomain" URLs. If you encounter problems, add the following code to your .htaccess.
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{HTTP_HOST} ^yourdomain.xx
RewriteRule (.*) http://www.yourdomain.xx/$1 [R=301,L]
The effect is to redirect all http requests in the form "http://yourdomain" to the URL "http://www.yourdomain"
of course you have to change the value "yourdomain.xx" with your real domain name.
If the problem persists, you can add the following rules after "RewriteBase /":
#######redirect non www to www
#
RewriteCond %{HTTP_HOST} ^yourdomain.xx [NC]
RewriteRule ^(.*)$ http://www.yourdomain.xx/$1 [L,R=301]
#
#############end of redirection
Flickr PictoBrowser Skin
Flickr PictoBrowser skin can only work with Flickr images, so you are required to fill out all parameters referred to your Flickr account under "Required Settings".
The sample data you'll find here, won't work, so change them with your own Flickr account data.
After that, take a look to "General Gallery Settings" to fine-tune the size of your gallery and other minor graphical details.
Picasa PictoBrowser Skin
Picasa PictoBrowser skin can only work with Picasa images, so you are required to fill out all parameters referred to your Picasa account under "Required Settings".
The sample data you'll find here, won't work, so change them with your own Picasa account data.
After that, take a look to "General Gallery Settings" to fine-tune the size of your gallery and other minor graphical details.
Pup 'n Goo Skin
Pup 'n Goo Skin is no longer supported.
