Shortcode Library

This page is the working reference for BHAB shortcodes. Update the registry in the BHAB Shortcode Library snippet whenever a shortcode is added, removed, renamed, or expanded.

Event Feeds

Flexible Feed Engine

Shortcodes

[ht_happenings]

[ht_weekend]

What it does

Reusable event feed engine for weekend, week, and month landing pages. Supports locked city feeds and category include/exclude filters.

Attributes

Attribute	Description
`range`	weekend, week, month, or custom
`title`	Optional page heading
`heading_label`	Optional eyebrow label like "This Week"
`city`	Locks feed to a city slug like rapid-city
`show_city_filter`	1 or 0
`allow_url_city_override`	1 or 0
`include_categories`	Comma-separated category slugs
`exclude_categories`	Comma-separated category slugs
`days_ahead`	Used for rolling week/custom behavior
`start_date`	Custom range start, YYYY-MM-DD
`end_date`	Custom range end, YYYY-MM-DD

Examples

[ht_happenings range="weekend" title="What’s Happening This Weekend in the Black Hills"]

[ht_happenings range="week" city="rapid-city" title="What’s Happening This Week in Rapid City"]

[ht_happenings range="month" title="This Month in the Black Hills"]

[ht_happenings range="week" city="rapid-city" include_categories="livemusic" exclude_categories="comedy,karaoke,trivia,music-bingo" title="Live Music in Rapid City This Week"]

[ht_happenings range="week" include_categories="theater" title="Theater & Stage This Week"]

[ht_weekend]

Notes

Best choice for city-specific and date-range landing pages.
Keep [ht_weekend] as a backward-compatible alias if older pages already use it.

Event Embeds

Single Event Embed

Shortcodes

[ht_event_embed]

What it does

Displays a full event card with image, schedule, venue, optional excerpt, and action buttons.

Attributes

Attribute	Description
`id`	Required. Event ID or linked post ID.
`show_excerpt`	yes or no
`excerpt_words`	Number of words to show when excerpt is enabled
`series_label`	Optional secondary button label like "View Series"
`series_url`	Optional URL for a series or related page

Examples

[ht_event_embed id="3427"]

[ht_event_embed id="3427" show_excerpt="no"]

[ht_event_embed id="3427" show_excerpt="yes" excerpt_words="18"]

[ht_event_embed id="3427" series_label="View Series" series_url="/series/lost-cabin-after-dark/"]

Notes

Best for featured article embeds or standalone event callouts.
This is the larger visual card version.

Grouped Event Embed

Shortcodes

[ht_event_embed_group]

What it does

Displays one shared event card for multiple event IDs, useful for runs, repeat dates, or grouped showtimes.

Attributes

Attribute	Description
`ids`	Required. Comma-separated list of event IDs or linked post IDs.
`title`	Optional custom card title
`show_excerpt`	yes or no
`excerpt_words`	Number of words to show when excerpt is enabled
`button_label`	Optional primary button text
`button_url`	Optional primary button URL
`series_label`	Optional secondary button label
`series_url`	Optional secondary button URL
`show_calendar`	yes or no. When yes, shows downloadable calendar options for each date

Examples

[ht_event_embed_group ids="123,124,125"]

[ht_event_embed_group ids="123,124,125" title="Lost Cabin After Dark"]

[ht_event_embed_group ids="123,124,125" button_label="View Full Schedule" button_url="/series/lost-cabin-after-dark/"]

[ht_event_embed_group ids="123,124,125" show_calendar="yes"]

Notes

Useful when one event spans multiple dates but each date exists as its own event entry.
Can fall back to a shared schedule button when ticket URLs are not available.

Mini Event Embed

Shortcodes

[ht_event_embed_mini]

What it does

Displays a compact event embed with a small thumbnail, title, date, time, venue, and See Event / Add to Calendar actions.

Attributes

Attribute	Description
`id`	Required. Event ID or linked post ID.
`thumbnail_size`	Optional thumbnail width in pixels. Best range is roughly 90 to 140.
`show_venue`	yes or no

Examples

[ht_event_embed_mini id="3427"]

[ht_event_embed_mini id="3427" thumbnail_size="110"]

[ht_event_embed_mini id="3427" show_venue="no"]

Notes

Built for article use where the full card feels too tall.
On small screens the thumbnail stacks above the text instead of staying to the left.

Main Calendar

Calendar Filters

Shortcodes

[ht_calendar_filters]

[ht_calendar_results]

[ht_calendar_filters_intro]

[ht_calendar_active_filters_label]

What it does

Core BHAB calendar discovery engine. URL-based filters for keyword, venue, city, category, date range, and exclusions.

Attributes

No attributes listed.

Examples

[ht_calendar_filters]

[ht_calendar_active_filters_label]

[ht_calendar_results]

Notes

These work together on the main calendar page.
Do not mix their responsibilities into standalone feed pages.

Homepage / Editorial

Latest Posts

Shortcodes

[ht_latest_posts]

What it does

Outputs recent blog posts with title, date, author, and excerpt.

Attributes

Attribute	Description
`count`	Number of posts to show
`category`	Optional category slug filter

Examples

[ht_latest_posts count="3"]

On the Scene Editorial Blocks

Shortcodes

[ht_featured]

[ht_radar]

[ht_field_notes]

[ht_on_the_scene]

What it does

Editorial post feeds used for featured stories, radar items, field notes, and combined layouts.

Attributes

No attributes listed.

Examples

[ht_featured]

[ht_radar]

[ht_field_notes]

[ht_on_the_scene]

Notes

These pull from WordPress post categories, not Events Manager events.

Homepage / Events

Mini Upcoming Feed

Shortcodes

[ht_mini_upcoming]

What it does

Shows upcoming events grouped by day with a compact layout.

Attributes

Attribute	Description
`limit`	How many events to show

Examples

[ht_mini_upcoming limit="6"]

Venues

Venues Directory

Shortcodes

[ht_venues_directory]

What it does

Alphabetical venue directory with search and copy-link tools.

Attributes

No attributes listed.

Examples

[ht_venues_directory]

Venue Feed

Shortcodes

[ht_venue_feed]

What it does

Outputs a standalone venue page/feed layout with venue details and upcoming events.

Attributes

No attributes listed.

Examples

[ht_venue_feed]

Notes

This area has known overlap/conflict in the architecture doc. Keep naming and ownership clear.

Submissions

Public Event Submission

Shortcodes

[ht_submit_event_public]

What it does

Front-end public event submission form for pending review.

Attributes

No attributes listed.

Examples

[ht_submit_event_public]

Venue Submission

Shortcodes

[ht_submit_venue_request]

What it does

Front-end venue submission form for new venue requests.

Attributes

No attributes listed.

Examples

[ht_submit_venue_request]

Editorial / Beat Drop

Shortlist

Shortcodes

[ht_shortlist]

What it does

Beat Drop editorial calendar feed built around curated shortlist events.

Attributes

No attributes listed.

Examples

[ht_shortlist]

Notes

This is Beat Drop-specific. Do not use it as a generic public event feed.