Movie Library Shortcode

Display movies, TV series, seasons, or episodes in a fully customizable grid or slider layout with advanced filtering, search, AJAX loading, and monetization support.

🧾 Basic Usage

[movie_engine_library]

[movie_engine_library post_type="movie_engine_movie" columns="5" show_search="true" limit="20"]

Overview

This shortcode allows you to:

• Display movies, TV series, seasons, or episodes
• Filter by genre, year, language, and access type
• Enable AJAX search and filters
• Customize layout (grid or slider)
• Control monetization (free, premium, rent, sale)
• Build homepage sections like Trending, New Releases, etc.

Core Query

Controls how content is fetched and ordered from the database. These parameters define what content to display, including post types, limits, predefined queries (like trending or top rated), and sorting behavior.

Parameter	Type	Default	Description
post_type	string	auto	Content type(s). Supported: movie_engine_movie, movie_engine_series, movie_engine_season, movie_engine_episode. Empty = movies + series or URL param
limit	number	settings	Number of items per page. Uses archive_items_per_page or search_items_per_page. Fallback: 12
ids	string	—	Comma-separated post IDs. Overrides query and preserves order
type	string	—	Predefined query: trending, new_releases, upcoming, top_rated
orderby	string	date	Sorting: date, title, rating, views
order	string	DESC	Sort direction: ASC or DESC

[movie_engine_library post_type="movie_engine_movie" limit="12" orderby="date" order="DESC"]

Taxonomy Filters

Allows you to filter content using predefined taxonomy values such as genre, year, language, and access type. These are useful for creating targeted sections like Action Movies or 2024 Releases.

Parameter	Type	Default	Description
genre	string	—	Genre slug (preset filter)
year	string	—	Year slug (preset filter)
language	string	—	Language slug
access	string	false	(PRO) Access filter: free, premium, rent, sale

[movie_engine_library genre="action" year="2024" language="english"]

Layout & Display

Defines how content is visually structured on the page. This includes grid or slider layouts, responsive column settings, spacing, and card styles to control the overall UI.

Parameter	Type	Default	Description
layout	string	grid	Layout type: grid or slider
columns	number	settings	Desktop columns (2–15). Fallback: 4
columns_laptop	number	settings	Laptop columns. Fallback: 4
columns_tablet	number	settings	Tablet columns. Fallback: 3
columns_mobile	number	settings	Mobile columns. Fallback: 2
gap	string	—	Gap between items (px). Example: “20”
ratio	string	portrait	Aspect ratio: portrait, landscape, square, banner, custom
custom_ratio	string	—	Used when ratio=”custom” (e.g. 2/3, 16/9). Defaults to 2/3
style	string	classic	Card style: classic, modern, grid, list, slider

[movie_engine_library columns="5" columns_tablet="3" columns_mobile="2" gap="20" style="modern"]

Search & Filters

Controls interactive filtering features such as search bar, filter panels, and AJAX behavior. These options enable users to browse and refine content dynamically without reloading the page.

Parameter	Type	Default	Description
show_search	string	false	Enable search bar
show_filters	string	false	Enable filter panel
filter_layout	string	sidebar	Filter position: sidebar or top
enable_ajax	string	true	Enable AJAX filtering

[movie_engine_library show_search="true" show_filters="true" filter_layout="sidebar"]

Section Header

Manages the top section of the content block, including titles and “View All” links, allowing you to create structured homepage sections like Trending Movies or Latest Series.

Parameter	Type	Default	Description
title	string	—	Section title
show_view_all	string	true	Show View All button
view_all_url	string	—	Custom URL (auto if empty)
view_all_text	string	View All	Button text

[movie_engine_library title="Trending Movies" show_view_all="true"]

Pagination

Controls how content is divided across multiple pages. This helps improve performance and usability when displaying large content libraries.

Parameter	Type	Default	Description
pagination	string	true	Enable pagination (disabled in slider layout)

[movie_engine_library pagination="true"]

Slider Options

Applies only when using the slider layout. These settings control autoplay, speed, looping behavior, and navigation UI, enabling carousel-style content presentation.

Parameter	Type	Default	Description
autoplay	string	false	Enable autoplay
autoplay_speed	string	3000	Autoplay speed (ms)
loop	string	false	Infinite loop
pause_on_hover	string	true	Pause on hover
show_dots	string	false	Show navigation dots

[movie_engine_library layout="slider" autoplay="true" loop="true"]

Card Display Options

Determines which metadata is shown on each content card, such as rating, year, quality badges, pricing, and access labels, helping users quickly understand content details.

Parameter	Type	Default	Description
show_rating	string	true	Show rating
show_year	string	true	Show year
show_quality	string	true	Show quality badge
show_type	string	true	Show type (Movie/Series)
show_price	string	false	(PRO) Show price
show_access_label	string	false	(PRO) Show access label
show_free	string	false	Show free label
show_badges	string	true	Enable badges
show_premium_badge	string	true	Premium badge
show_ppv_badge	string	true	PPV badge

[movie_engine_library show_rating="true" show_year="true" show_quality="true" show_type=”true” show_price=”true” show_access_label=”true” show_free=”true” show_badges=”true” show_premium_badge=”true” show_ppv_badge=”true“]

Styling

Provides additional customization through CSS by allowing you to add custom classes for advanced styling or theme integration.

Parameter	Type	Default	Description
custom_class	string	—	Custom CSS class

[movie_engine_library custom_class="new-class"]

Supported Values

Lists all valid options for key parameters, helping developers understand accepted values and formats without trial and error.

Parameter	Type	Default	Description
post_type	string	—	movie_engine_movie, movie_engine_series, movie_engine_season, movie_engine_episode
type	string	—	trending, new_releases, upcoming, top_rated
orderby	string	date	date, title, rating, views
order	string	DESC	ASC, DESC
layout	string	grid	grid, slider
filter_layout	string	sidebar	sidebar, top
ratio	string	portrait	portrait, landscape, square, banner, custom
style	string	classic	classic, modern, grid, list, slider
access	string	false	free, premium, rent, sale

URL Parameters (Dynamic Filtering)

Explains how content can be dynamically filtered using URL query parameters. This enables deep linking, SEO-friendly filters, and advanced navigation behavior.

Parameter	Type	Default	Description
me_post_type	string	—	Post type filter
me_genre	string	—	Genre slug
movie_engine_genre	string	—	Legacy genre
me_year	string	—	Year slug
movie_engine_year	string	—	Legacy year
me_language	string	—	Language slug
me_quality	string	—	Quality filter
me_access	string	—	Access filter
me_duration	string	—	Runtime filter
me_tag	string	—	Tag filter
me_rating_min	number	—	Min rating
me_rating	number	—	Alt rating
orderby	string	—	Sorting
s	string	—	Search query
paged	number	—	Page number

Related Shortcodes

Parameter	Type	Default	Description
movie_engine_grid	shortcode	—	Same as library (no search)
movie_engine_search	shortcode	—	Same as library (search enabled)

Hooks

Parameter	Type	Default	Description
movie_engine_library_args	hook	—	Modify query args
movie_engine_before_library_grid	hook	—	Before output
movie_engine_after_library_grid	hook	—	After output

Design Settings

Parameter	Type	Default	Description
archive_items_per_page	setting	—	Default limit
search_items_per_page	setting	—	Search limit
archive_columns_desktop	setting	—	Desktop columns
archive_columns_laptop	setting	—	Laptop columns
archive_columns_tablet	setting	—	Tablet columns
archive_columns_mobile	setting	—	Mobile columns
movie_archive_page	setting	—	Archive page
browse_page	setting	—	Browse page

Example Shortcodes

[movie_engine_library type="trending"]

[movie_engine_library layout="slider" autoplay="true"]

[movie_engine_library genre="action"]

[movie_engine_library ids="1,2,3"]

[movie_engine_library type="upcoming" title="Coming Soon"]

All Parameters (Quick Reference)

Here, we show all the parameters

Parameter	Type	Default
post_type	string	—
limit	number	settings
ids	string	—
type	string	—
orderby	string	date
order	string	DESC
genre	string	—
year	string	—
language	string	—
show_search	boolean	false
show_filters	boolean	false
filter_layout	string	sidebar
enable_ajax	boolean	true
layout	string	grid
columns	number	4
columns_laptop	number	4
columns_tablet	number	3
columns_mobile	number	2
gap	number	—
autoplay	boolean	false
autoplay_speed	number	3000
loop	boolean	false
pause_on_hover	boolean	true
show_dots	boolean	false
title	string	—
show_view_all	boolean	true
view_all_url	string	auto
view_all_text	string	View All
pagination	boolean	true
show_rating	boolean	true
show_year	boolean	true
show_quality	boolean	true
show_type	boolean	true
show_badges	boolean	true
show_premium_badge	boolean	true
show_ppv_badge	boolean	true
access	string	—
show_price	boolean	false
show_access_label	boolean	false
show_free	boolean	false
ratio	string	portrait
custom_ratio	string	—
style	string	classic
custom_class	string	—