Documentation: Client Response Gallery

The Client Response Gallery Lightroom plugin adds a custom export provider to Adobe Lightroom Classic. It lets you upload photos directly from Lightroom to a gallery on your Joomla site — no manual FTP, no browser uploads. You can also create new galleries without leaving Lightroom.

System Requirements

The plugin does not support Lightroom CC (cloud-based) or Lightroom on mobile — it requires the desktop Lightroom Classic application.

Installation

Step 1 — Download and extract the lrplugin

Download the lrplugin from https://www.joomill-extensions.com/downloads/client-response-gallery

and unzip it

Step 2 — Place the plugin on your machine

Copy the `ClientResponseGallery.lrplugin` folder to a location on your local disk. A recommended location:

Windows: `C:\Users\[YourName]\Documents\Lightroom\Plugins\`
macOS: `/Users/[YourName]/Documents/Lightroom/Plugins/`

Step 3 — Add the plugin in Lightroom

1. Open Lightroom Classic.
2. Go to File > Plug-in Manager (shortcut: `Ctrl+Alt+Shift+,` on Windows / `Cmd+Option+Shift+,` on macOS).
3. Click Add in the bottom-left corner.
4. Browse to the `ClientResponseGallery.lrplugin` folder and click Add Plug-in.
5. The plugin appears in the list with a green status indicator and the label Client Response Gallery Uploader.
6. Click Done.

Configuration

The plugin is configured per export preset — settings are saved inside the Lightroom export dialog, not globally

Opening the export dialog

Select one or more photos in Lightroom, then either:

• Go to File > Export (`Ctrl+Shift+E` / `Cmd+Shift+E`), or
• Right-click the selection and choose Export > Export...
  
  In the export dialog, scroll to the top and find the Export To dropdown. Select Client Response Gallery.

Plugin settings

Two sections appear at the top of the export dialog.

Section: Client Response Gallery

Section: Create New Gallery

Use this section to create a gallery directly from Lightroom. All fields are optional except Title.

Image format settings

The plugin enforces the following output settings — these cannot be changed:

• Format: JPEG
• Color space: sRGB
• Video export: disabled

All other Lightroom export settings (file quality, long edge, sharpening, metadata stripping) work as normal and apply to the rendered JPEG before upload.

Uploading Photos

1. Select the photos you want to upload in Lightroom.
2. Open the export dialog (**File > Export**).
3. Make sure **Export To** is set to **Client Response Gallery**.
4. Enter your **Server URL** and **API Key** if not already saved in the preset.
5. Click **Load Galleries** and select the target gallery from the dropdown. Alternatively, create a new gallery using the **Create New Gallery** section.
6. Adjust Lightroom's image quality settings as needed (size, sharpening, etc.).
7. Click **Export**.

Lightroom renders each selected photo as a JPEG and uploads it to the gallery one by one. A progress bar shows the current file and overall count. After all uploads complete, a summary dialog confirms how many photos were uploaded successfully and lists any files that failed.

Rendered temporary files are deleted from disk immediately after each upload — no local copies are left behind.

Delete a gallery

• Delete media files when deleting a gallery: when enabled, the photo files are removed from the server
• Delete folder when deleting a gallery: when enabled, the entire gallery folder is removed

Client selections submitted for this gallery are always deleted.

Troubleshooting

"Please enter a Server URL and API Key first"

The Server URL or API Key field is empty. Fill in both fields before clicking **Load Galleries** or **Export**.

"Could not load galleries" / "No response from server"

• Verify the Server URL is correct and includes the protocol (`https://` or `http://`).
• Confirm your Joomla site is reachable from the machine running Lightroom.
• Check that the API is enabled in the component settings and that the API key matches exactly (no extra spaces).

"No published galleries found on the server"

The API key is valid and the server is reachable, but there are no published galleries yet. Create a gallery in the Joomla backend first, or use the Create New Gallery section in the plugin.

"Could not delete gallery: Gallery not found"

"Upload completed with errors"

One or more photos failed to upload. The error dialog lists the filenames and reason for each failure. Common causes:

• The gallery no longer exists on the server.
• A file exceeded the server's maximum upload size (`upload_max_filesize` in PHP, or Joomla's media settings).
• A network interruption occurred mid-upload.

Photos that uploaded successfully before the error are saved to the gallery and do not need to be re-uploaded.

Checking the log file

The plugin writes a log file that can help diagnose unexpected errors. The file is named `ClientResponseGallery.log` and is located in the Lightroom log folder:

Windows: `C:\Users\[YourName]\AppData\Roaming\Adobe\Lightroom\Logs\`
macOS: `~/Library/Application Support/Adobe/Lightroom/Logs/`

How It Works (Technical Summary)

The plugin communicates with the component's API using standard HTTP requests authenticated via the `X-API-Key` header.

For full API reference, see API Documentation