Event Block
The Event block displays a single event's details on an event template page. It's designed for individual event pages where you want to showcase comprehensive event information including dates, times, locations, contact details, and action buttons.
Overview
The Event block is ideal for:
- Individual event detail pages
- Event template pages in your site structure
- Comprehensive event information display
- Event registration and ticket sales pages
- Event marketing and promotion pages
Block Features & Options
Display Modes
- Two-Column Layout: Hero image and event details side-by-side (when both are enabled)
- Single Column: Full-width content when only one element is shown
- Responsive Design: Automatically adjusts layout for different screen sizes
Layout Options
- Show Hero: Display event hero image (default: disabled)
- Show Name: Display event title (default: disabled)
- Show Region Name: Display associated region name (default: disabled)
- Show Description: Display event description with markdown support (default: disabled)
- Show Event Date/Times: Display event scheduling with recurring event support (default: disabled)
Content & Information Options
- Show Featured Status: Highlight featured events with star icon (default: disabled)
- Show Cost: Display event pricing information (default: disabled)
- Show Email: Display contact email address (default: disabled)
- Show Phone: Display contact phone number (default: disabled)
- Show Tags: Display event tags/categories (default: disabled)
- Show Ticket URL: Display ticket purchase button (default: disabled)
- Show Website: Display event website button (default: disabled)
Display Toggles
- Custom Template Name: Use custom template override
- Alignment: Full-width alignment support
How it Works
The Event block displays comprehensive event information in a responsive layout. It automatically detects the current event from the page context and shows relevant information based on your display settings. The block supports recurring events with expandable date listings, markdown formatting for descriptions, and intelligent layout that adapts based on which content elements are enabled.
How to Add & Configure
- Add the Event block to an event template page (not a collection page)
- Set Display Options: Choose which event information to show
- Configure Layout: Enable hero image and content sections as needed
- Add Contact Information: Enable phone, email, and website display
- Enable Action Buttons: Turn on ticket purchase and website links
- Customize Content: Adjust description, dates, and other details
Shortcode Usage
Basic Shortcode
[tourismo-event]
Complete Options Table
| Option | Type | Default | Description |
|---|---|---|---|
custom_template_name |
string | "" | Custom template override name |
align |
string | "" | Block alignment |
class_name |
string | "" | Additional CSS classes |
show_hero |
boolean | false | Display event hero image |
show_featured_status |
boolean | false | Show featured event indicators |
show_name |
boolean | false | Display event name |
show_region_name |
boolean | false | Display associated region name |
show_cost |
boolean | false | Display event cost |
show_event_date_times |
boolean | false | Show event dates and times |
show_description |
boolean | false | Display event description |
show_email |
boolean | false | Show contact email address |
show_phone |
boolean | false | Show contact phone number |
show_tags |
boolean | false | Display event tags |
show_ticket_url |
boolean | false | Show ticket purchase button |
show_website |
boolean | false | Show event website button |
Practical Examples
Basic Event Display
[tourismo-event show_name="true" show_description="true"]
Event with Hero Image and Details
[tourismo-event show_hero="true" show_name="true" show_description="true" show_event_date_times="true"]
Event with Contact Information
[tourismo-event show_name="true" show_email="true" show_phone="true" show_website="true"]
Event with Action Buttons
[tourismo-event show_name="true" show_ticket_url="true" show_website="true"]
Complete Event Display
[tourismo-event show_hero="true" show_name="true" show_region_name="true" show_cost="true" show_event_date_times="true" show_description="true" show_email="true" show_phone="true" show_tags="true" show_ticket_url="true" show_website="true"]
Content Displayed
The Event block displays:
- Hero Image: Event hero image in responsive layout (when enabled)
- Event Information: Name, region, cost, description
- Date and Time Details: Next event occurrence with recurring event support
- Location Information: Event venue details with addresses
- Contact Details: Email and phone with clickable links
- Tags: Event categories and classifications
- Action Buttons: Ticket purchase and website links
- Featured Indicators: Star icons for featured events
- Recurring Event Details: Expandable list of upcoming occurrences
The block automatically adapts its layout:
- Two-column: When both hero image and content are enabled
- Single column: When only one element is shown
- Responsive: Adjusts for mobile and desktop viewing
Related Blocks
- Events Block - Display event collections on collection pages
- Title Block - Page title display
- Description Block - Content description display
- Map Block - Interactive map display
- Socials Block - Social media links