Listing Albums for Listeo: Client Guide
Client guide for structured listing albums, package limits, collaborative uploads, moderation, permissions, and frontend display.
What the plugin adds
Standard Listeo galleries are useful, but large listings often need better organization. This plugin lets a listing group media into albums such as Rooms, Menu, Exterior, Events, Team, Before and After, Portfolio, Facilities, or any structure that fits the directory.
Requirements
- WordPress with Listeo installed.
- Administrator access.
- Listing packages configured if you want package-level album limits.
- A valid plugin license when required by your package.
Initial setup
- Install and activate the plugin.
- Open the Listing Albums settings screen.
- Enable the listing tab if albums should appear as a public listing section.
- Decide whether collaborative uploads are allowed.
- Create or edit your Listeo packages and configure album permissions and limits.
- Test one listing from the frontend and the admin screen.
Package settings
Albums can be controlled at package level. This lets you create pricing tiers such as no albums, limited albums, unlimited-style premium packages, or collaborative upload packages. Review package rules carefully before selling or assigning packages.
| Package control | What it affects |
|---|---|
| Albums enabled | Whether listings using the package can use album features. |
| Albums limit | How many albums the listing owner can create. |
| Images per album | How many images can be placed inside each album. |
| Total images limit | Maximum images across all albums. |
| Collaborative uploads | Whether contributors can upload images to the listing albums. |
| Daily collaborative limit | How many collaborative uploads are allowed per day. |
| Require approval | Whether uploaded images must be moderated before publication. |
Creating albums
- Open a listing that has album access through its package.
- Create an album with a clear title and optional description.
- Add images from the media library or upload new images.
- Choose the cover or featured image when needed.
- Drag images into the correct order.
- Preview the public listing and confirm the album layout.
Collaborative uploads
Collaborative uploads are useful for venues, agencies, event organizers, restaurants, photographers, and teams where more than one person contributes media. Use approved contributors instead of opening uploads broadly. If approval is enabled, uploaded images remain pending until a moderator approves them.
Moderation workflow
- Open the moderation screen or the frontend moderation page if configured.
- Review pending images for quality, relevance, permissions, and duplicates.
- Approve valid uploads or reject unsuitable uploads.
- Confirm that approved images appear in the correct album.
Shortcodes
The plugin includes shortcodes for album display and moderation workflows. Site builders can place these on controlled pages when the default listing tab is not enough.
| Shortcode | Purpose |
|---|---|
[listeo_albums] | Displays listing albums where the plugin can determine the listing context. |
[listeo_albums_moderation] | Displays a moderation interface for pending collaborative uploads. |
Quality checklist
- Album titles are short and useful.
- Cover images are clear and visually consistent.
- Package limits match your pricing model.
- Collaborative uploads are limited to trusted contributors.
- Pending uploads are reviewed before public display.
- Mobile album layout is checked before launch.
Troubleshooting
| Problem | What to check |
|---|---|
| Albums do not show | Check plugin activation, listing package rules, the public tab setting, and whether the listing has albums. |
| Owner cannot add more images | Check images-per-album and total-image package limits. |
| Contributor upload is blocked | Check collaborative upload settings, contributor permissions, daily limits, and approval rules. |
| Pending uploads never appear | Approve them in moderation or disable approval only if that matches your policy. |