Hero Section Shortcode

Display a featured hero/banner section for movies, series, or custom content.
Supports dynamic queries, sliders, autoplay, and fully customizable layouts.

Basic Usage

[movie_engine_hero]

Example

[movie_engine_hero post_type="movie_engine_movie" type="trending" limit="5" autoplay="true"]

Core Query

Controls which content is displayed in the hero section.

Parameter	Type	Default	Description
post_type	string	—	Content type (movie_engine_movie, movie_engine_series, etc.)
limit	number	5	Number of items to display
ids	string	—	Comma-separated post IDs
type	string	—	Predefined query (trending, new_releases, upcoming, top_rated)
orderby	string	date	Sorting method
order	string	DESC	Sort direction

Example

[movie_engine_hero post_type="movie_engine_movie" limit="5" orderby="date"]

Taxonomy Filters

Filter hero content using taxonomy values like genre, year, or language.

Parameter	Type	Default	Description
genre	string	—	Genre slug
year	string	—	Year slug
language	string	—	Language slug

---

Example

[movie_engine_hero genre="action" year="2024"]

Layout & Display

Control hero layout style and structure.

Parameter	Type	Default	Description
layout	string	slider	Layout type (slider, single)
style	string	default	Hero style variation
height	string	auto	Hero section height (px, vh)
overlay	string	true	Enable overlay background
overlay_opacity	number	70	Overlay darkness (0–100)

Example

[movie_engine_hero layout="slider" overlay="true" overlay_opacity="80"]

Slider Options

Only applies when layout="slider".

Parameter	Type	Default	Description
autoplay	string	false	Enable autoplay
autoplay_speed	number	3000	Delay between slides
loop	string	true	Infinite loop
pause_on_hover	string	true	Pause on hover
show_dots	string	true	Show navigation dots

---

Example (Slider)

[movie_engine_hero autoplay="true" autoplay_speed="5000" loop="true"]

Content Visibility

Control what appears inside each hero item.

Parameter	Type	Default	Description
show_title	string	true	Show title
show_meta	string	true	Show metadata (year, duration)
show_description	string	true	Show description
show_buttons	string	true	Show action buttons
show_rating	string	true	Show rating
show_views	string	false	Show views

Example

[movie_engine_hero show_description="false" show_views="true"]

Action Buttons

Control hero CTA buttons.

Parameter	Type	Default	Description
show_watch_now	string	true	Show Watch Now button
show_watch_later	string	true	Show Watch Later
show_trailer	string	true	Show Trailer button
show_add_to_list	string	true	Playlist button

Example (Buttons)

[movie_engine_hero show_watch_now="true" show_trailer="false"]

Styling

Parameter	Type	Default	Description
custom_class	string	—	Custom CSS class

Supported Values

post_type

• movie_engine_movie
• movie_engine_series
• movie_engine_season
• movie_engine_episode

type

• trending
• new_releases
• upcoming
• top_rated

layout

• slider
• single

Related Shortcodes

• movie_engine_library
• movie_engine_grid

Behavior Notes

• If ids is set → overrides all queries
• If type is used → overrides orderby
• The slider is disabled when there is only 1 item
• Uses featured image/backdrop as background

Example Shortcodes

Trending Hero

[movie_engine_hero type="trending" limit="5"]

Single Featured Movie

[movie_engine_hero ids="123"]

Hero Slider with Autoplay

[movie_engine_hero layout="slider" autoplay="true" autoplay_speed="4000"]