Documentation: Client Response Gallery
Troubleshooting & FAQ
Troubleshooting
A gallery isn't visible on the site
Check that the gallery's Status is set to Published under Components > Client Response Gallery > Galleries. If the gallery has a password, visitors need to enter it before the gallery content is shown, that's expected behaviour, not a bug.
Watermark, resizing or quality settings aren't applied to a photo
These settings only apply to photos added through Batch Upload (in the backend or via the API). Photos added by FTP, the Joomla media manager, or the one-by-one New photo screen skip this processing entirely, see "Upload Your Photos" for the full list of upload methods and what each one does.
The client or photographer didn't receive a confirmation email
Check that Send Client Email and/or Send Photographer Email are enabled under Mail options. Also check the receiving mailbox's spam folder, and confirm your Joomla site's mail configuration (System > Global Configuration > Server) is set up correctly, since this component uses Joomla's own mail settings.
The ZIP download link doesn't appear
The ZIP link on the thank-you page and in emails only appears when Create selection ZIP is enabled under Selection options, and the corresponding "Include ZIP link" switch is enabled for that page or email.
The API returns 401 Unauthorized
Check that an API key is generated under Components > Client Response Gallery > Options > API, and that the exact key is sent in the X-API-Key request header, with no extra spaces. See "API Documentation" for the full reference.
The Lightroom plugin can't load galleries
Verify the Server URL includes the protocol (`https://` or `http://`), that your Joomla site is reachable from the machine running Lightroom, and that the API key matches exactly. See "Adobe Lightroom Plugin" for the full troubleshooting list.
A selection warning message isn't showing
Check the Minimum Photos or Maximum Photos value is not set to 0 (0 disables that warning) under Selection options, and check the Warning message position setting includes the location you're expecting it in.
FAQ
Do I need a Download Key?
A Download Key is only needed for the PRO version, to enable automatic updates. See "Download Key" for how to find yours.
Can I password-protect a gallery?
Yes. Set a Password when creating or editing a gallery. Visitors need to enter it before they can view the gallery. Leave the field empty to make the gallery open to everyone.
Can I limit how many photos a client selects?
Yes, under Selection options (global) or per gallery under Gallery Selection options. Set Minimum and/or Maximum Photos, with custom warning messages using the {min}/{max} placeholders.
What happens to photo files when I delete a gallery?
That depends on the Delete Files with Gallery and Delete Folder with Gallery switches under Advanced options. Both default to disabled, so files are kept on the server unless you turn them on.
Can I import photos directly from Adobe Lightroom?
Yes, using the dedicated Lightroom Classic export plugin. See "Adobe Lightroom Plugin" for setup and "API Documentation" for the underlying API it uses.
Can I customize the confirmation and notification emails?
Yes. Both the client thank you email and the photographer notification email have editable subject and body templates under Mail options, with placeholders for the gallery title, client details and selected photos.