Applies to: JEM 4.5 and JEM 5.0, depending on the Joomla version used by the site.
The Venue Details view displays one selected venue and, optionally, the events assigned to that venue. It is the public detail page for a location stored in JEM.
Purpose
Use this view when a venue needs its own page. This is useful for museums, clubs, conference rooms, schools, theatres, galleries, sports facilities, or any other place where events take place.
The view can show the venue address, image, description, website link, map, attachments, custom fields, and a list of events at that venue.
Menu Item Type
| Menu Type | Internal View | Layout | Required Selection |
|---|
| Single Venue |
venue |
default |
One JEM venue |
When to Use This View
| Use Case | Why This View Helps |
|---|
| Venue profile page |
Shows the venue information and address on a dedicated page. |
| Events by venue |
Lists events assigned to the selected venue. |
| Location information |
Can show map, website, image, description, and attachments. |
| Venue landing page |
Useful when a venue is important enough to be linked directly from a menu. |
Main Output
Depending on the global JEM settings, venue data, layout, and user permissions, the view can display:
- Venue title
- Venue image
- Website link
- Street, postal code, city, state/county/region, and country
- Country flag, when available
- Venue custom fields
- Map link or embedded map
- Venue description
- Venue attachments
- Events assigned to the venue
- iCal export button for venue events
- Edit or copy buttons when the user has permission
Required Configuration
| Setting | Required | Description |
|---|
| Select Venue |
Yes |
Selects the venue shown by this menu item. |
| Published venue |
Usually yes |
The venue should normally be published and accessible to visitors. |
| Venue access |
Depends on site |
The visitor must have permission to view the venue. |
Menu Options
| Option | Description |
|---|
| Show Introtext |
Displays optional text above the venue content. |
| Introtext |
Text shown before the venue details when enabled. |
| Show Footer Text |
Displays optional text below the venue content and event list. |
| Footer Text |
Text shown at the bottom of the view when enabled. |
Global Settings Used by This View
Several display options are controlled in JEM Settings rather than directly in the venue menu item.
| Setting Area | Affects |
|---|
| Global Parameters > Venues |
Venue description, address, website link, and map service. |
| Global Parameters |
Frontend list behaviour, default limit, icons, and iCal settings. |
| User Control |
Frontend permissions for creating or editing venues. |
| Layout |
Responsive or legacy output, image handling, and common frontend layout behaviour. |
Map Behaviour
The Venue Details view can show a map link or an embedded map depending on the map service selected in JEM Settings. A map requires usable venue address data or coordinates.
For OpenStreetMap, JEM can display the venue location without a Google API key. For Google map modes, the required configuration depends on the selected map service.
Events at the Venue
The view can include a list of events assigned to the selected venue. This list follows the normal frontend event list behaviour, including filtering, ordering, limit box, and pagination where enabled.
Only events visible to the current visitor are shown. Event publication state, category access, venue access, date filters, and menu settings can all affect the result.
Attachments
Venue attachments can be shown below the venue information. This is useful for floor plans, access documents, technical sheets, parking information, or other venue-related files.
Custom Fields
Venue custom fields with content can be displayed on the venue page. They are useful for additional venue information such as room capacity, public transport notes, accessibility details, or internal classification data.
Permissions
If the visitor has the required permissions, JEM can show edit or copy actions for the venue. These actions are controlled by JEM permissions and Joomla access rules.
Recommended Setup
- Use this view for important venues that deserve their own page.
- Keep the venue address complete if maps are enabled.
- Add coordinates when the automatic map result is not precise enough.
- Use the venue description for visitor-facing location information.
- Use attachments for practical files such as access plans or venue documents.
- Use the venue events list when visitors should see what is happening at that location.
Troubleshooting
| Problem | Check |
|---|
| The venue page is empty or unavailable. |
Check that the selected venue exists, is published, and is accessible. |
| The map is not shown. |
Check the map service setting, venue address, coordinates, and API key if required. |
| No events are listed. |
Check event dates, publication status, categories, access levels, and filters. |
| The venue image is missing. |
Check that the image exists in the expected JEM image folder and is assigned to the venue. |
| Edit buttons are not visible. |
Check frontend venue edit permissions for the current user. |
Related Views
- Venues List
- Venue Calendar
- Venues Map
- Events List
- Event Details
Top Related GitHub Issues
The following GitHub issues are useful background when documenting or configuring the Venue Details view. Some of them affect the venue page directly, while others affect venue data, map output, or related frontend venue behaviour.
