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.

The gallery password field is empty

That is deliberate, and it does not mean the password is gone. Gallery passwords are stored scrambled as of version 1.2.3, so the stored password cannot be shown. As of version 1.3.0 the field therefore starts empty when you edit a gallery, and it masks what you type. Leave it empty to keep the current password, or type a new one to replace it. Saving the gallery without touching the field keeps the protection in place. To remove a password, set the Remove password switch below the field to Yes and save. That switch is only shown for a gallery that has a password, so its presence also tells you the gallery is protected. Because a password cannot be read back, write it down when you hand it to your client.

Versions 1.2.3 up to 1.3.0 showed a long string of characters in this field instead. That was the scrambled stored value. Update to 1.3.0 or later to get the empty field.

A client has to enter the gallery password again

As of version 1.2.3 an unlocked gallery is remembered on the server for the length of the visitor's browser session, instead of in a cookie that lasts for days. Closing the browser ends that session, so the password is asked again on the next visit. This is what makes the password protection actually hold: the old cookie could be set by the visitor themselves. The Cookie Duration (Days) setting under Advanced options now only applies to the favorites cookie.

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 API returns a short error without any detail

As of version 1.2.3 the API answers with a short message such as Database error instead of the internal technical text, which used to expose table and column names to anyone calling the endpoint. The full detail is written to the Joomla log, so look there when you need to know what actually went wrong.

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.

A notice about my license or download key appears in the administrator

As of version 1.3.0 the component shows a notice on its administrator screens when no download key is entered, when your PRO license has expired, or when it is about to expire. The notice is only shown to users who are allowed to manage extensions, never to visitors of your site, and it cannot be closed: it disappears once the situation is solved. Without a download key, follow the link in the notice to System > Update Sites and enter your key there, see "Download Key". With an expired or expiring license, renew it through the link in the notice. The component keeps working in all three cases, but you receive no updates or support without a valid license.

My custom CSS no longer contains a closing style tag

As of version 1.3.0 the Custom CSS setting under Advanced options is checked before it is placed in the page, and a closing </style tag is removed from it. Normal CSS is not changed. The field is meant for CSS rules only, so there is no reason for that tag to be there.

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. A new gallery saved without a password is open to everyone. To take the password off an existing gallery, use the Remove password switch: leaving the field empty keeps the current password. The password is stored scrambled and the unlock is kept on the server for the visitor's session, so note the password down when you set it: you cannot read it back later.

Does the password also protect the photo files themselves?

Not on its own. Photo files are served straight from the images folder, so someone who knows the address of a photo can open it without ever seeing the gallery page. That is why a gallery created in version 1.2.3 or later stores its photos in a folder with a random suffix, which makes that address impractical to guess. Galleries created before 1.2.3 keep their existing folder. See "Upload Your Photos" for the details and for what happens with imported photos.

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_PHOTOS}/{MAX_PHOTOS} 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.

What is the Joomill offer message in the administrator?

As of version 1.3.0 the component can show a Joomill offer on its administrator screens while a promotion runs, for example around Black Friday. It is only shown in the administrator, never to visitors of your site. Close the message with its close button and that promotion stays hidden in that browser.