Part 1: Installation
To install the gallery, first download the gallery component
from the downloads page.
Go to Joomla’s extension manager:
Upload the gallery component to Joomla’s extension manager:
Choose Ignite Gallery from the components menu:
Part 2: Profile Creation
Most gallery settings are stored in a profile. You can apply a profile to a gallery, and that gallery will use the settings in the profile. Most sites just have one profile, and this profile is applied to all galleries. However you can create multiple profiles, and apply one profile to one set of galleries, and apply a different profile to another set of galleries. This way different sets of galleries can have different settings. You can also apply a different profile to the gallery module, or to the gallery content plugin.
When you change the profile settings, all the galleries that use the profile will use the new profile settings. This means you can update the settings for many galleries with one change in the profile.
To create a profile, go to the profiles section, and choose the new profile button:
Each profile has a lot of settings. These settings, along with some notes, are displayed below:
- If you choose the watermark with text option, please upload a font.ttf file to administrator/components/com_igallery/fonts/font.ttf. You can upload any kind of ttf font file, but it must be renamed to font.ttf.
The menu tab of the profile has settings for the ‘menu images’. The menu images are these ones.
The main image tab of the profile has settings for the big image in the gallery.
- If preload large images is set to yes, the gallery will grab a large image in the background, once every 0.7 seconds. This way the images will be ready to view when a thumb is clicked on.
The main thumbnails tab of the profile has settings for the thumbnails in the gallery.
- To have mutiple rows of thumbnails, please put a number like 2 or 3 or into the images per row setting.
The main other tab of the profile has settings for all the other features that can be adjusted in the gallery.
- For Jcomments integration, please install the Jcomments extension.
- To set up facebook comments, please see this page.
The lightbox image tab has settings for the big image in the lightbox. The lightbox can be turned on or off in this tab. The rest of the settings in this tab are similar in function to the settings in the main image tab of the profile.
The lightbox thumbnails tab has settings for the thumbnail images in the lightbox. The settings in this tab are similar in function to the settings in the main thumbnails tab of the profile.
The lightbox other tab has settings for the remaining features in the lightbox. The settings in this tab are similar in function to the settings in the ‘main other’ tab of the profile.
- If shink lightbox to window size is set to yes, when the lightbox is first displayed, it will be displayed at a size that is smaller than the browser window. As the images swap, the lightbox will remain at the same size. The purpose of this feature is to make sure the lightbox will fit inside the window of the browser.
You can create multiple profiles for different parts of the site.
Part 3: Category Creation
In Ignite gallery, the words ‘category’ and ‘gallery’ are used inter-changeably. A category can have images uploaded to it, and it will display as a gallery. A category can also have sub-categories assigned to it, and these will display as links when the category is displayed.
To create a category, go to the categories section, and choose the new category button:
Fill out the category fields and choose the Save button.
You can create an unlimited amount of categories, and have an unlimited amount of subcategory levels.
Part 4: Image Adding
Choose the manage images link to upload images to a category:
Choose the add files button and select multiple files to upload. You can also drag files to the uploader if you are using a browser that supports html5 drag and drop (all browsers support this apart from Internet Explorer).
Choose the start upload button. The images will be uploaded one at a time. If resize before upload is turned on in the component options - upload tab, the image size will be checked, and the image will be resized before uploading it if it is to big.
After uploading the images they will appear in a list. Within this list you can publish/unpublish images, rotate images, delete images, or change the image ordering.
Choose the edit link in the image description to edit the image details.
Here you can edit the individual fields for each image. Choose the save and next button to go directly to the next image in the gallery.
Part 5: Component Options
The component options control the site wide options for the gallery. This is different than the options in the profile, which just apply to any categories that use that profile. To access the component options, you need to be have the ’configure’ permission allowed for Ignite gallery. In the defualt Joomla set up, only super admins have this permission. Admins need to have the ’configure’ permission manually set to yes.
Go to the categories section, and choose the options button:
- By defualt allow frontend image management is set to no, if you want to allow frontend registered users to be able to manage galleries and upload images, this paramater needs to be set to yes.
- The register link is where the gallery will rederict if the gallery has restricted access, Joomla, Jomsocial and Community Builder are options.
- If report image is turned on in the profile, please enter an email address to recieve notifications here.
- If collect image view stats is on, each time an image is viewed, a request is sent to the server to count that image view. This is nescessary for the most viewed images module to work. This also makes more requests to the server. If you have a busy site and limited server resources, you may want to set this to no.
- The facebook user id and appid are used when setting up facebook comments, please see this page for more info.
- If you are upgrading from 3.2.12 or before, and you have likes and facebook comments that need to be kept after upgrade, please choose yes for use legacy urls. The upgrader will do this automatically. Otherwise please choose no.
The second tab controls the moderation of images that are uploaded from frontend users. Here you can choose to turn on moderation for images uploaded in the frontend, and for categories created in the frontend.
If you have moderation on, you will see the orange and blue approve and un-approve icons where you can approve new images/categories added.
In the frontend form fields, you can control what fields will show in the frontend gallery management pages.
In the new item defualts tab, you can choose what the default setting for new categories and new images are.
- For the File Upload option, plupload and html 5 form are options. Plupload is the recommended option as it will upload images one at time. The html 5 form is a fallback if plupload has problems. It will upload multiple images, but they are sent in one request, which means less images can be sent in one go. It is recommended you use html5 as pluploads first preference and flash as the second. Html5 is most likely to be able to upload without any server issues. Flash works well with most servers, it will be used if Internet explorer is the browser, as internet explorer does not have html5 file upload.
- If you are doing frontend uploading, and your site already puts a link to jquery in the source html, please choose no for Include jquery.
- It is recommended you set resize before upload to yes, and have the width height about 2500/2000 pixels. Web servers have a limited amount of memory and can not usually resize very big images. As your computer has much more memory available, it is better to do the resize before uploading.
- If Show import from server is set to yes, then under the image uploader, there will be a list of folders, and you can choose which folder to import images from.
- If import exif or import iptc description is set to yes, the gallery will import the exif/iptc description into the image’ description field on upload.
- It is recommended you have resize before upload on, and have the resize before upload width/height smaller than the maximum width/height of image stored on server. If you have resize before upload off, the gallery stills needs a max width/height for the image it stores on the server. Otherwise it could end up storing 100 images that are all 5MB each and this takes up too much server space. It is recommended you keep this value at 2600 width and 2100 height.
- For information about using the original image, please see this page.
Part 6: Access Control
The component wide access control settings can be set in the permissions tab of the component options. These settings control what backend administrators can do, and and what frontend image management tasks can be done.
- If you want frontend registered users to be able to manage galleries, please make sure allowed is set for ‘access administrator interface’. This will just allow users access to the Ignite gallery admin tasks, it will not give them access to login to the Joomla backend.
- To have users just edit their own galleries/images, please set edit to No and edit own to yes.
- To have frontend users be able to upload images, but not be able to create categories, please choose Inherit(Not allowed) for create in the global component options, but in the profile access control settings (below), choose allowed for create.
- The frontend user must be logged in to manage galleries or upload images. Public users can not access the frontend gallery management functions.
The profile access control settings let you apply access control to a specific set of categories, rather than setting access control for the whole component. So you could make 2 profiles, in the first profile, you could leave all the options as inherit, and the global access control settings for the component will be used. You can apply this profile to one set of categories. Then you could make second profile, and set some of the permissions to allow, and apply this profile to a second set of categories. This could be used to make sure frontend users can only edit some categories.
Part 7: Comments and Ratings
Comments can be turned on in the profile - ‘main other’ tab, and in the profile - ‘lightbox other’ tab:
For Jcomments integration, please install the Jcomments extension, and then choose ‘Jcomments’ in the profile settings. Once this is done, a Jcomments block will appear for each image. In the backend of Jcomments you can manage the comments made in the gallery:
For facebook comments information, please see this page.
Ratings can be turned on in the profile - ‘main other’ tab, and in the profile - ‘lightbox other’ tab:
In the component options, you can turn guest rating on or off, and set the interval before a site visitor can rate again.
In the ratings section you can administor the ratings:
Part 8: Make a Menu Link to a Gallery.
Choose Joomla’s ‘Add a Menu Item’ link.
Choose Ignite Gallery - Display Category as the type.
Enter a name for the menu item, and choose a category that will be linked to. If you want to display all your top level categories, please make a category that is a parent of your top level categories, and link to this parent.
Part 9: Frontend Gallery Creation.
Choose Joomla’s ‘Add a Menu Item’ link.
Choose Ignite Gallery - Frontend Image Management as the type.
Enter a name for the menu item and save the menu item.
Please set Allow Frontend Image Management to yes in the component options.
The group that is going to upload must have allowed for ‘access administrator interface’ and the tasks which they are going to do. Please see here for more info on access control. Setting ‘access administrator interface’ to yes will not allow the user to login to the Joomla backend, it just allows access to the Ignite gallery admin tasks.
When visiting the link in the frontend of the website, the logged in user will see a list of categories. If the access control permissions are set to yes for edit own, and no for edit, then only galleries created by the logged in user will show.
Frontend users can create new categories.
Images can be added and managed in the manage images page of each gallery.
Each image’s details can be edited in the frontend.
You can control what fields the frontend user can access in the component options:
And you can set a default option in the component options: