Gallery FAQ

I keep getting errors about the REST API Path being invalid. What do I do?

There are two common reasons for this error. First of all, check if the REST API module is enabled (along with other three modules listed in the Requirements section) - log in as administrator into your Gallery system and navigate to the Modules screen. Make sure each of the required modules is selected with a check mark next to their name.

Second, make sure you have entered the REST API path correctly. The default path for the majority of Gallery installations is /index.php/rest, however if you have redirection rules hiding the "index.php" part from the URL, then your path would be /rest.

You can find out if you should include "index.php" in the REST API path by clicking the "Home" button in your Gallery. If the URL in the address bar shows "index.php", then your REST API path is definitely /index.php/rest, otherwise you have redirection rules in place - the REST API path is /rest.

Check if the REST API is working by entering the following URL in your web browser:
http://<my_domain>/<optional_gallery_app_path>/<REST API path>
In response you should get a blank page with two square brackets [] in the upper left corner, and the URL in your address bar should remain unchanged (to make sure no additional redirects take place).

Why am I getting upload errors?

First things first - make sure you can upload large photos using the Flash uploader in Gallery (the Add Photos link). If your uploads fail there, then it's definitely a configuration issue. Most likely, the memory limit for PHP is set too low so the Gallery application crashes when it attempts to process the uploaded image. Edit your php.ini file and set the memory_limit parameter to at least 64M:

memory_limit = 64M

If your PHP installation has the suhosin patch, the memory limit must be increased in the suhosin.ini configuration file as well :

suhosin.memory_limit = 64M

Restart Apache and try uploading again using the flash uploader.

If you are able to upload using the flash uploader, try uploading from Lightroom using the Gallery plug-in.

What is the maximum file size I can upload?

The maximum file size the Gallery application can process depends on your PHP settings.
If you are uploading very large photos (larger than 3600px long @ 100% JPEG quality - not sure why you'd want to do that), you need to increase the post_max_size parameter, which by default is set to 8MB.

post_max_size = 16M

If your PHP installation has the suhosin patch, the post limit must be increased in the suhosin.ini configuration file as well:

suhosin.post.max_value_length = 16M

What image settings should I use?

I recommend the following combo:

• JPEG Quality: 80-85%
• Resize to Fit (checked): Long Edge, 1200-1600 pixels
• Sharpen For (checked): Screen, Amount: Standard

This combination produces good quality JPEGs for viewing purpose, typically 600 - 900 KB in size.

Do I need to make any changes in my Gallery installation?

As explained in the Requirements section on the plug-in's home page, the following modules must be enabled using the Gallery admin interface:

The Lightroom Plugin Helper module can be downloaded using the link in the side bar.

What do Gallery Options do?

• Manage only my own albums - useful when you have multiple users uploading their photos to a single Gallery hosting environment. When this option is selected, each user will be access only the album they created.
• Validate "Image Sizing" settings before the upload - Enables the plug-in to make sure the size of output images is within the reasonable range of 500 - 10000 pixels. Smaller images will be look funny, and larger will take a very long time to upload and most likely would simply cause out-of-memory errors on the server. However, for practical reasons you should keep Gallery uploads within even a stricter range of 800 - 1600 pixels.
• Create develop snapshots on Export / Publish - with this option selected, each export or publish operation creates a Develop Snapshot (available in Lightroom on the Snapshots panel within the Develop module). This option is useful only if rely on Snapshots in your workflow.