A small FAQ that will grow with questions that we find in the forums.
From the release after 2.1.1 onward, a help document will be available again through the Control Panel of RSgallery2. (It is already implemented in SVN 985 for Nightly Build users.)
and some questions about how to use RSG2:
Questions on RSGallery2 v3.x on Joomla 1.6+:
Can I migrate my images from RSGallery2 2.x on Joomla 1.5.x to RSGallery2 3 on Joomla 1.6?
Yes, you can with the J!1.5 component jUpgrade. See the topic "Converting from 1.5 to 1.6?" for more information.
How do I upgrade RSG2?
Reminder: if you are running a production website, you should be making and keeping backups.
- Backup your website files and database
- Backup your custom RSG2 templates if you have any
- Uninstall previous version from Joomla backend (Database and images will be kept, but RSG2 template directory will be removed)
- Install new version (install recognizes old version and will automatically upgrade)
- Install your custom RSG2 template if you have any.
- Open the Menu Item pointing to RSGallery2 in the menu manager and save, to update itemID.
What are the system requirements?
You need Joomla 1.5.x, PHP 5, all the Joomla! requirements and one of three graphics libraries: GD2, ImageMagick or Netpbm.
How can I help out?
- Download and test the latest Nightly Builds, give your feedback in the Nightly Builds forum.
- Translate the language file to your language if there isn't any, or improve the language file of your language. See the language forums for this.
- If you know PHP, apply for project membership at the Developer Lobby forum, or by PM-ing the staff. When applying, ensure you say who you are and how you can help.
- Answer questions on the forums.
- Help us make and improve a RSG2-Wiki (there is no Wiki at this point).
Yes RSG2 works with Joomfish. Here you can find the Content Element files (see Notes on the zip file for the versions used).
I can't upload large images or zip files.
PHP has a number of settings that limit file uploads. You will need to ask your hosting provider to change these settings in the file php.ini. If you are hosting your own site, please read the PHP manual on Handling File Uploads and Common Pitfalls. The following are suggested minimums:
The last three should be higher than the largest zip file you want to upload.
My batch uploads are incomplete.
See previous question. Increase max_execution_time until it works. The slower your server or the larger the file, the higher this number will need to be.
You can also set it to 0 which is infinity. However if you have a PHP script with a looping bug anywhere on your server, the web server process will need to be manually killed.
Error: GD2 doesn't support reading image type jpeg
The PHP version you are using does not have GD2 support. You need to ask your hosting provider to enable GD2. If they don't offer GD2 they should offer a different graphics library like ImageMagick or Netpbm. You can switch to one of these in the RSG2 configuration.
If you are hosting your own site and using linux, recompile PHP with GD2 support. If you are using windows, add this line to php.ini: extension=php_gd2.dll
If you have problems enabling GD2, google for help or install ImageMagic or Netpbm.
How do I translate RSG2 to my language?
We have a forum dedicated to this topic.
How do I get to the RSGallery2 control panel?
Go to the backend of your Joomla! installation and select Components -> RSGallery2.
How do I set my configuration?
Go to your RSGallery2 control panel. Then click the Configuration button.
What does Batch upload mean?
There are different ways to upload images, divided into "upload" and "batch upload". "Batch upload" means to upload multiple images at once. This can be done by using FTP (File Transfer Protocol) or with a zipfile. "Upload" means that you are uploading a single image at a time.
How do I create a gallery?
Go to the RSGallery2 control panel.
Click Manage Galleries.
Click New in the toolbar.
Enter a name for the Gallery (this is displayed on the website).
Enter a discription (optional).
Select a parent item. This way you can embed gallery in gallery with infinitive depth. If you just want to make it a main gallery select Top, if you want it to be a subgallery, select the gallery you want to make it a subgallery from.
After you have uploaded images into the gallery, you will be able to set one specific thumbnail as the thumbnail of that gallery. If you don't choose an image, the thumbnail will be chosen radomly.
Ordering can be changed after this item is saved.
Is you set Publish to No, the gallery will not be displayed on the frontpage, that includes its images and subgalleries.
How do I upload single images?
First, make sure you have created a gallery.
Go to the RSGallery2 control panel. Click on upload.
Pick a gallery. Choose the gallery in which you want the images to appear. Select it in the dropdown menu.
Enter a description for the file(s) to be uploaded at 'Generic Description' (optional). If more than one file is uploaded this description is used for all images.
Enter a title for the file to be uploaded (optional). If no title is given the file name is used as title.
Browse to the image you want to upload.
Click 'more files' to add more images, a title can be given for each image.
After this you will be taken to the images overview.
How do I batch upload images?
Go to the RSGallery2 control panel.
Click Batch Upload.
Now you have two options: FTP upload and Zip-file upload.
Zip-file: Look at the red message below the browse field. It says something about the upload limit. Make sure that when you pack your files in a zip-file, the file does not exceed this size.
Create the zipfile, make sure the filenames don't have spaces in them. Unix and Linux systems have a problem with that sometimes.
Go back to the RSGallery2 Control panel and browse to your zip-file, click on it and click on Open. After that, either select the gallery in which you want the images to end up in the drop down menu next to Specify Gallery, or select 'No, specify gallery per image in step 2'. Either way, press Next in the toolbar. RSGallery2 will start to upload the zipfile and unpack it. This can take a while.
Now we are at step 2 of the Batch upload process. RSGallery2 has uploaded the zip-file, unpacked it and is now displaying the images. You can delete images by checking the appropriate boxes, if you decide you don't want to upload that certain image. You can also enter description and titles (if you do not enter a title, the name of the file will be used as the title, minus the extension) and in which category the images have to go (if you selected this in the previous step).
Once you have done all that, hit Next in the toolbar. Click ok when prompted.
FTP: Upload the files to a certain ftp location on your server (location within the FTP base path mentioned). Go back to the RSGallery2 control panel and select the radiobutton next to 'FTP-path'. Enter the FTP-path in the field next to this, don't forget starting and trailing slash. After that, select in which Gallery you want the picture to end up in the drop down menu next to Specify Gallery, or select 'No, specify gallery per image in step 2'. Either way, press Next in the toolbar. RSGallery2 will start to upload the images. This can take a while.
Now we are at step 2 of the Batch upload process. RSGallery2 is now displaying the images. You can delete images from, if you decide you don't want to upload that certain image, change titles (if you do not enter any, the name of the file will be used as the title, minus the extension) and in which category the images have to go (if you selected this in the previous step).
Once you have done all that, hit Next in the toolbar.
There are images missing, what can I do?
Sometimes, during upload, images don't get uploaded or created correctly. This has most of the times to do with the server configuration. Or a user deletes display or thumbnail images on the server. You can handle this with the Consolidate database function.
Go to the RSGallery2 control panel, click Maintenance and Consolidate Database. Now a script will check which files are in the folders, and which ones are in the database and compare these. The results are displayed. When images were not created you can create them by clicking "Create missing images". Note: not all functions are implemented yet.
The slideshow isn't working, what can I do?
This is probably a result from missing images. You can handle this as stated in There are images missing, what can I do?.
Why is my zipfile filesize limited?
This is done by the host of the webserver in the php.ini file. If you are on a shared host, and you can't get to the php.ini file you can choose to enter the following into you .htaccess file in the root of you Joomla! install in order to bypass this restriction.
php_value upload_max_filesize 10M
If the server has the module mod_php4.c installed, the maximum upload value will now be 10MB.
How do I delete/ edit/ move images?
Go to the RSGallery2 control panel.
Go to Manage items.
If you have a lot of images it is wise to use the gallery-drop-down-filter to choose the gallery from which you want the images to be displayed. To do that, click on the drop down menu "- Top Gallery -" and select the gallery. If there are still too many images you may wish to search for the image using the filter field.
Deleting images: Select an image by checking the box in front of it and click Delete in the Toolbar. Multiple images can be checked.
Editing images: The image title and filename form a link: click the image that you want to edit. Here you can change the name and discription of the image as well as which gallery it belongs to, its order and if the image is published or not. Click save when you want to keep your changes or Cancel to disregard them.
Moving images: Select an image by checking the box in front of it and select the gallery you want to move the image to in the dropdown menu next to "Copy/Move", that says Select Gallery. Now click the button Move To..
Where can I find more information on user rights/ACL? (applies only to RSGallery2 v3.x on Joomla 1.6+)
Back to top
General information on Joomla's ACL can be found in the ACL Tutorial for Joomla 1.6. For users with Configure permission for RSGallery2 (that includes those with Super Admin permission) an extra Help button with information is available in RSGallery2's Control Panel: Backend > Components > RSGallery2 > Control Panel: the left Help button in the top right.