Venues List
Venues List displays JEM venues in a searchable and configurable frontend list. It is useful when visitors need to browse locations, filter venues by country, open venue calendars, view a map for a venue, or access venue detail pages.
This view can show venue images, venue type badges, city, state/county, country with flags, a map action, a venue calendar action and, for authorised users, an edit action.
When To Use This View
| Scenario | Recommended use | Why |
|---|
| Venue directory |
Show image, venue, city, country and map. |
Visitors can quickly identify and locate venues. |
| Country-specific venue list |
Preconfigure Filter Countries in the menu options. |
The page only lists venues from selected countries. |
| Multi-country site |
Enable the frontend Country filter. |
Visitors can switch between countries without separate menu items. |
| Venue-based calendar navigation |
Enable the Calendar column. |
Visitors can open the calendar for one specific venue. |
| Frontend venue maintenance |
Allow edit permissions and keep the Edit column available. |
Authorised users can manage venue data from the frontend. |
Access And Visibility
| Element | Behaviour |
|---|
| Published venues |
Visible to visitors according to access rules. |
| Unpublished venues |
Normally hidden, unless the user has edit or publish permissions. |
| Venue access level |
Controls which Joomla user groups can see the venue. |
| Edit permission |
Shows the Edit action for venues the user can edit. |
| Publish/edit-any permission |
Allows broader venue management from the frontend. |
Menu Options
| Option | Default | Purpose |
|---|
| Show City |
Yes |
Displays the city column and allows city-related search behaviour. |
| Show Country |
Yes |
Displays the country column, including country names and flags where available. |
| Show Venue Image |
Yes |
Displays the venue image column. |
| Show Types |
Yes |
Displays the venue type badge when a venue type is assigned. |
| Show Venue Map |
Yes |
Displays a View map action when the venue has coordinates. |
| Show Venue Calendar |
Yes |
Displays a link to the venue calendar. |
| Venue list field order |
image,venue,type,city,state,country,map,calendar |
Controls the order of visible columns. Missing fields are completed using the default order. |
| Filter Countries |
Empty |
Prelimits the venue list to selected countries. |
| Show Country Filter |
Yes |
Shows a frontend country selector so visitors can filter the venue list. |
| Introtext / Footer text |
Hidden by default |
Adds page-level text above and below the venue list. |
Column Order
The Venue list field order option accepts a comma-separated list of field names. This allows administrators to create a list layout that matches the purpose of the page.
| Field name | Column | Notes |
|---|
| image |
Venue image |
Shown only when Show Venue Image is enabled. |
| venue |
Venue name |
Main venue link. |
| type |
Venue type |
Shows the type badge if the venue has one. |
| city |
City |
Can be sorted and searched when enabled. |
| state |
State / County |
Useful for regional directories. |
| country |
Country |
Shows country name and flag where available. |
| map |
Map |
Shows a map action when latitude and longitude exist. |
| calendar |
Calendar |
Links to the venue calendar. |
The Edit column is permission-based and is always treated as an action column. It is not part of the normal column order list.
Country Filtering
Venues List has two different country concepts: an administrator-defined country restriction and an optional frontend country filter.
| Option | Who controls it? | Effect |
|---|
| Filter Countries |
Administrator |
Restricts the menu item to venues from selected countries. |
| Show Country Filter |
Administrator enables it, visitor uses it. |
Shows a country selector in the frontend list toolbar. |
| Active countries in JEM settings |
Administrator |
Controls which countries are available in selectors and filters. |
Search Filter
The normal list search can search by venue name, city, country and state/county, depending on the enabled columns and global JEM filter settings.
| Search mode | Searches in | Use case |
|---|
| Venue |
Venue name |
Find a known place quickly. |
| City |
Venue city |
Find all venues in a city. |
| Country |
Venue country code or country name. |
Useful on international sites. |
| State / County |
Venue state or county. |
Useful for regional directories. |
Map Action
The Map column shows a View map action when the venue has valid latitude and longitude values. The map opens as a focused action instead of forcing a small embedded map into the table.
| Venue data | Map result |
|---|
| Latitude and longitude available |
The View map action is shown. |
| Coordinates missing |
No useful marker can be created, so the map action is not shown or appears as unavailable. |
| Address exists but coordinates are missing |
The venue is readable in the list, but map display is not precise. |
Venue Calendar Action
The Calendar column links to a calendar view filtered to the selected venue. This is useful when visitors want to see all events hosted at one location.
| Use case | Result |
|---|
| Museum venue |
Visitors can open the museum’s event calendar. |
| Club venue |
Visitors can see upcoming concerts or sessions at that venue. |
| Conference venue |
Visitors can browse venue-specific talks, workshops or meetings. |
Recommended Configurations
| Page type | Recommended options | Reason |
|---|
| General venue directory |
Show image, type, city, country, map and calendar. |
Gives visitors a complete browsing experience. |
| Compact venue index |
Use order: venue,city,country. Disable image and map. |
Creates a lightweight text directory. |
| Country page |
Set Filter Countries and hide the frontend Country filter. |
The menu item itself defines the country. |
| International directory |
Show Country filter and keep country column visible. |
Visitors need country context and filtering. |
| Venue manager area |
Allow edit permissions and keep action columns visible. |
Trusted users can maintain venue data from the frontend. |
Troubleshooting
| Problem | Likely cause | Solution |
|---|
| Country is empty or shown as a dash. |
The venue has no country value. |
Edit the venue and select a country. |
| Country filter shows too many countries. |
All JEM countries are active. |
Use the JEM Countries settings to disable unused countries. |
| Map button is not shown. |
The venue has no latitude or longitude. |
Add GPS coordinates to the venue. |
| Edit icon is missing. |
The current user cannot edit that venue. |
Check JEM venue permissions and Joomla user groups. |
| Column order does not match exactly. |
A field is disabled or not listed in the order option. |
Enable the field and include it in the comma-separated order list. |
Related Project Notes
- #2130 covers venue list links and venue detail/calendar behaviour.
- #2151 discusses active countries and reducing long country selectors.
- #2131 relates to generating a complete JEM frontend menu.
- #2154 standardises intro and footer text options across JEM views.
