Quick-Start Guide

Last Updated on Monday, 13 February 2012 09:40

Only a few steps are necessary in order to get JoomGallery running on your Joomla based website. Here's a short overview over them, but they are described in the proximate article:

Step 1: Installation of the Component

The system requirements of JoomGallery are the following (please check them afore trying to install the gallery):

The installation of JoomGallery is done via the installer of Joomla! as it is for all other Joomla components, too.

If you are not familiar in installing components for Joomla! please check this link.

Please note: Updates are done in the same way: Simply install the new package without uninstalling the gallery afore or else you would lose all the data.

If the installation was successful you should see a page like this one:


Please don't click it away, but jump to step 2 first.

Step 2: Installation of Desired Language Files

If the installation was successful there should be offered two buttons for you: 'Start now!' and 'Languages'. If you want to use the gallery in English language, please simply click on 'Start now!' and jump to step 3.

Otherwise, if you want to see the gallery in any other language please click on 'Language'. With that you will be redirected to 'Help and Information' manager of JoomGallery (you are able to come back to this manager at any time by clicking on the correspondent administrator menu item of JoomGallery).
In this manager you can find all languages the gallery has already been translated into. If your language isn't in the list unfortunately there aren't any language files for this language yet. In that case you would have to use the gallery in any other available language for now or you could create the translation by yourself. Please This email address is being protected from spambots. You need JavaScript enabled to view it. if you are willing to do so.

If you have found your language please click on the corresponding flag. If a certain functionality (cURL-Library) is enabled on your server the language files will be installed and applied to the gallery automatically by this click. Please simply return to the Admin Menu of JoomGallery by selecting it in the 'Components' menu. You should see the gallery in your language then (for some languages there are only frontend language files available yet, so the backend isn't translated, but you should see the gallery translated in the frontend later on in step 6 after creating a menu item).

If cURL isn't installed on your server you will be redirected to the download page of the requested language files after clicking on the flag. Please download the language pack (a zip file) and install it via the installer of Joomla! just like JoomGallery itself afore. JoomGallery will have access to the language files with that.

The gallery always automatically uses the language which is chosen in Joomla!'s language manager!
You don't have to do anything else after installing the language pack.

Please remember to also update the language files after each update of JoomGallery.


Step 3: Choosing Image Folders

By default JoomGallery stores all uploaded images into sub-folders of 'images/joomgallery/' (these are created automatically). If you don't want to change that please simply jump to step 4.

Otherwise, if you want to move the image directories into another folder (for example since you don't want the string 'joomgallery' to appear in your image paths) please move the three folders you find in 'images/joomgallery/' to another place with the help of an FTP client (Note: At the moment the images cannot be stored outside of the Joomla! root directory!).

After that please go to 'JoomGallery' -> 'Configuration Manager' in the backend. In the tab 'General Settings' -> 'Paths and Directories' the image directories will be marked red then. Please correct them according to the new locations and press 'Apply' in the toolbar above until all directories are marked green again.
If you have problems with that please contact us in the forum.


Step 4: Creating a Category

Before you are able to upload any images at least one category has to be created.
For this please go to 'JoomGallery' -> 'Category Manager' in the 'Components' menu or select the category manager in JoomGallery's admin menu.

After that please search the 'New' icon in the toolbar above and click on it. With that the edit view for a category will be opened.

Please enter a name for the new category into the field 'Title' and have a look at the toolbar above again. Now there should be a button called 'Save' with which you are able to create the category. For now you don't have to fill anything else into the fields in the edit view.

After clicking on 'Save' you will be redirected back to the list of categories which should show the just successfully created category.

Category Manager Save Category

Step 5: Uploading Some Images

Now that a category is created you can start uploading images. For that please go to 'Image Upload' in the sub-menu of JoomGallery where you can select several images (or only one) you want to upload (don't worry, mass uploads will be possible with the other upload managers, too). After doing this you have to type in a general name for the images into the field labeled with 'Generic Title' and to select a category above it. So you need to select the one created afore. Please don't bother about the other fields yet, but simply click on 'upload'.

If there aren't any errors you will be informed about the successfully uploaded images. You can go to 'Image Manager' in order to check or edit them.

Image Upload

Step 6: Creating a Menu Item

Until now we worked only in the backend, but of course finally you want to see the gallery in your page on the frontend. For that we have to create a menu item for JoomGallery.

In order to do that please go to 'Menus' -> 'mainmenu' (or any other already created menu) and click on the toolbar button 'New'.

You will see a list of the installed components then, so please click on 'JoomGallery'. With that the list will be expanded to show the available views of JoomGallery with their layouts. For starting please select the default layout of the view 'Gallery (default)'.
After clicking on the layout you will be able to type in the displayed name of the menu item into field called 'Title'. Please do so (for example simply 'Gallery') and press 'Save' in the toolbar.

If you go to your site in the frontend then, a new menu item in your selected menu should have appeared. After clicking on it you will see the gallery view of JoomGallery in your site which shows the category you created.

Please don't hesitate to click on each link in the gallery and see what happens.

Menu Manager Add Menu Item Save Menu Item

Step 7: Setting Up the Gallery

Since most probably at the moment the gallery doesn't look like or have the functionality you want it to have you will have to configure the gallery.
Most of this is done in the configuration manager with all of its available settings. There are very many as you have probably seen before.
It is very important that you really have a look at all the options and read all descriptions there in order to learn what the gallery is able to do.

We recommend to start with the settings in tab 'General Settings' -> 'Image processing' in order to determine the size of the automatically resized images. Please change the settings until the images perfectly fit into your template, but please note that a change of these settings will only be applied to images which are uploaded after the change (images uploaded before can be resized with the new settings by using the 'Recreate' button in image manager).

Then, play with all the other settings until the gallery works like you want it to work!

It is possible to have a very clean displaying of the whole gallery as well as to have very many options and community functions enabled.

If you still have any questions please use the search function in our forum, most probably some one had the same question afore!
If not, please don't hesitate to start a new thread!

Have fun with JoomGallery!