Challenges Block
The Challenges block displays a collection of challenges from your Tourismo admin platform. It's designed for collection pages where you want to showcase challenges with filtering, rewards, and detailed challenge information.
Overview
The Challenges block is ideal for:
- Challenge listing pages
- Tourism websites showcasing local challenges
- Business directories with challenge calendars
- Regional challenge hubs
- Festival and conference websites
Block Features & Options
Display Modes
- Grid Layout: Default card-based grid display
- Carousel Layout: Horizontal scrolling carousel (via template override)
Layout Options
- Show Image: Display challenge hero images (default: enabled)
- Show Name: Display challenge titles (default: enabled)
- Show Dates: Display challenge scheduling information (default: enabled)
- Show Rewards: Display challenge rewards information (default: enabled)
- Show Description: Display challenge descriptions with "Read More" link (default: enabled)
Content & Filter Options
- Show Tags: Display challenge tags/categories
- Tag Filters: Filter challenges by specific tags
- Tag Category: Filter by tag category
- Match Records By Tag Category: Enable tag category matching
- Filter Records By Region: Filter challenges by region (default: enabled)
- Selected Region ID: Manually select a specific region to filter by (string; only available when not on region/itinerary/listing/event pages)
Display Toggles
- Custom Template Name: Use custom template override
- Button Text: Customize "Read More" button text (default: "Explore")
- Alignment: Full-width alignment support
How it Works
The Challenges block fetches challenges from your Tourismo admin platform and displays them in a responsive grid layout. Challenges are automatically sorted by featured status and start date. The block supports interactive filtering, reward detection, and region-based filtering.
Region / Guide Filtering:
- On region pages: Automatically filters by the current region; children/parents/lineage modes are available
- On guide pages: Automatically filters with
filter[guide_id]— challenges with tasks targeting listings/events in the guide (bounds + shared tags), or the guide itself. Hierarchy modes are hidden; this is guide membership, not region-target filtering - On itinerary/listing/event pages: Automatically filters by the associated region
- On other pages: Manually select a region or guide
- Manual override: Selecting a specific region or guide always takes precedence
Filtering Modes
When filter_records_by_region is enabled, the sidebar Filtering Mode dropdown maps to region_filtering_mode / selected_region_id.
On Single Region pages (and other non-guide automatic context)
| Mode | Description | Shortcode value |
|---|---|---|
| Use current page region (automatic) | Uses only the current page's region | "" (attribute omitted) |
| Use current region and children (descendants) | Current region plus every descendant | "current-and-children" |
| Use current region and parents (ancestors) | Current region plus every ancestor | "current-and-parents" |
| Use current region and entire lineage | Ancestors, current region, and descendants | "current-and-lineage" |
| Select a specific region or guide | Exact pick; ignores automatic context | Set selected_region_id |
On Single Guide pages
| Mode | Description | Shortcode value |
|---|---|---|
| Use current guide (automatic) | Guide membership via filter[guide_id] (tasks on guide listings/events, or the guide itself) |
"" (attribute omitted) |
| Select a specific region or guide | Exact pick; ignores automatic context | Set selected_region_id |
Guide vs region: On guide pages, filtering uses guide membership (same bounds + tags idea as listings/events), not region hierarchy or
target_type: Region. Hierarchy modes are not offered on guide pages.
Manual selections always clear region_filtering_mode and work on any page.
How to Add & Configure
- Add the Challenges block to a collection page (not a template page)
- Configure the Linked Page: Select a challenge template page for individual challenge details
- Set Display Options: Choose which challenge information to show
- Configure Filters: Set up tag and region filtering as needed
- Customize Layout: Adjust image display and content visibility
Shortcode Usage
Basic Shortcode
[tourismo-challenges]
Complete Options Table
| Option | Type | Default | Description |
|---|---|---|---|
linked_page_id |
string | "" | Required - ID of the challenge template page |
custom_template_name |
string | "" | Custom template override name |
tag_filters |
array | [] | Array of tag IDs to filter by |
tag_category |
string | "" | Tag category to filter by |
match_records_by_tag_category |
boolean | false | Enable tag category matching |
filter_records_by_region |
boolean | true | Filter challenges by region or guide |
selected_region_id |
string | "" | Manually select a region or guide to filter by |
region_filtering_mode |
string | "" | Region hierarchy modes when automatic region context applies (current-and-children, current-and-parents, current-and-lineage). Not used on Single Guide pages (automatic guide targeting only). |
class_name |
string | "" | Additional CSS classes |
align |
string | "" | Block alignment |
button_text |
string | "Explore" | Custom button text |
show_image |
boolean | true | Display challenge images |
show_name |
boolean | true | Display challenge names |
show_dates |
boolean | true | Show challenge dates and times |
show_rewards |
boolean | true | Display challenge rewards |
show_description |
boolean | true | Display challenge descriptions |
show_tags |
boolean | false | Display challenge tags |
show_stats |
boolean | false | Load stats onto each card after page load |
stats_category |
string | "" | Stats category slug (blank = summary) |
Practical Examples
Basic Challenges Display
[tourismo-challenges linked_page_id="123"]
Challenges with Manual Region Selection
[tourismo-challenges linked_page_id="123" filter_records_by_region="true" selected_region_id="5"]
Current Region Plus Descendants
[tourismo-challenges linked_page_id="123" filter_records_by_region="true" region_filtering_mode="current-and-children"]
Filtered Challenges by Tags
[tourismo-challenges linked_page_id="123" tag_filters='["45", "67"]' show_tags="true"]
Custom Template Challenges
[tourismo-challenges linked_page_id="123" custom_template_name="challenges-carousel"]
Content Displayed
The Challenges block displays:
- Challenge Cards: Each challenge appears in a responsive card layout
- Challenge Images: Hero images with aspect ratio 1:1 (when enabled)
- Challenge Information: Name, dates, rewards, description
- Tags: Challenge categories and classifications (when enabled)
- Reward Indicators: Reward information for challenges (when enabled)
Challenges are automatically sorted by featured status (featured first) and then by start date (earliest first).
Related Blocks
- Challenge Block - Individual challenge display for template pages
- Itineraries Block - Display itinerary collections
- Listings Block - Display business/attraction listings
- Regions Block - Display region collections
- Map Block - Interactive map display