Skip to content
English
Submit a Request
Server Status
  • There are no suggestions because the search field is empty.

Photo Album Module Overview

The article explains how to use the Photo Album module in the admin to organize and display photos on a website. It covers accessing the module, creating and configuring albums, adding individual photos, batch uploading via ZIP, managing categories, frontend display modes (thumbnail grid, slideshow, photo detail, all albums grid), and how to link directly to an album.

In this article

Accessing the module

In the admin, navigate to Website > Photo Album in the left sidebar. The Albums tab displays all existing albums with their slug, display name, publish date, active status, and category. Click the pencil icon to edit an album or the external link icon to preview it on the live site.

Managing albums

Click the green + Photo Album button to create a new album. Each album has two tabs: Photos (for managing images) and Detail (for album settings).

The Detail tab contains the following fields:

  • Link – The URL used to identify this album in page links (e.g., annual-conference-2024). This value appears in the URL when linking to the album and should use lowercase letters and hyphens.
  • Category – Assigns the album to a category. Click the green + button to create a new category without leaving the page.
  • Hide in lister – When checked, the album will not appear on the public All Albums page but remains accessible via direct link.
  • Description – A short description shown below the album title on the front end.
  • Image – The cover image displayed when the album appears in an album grid. You can upload a custom image, delete the current one, or check Use first photo in album as cover image to automatically use the first uploaded photo.
  • Release Date / Release Time – Schedule the album to go live at a specific date and time.
  • Order – Controls the sort order of this album relative to others. Lower numbers appear first.
  • Active – Set to Yes to make the album visible to visitors. Set to No to hide it without deleting it.

Tip: Use Apply to save changes without leaving the page. Save saves and returns you to the albums list.

 

Adding photos

Open an album and click the Photos tab to see all images in that album. Click the green + Photo button to add a new photo. The form includes the following fields:

  • Album – The album this photo belongs to. Defaults to the current album but can be reassigned via the dropdown.
  • Title – The photo's display name, shown in detail views and used as alt text.
  • Caption – A short caption displayed below the photo in lightbox and detail views.
  • Link – An optional URL that makes the photo clickable. Use the Insert Link button to select an internal page, or type an external URL directly.
  • Order – Controls the sort order of this photo within the album. Auto-increments based on existing photos.
  • Active – Set to Yes to display the photo. Set to No to hide it without deleting it.
  • Description – A longer description shown in the photo detail view (not displayed in the thumbnail grid).
  • Upload Image – The image file to upload. Maximum file size: 122.8 MB.
  • Use this photo as album cover image – Sets this photo as the album's cover image used in album grids.
  • Generate new thumbnail – Automatically creates a thumbnail at the specified dimensions (default: 300×300 px). Recommended for most uploads.
  • Upload Thumbnail – Optionally upload a custom thumbnail instead of auto-generating one.

Batch uploading photos

The Batch Upload feature lets you add many photos at once by uploading a ZIP file. Photo titles are set automatically to match the filename of each image in the ZIP. Thumbnails are generated automatically at the size you specify.

To batch upload:

  1. In the album's Photos tab, click Batch Upload Photos.
  2. Select a ZIP file containing your images (max 122.8 MB total).
  3. Set the Thumbnail Size (default: 300×300 px).
  4. Choose a Resize image based on option:
    • No change – Uploads images at their original size. Use this if your images are already correctly sized.
    • Scale – Reduces all images by a percentage (e.g., 50% of original dimensions).
    • Size of one side – Resizes images so that the specified side (width or height) matches a pixel value. The other dimension scales proportionally.
    • Size of two sides – Resizes images to an exact pixel width and height.
  5. Click Upload to process the ZIP.
 

Tip: After a batch upload, you can edit individual photo titles, captions, and other details by clicking the pencil icon next to each photo in the Photos tab.

 

Categories

Categories let you organize albums into groups and control which albums appear on the public album index. Click the Categories tab at the top of the Photo Album module to manage categories.

  • You can also create a new category inline while editing an album by clicking the green + button next to the Category dropdown on the Detail tab.

Linking to an album

To link directly to an album's thumbnail grid from a page, menu, or button, use the following URL format – replacing your-album with the value in the album's Link field:

index.php?src=photo&srctype=lister&ref=your-album

 

Note: The album URL must match the value in the Link field exactly, including any spaces (which appear as %20 in the URL). The URL is not case-sensitive.

 
 

Related articles