[gallery_element]
This is the main shortcode for displaying the gallery listing section on a page.
Product
Shortcode Attributes
There are a number of shortcode attributes available which you can use to customize the output.
GENERAL LAYOUT
- listing_only – If set to
on, only the listing will be displayed without additional layout.- Default:
off. - Options:
on,off. Specify one only.
- Default:
- layout – The layout type.
- Default:
grid. - Options:
grid,carousel.
- Default:
- display – Controls the display style.
- Default:
image-above-content. - Options:
- ORDINARY DISPLAYS:
image-above-content,image-overlay-content,content-only. Specify one only. - SPLIT DISPLAYS:
image-left-content,image-right-content. Specify 2 (Split and Split Size). Use commas to separate. - SPLIT DISPLAY SIZES (Required on Split Display):
split-25-75,split-40-60,split-50-50,split-60-40. Specify 3 (Split, Split Size, and Alternate Split). Use commas to separate. - ALTERNATE SPLIT DISPLAY (Can use only on Split-50-50 and on the opposite option of the Split Display):
then-left,then-right.
- ORDINARY DISPLAYS:
- Default:
- per_row – Number of items to display per page.
- Default:
3. - Options:
1–6. Specify one only.
- Default:
- per_page – Number of items to display per page.
- Options: Any numeric value. Specify one only.
- pagination – Pagination type.
- Default:
loadmore. - Options:
loadmore,pagination. Specify one only.
- Default:
- search_filter – Enable or disable search filter.
GRID LAYOUT
- grid_layout – The grid layout style.
- Default:
default-grid-layout. - Options:
default-grid-layout,grid-layout-1,grid-layout-2,grid-layout-3,masonry-layout-1. Specify one only.
- Default:
CAROUSEL LAYOUT
- carousel_layout – The carousel layout style.
- Default:
default-carousel-layout.
- Default:
- autoplay – Enable or disable autoplay for the carousel.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- slider_speed – Autoplay speed in seconds.
- Default:
6. - Options: Any numeric value.
- Default:
- slider_arrows – Show or hide navigation arrows.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
- slider_dots – Show or hide navigation dots.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
DESIGN
- element_width – Width of the element.
- Default:
default-width. - Options:
default-width,small-container,medium-container,large-container,row-fluid. Specify one only.
- Default:
- alignment – Alignment of the content.
- Default:
default-alignment. - Options:
default-alignment,text-left,text-center,text-right,text-justified. Specify one only.
- Default:
- theme – Theme or style for the section.
- Default:
default-section. - Options:
default-section,light-section,grey-section,dark-section,theme-section,second-theme-section. Specify one only.
- Default:
- background – Background image for the element.
- Options: Any image URL.
- classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS. Use spaces to separate
- id – Custom ID for the element.
HEADER
- heading – Main heading text on the post element section.
- Options: Any text value.
- heading_size – HTML tag for the heading.
- Default:
h2. - Options:
h1,h2. Specify one only.
- Default:
- sub_heading – Sub-heading text.
- Options: Any text value.
CONTENT
- group_by_category – Groups gallery items by category.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- lightbox – Enables lightbox functionality for images.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- meta – Specifies metadata to display.
- Default:
description. - Options:
description,gallery_count,category,tag. Use commas,to separate values.
- Default:
- max_words – Limits the number of words displayed in the gallery description.
- Default:
20. - Options: Any numeric value.
- Default:
- link_type – Defines how the link to the gallery is displayed.
- Default:
button. - Options:
button,text,none. Specify one only.
- Default:
- show_in_modal – Determines whether the gallery content should be displayed in a modal (popup) window.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- limit – Limits the number of gallery items displayed.
- Options: Any numeric value.
- orderby – Specifies the criteria for ordering the gallery items.
- Default:
date. - Options:
id,date,title,menu_order,rand. Specify one only.
- Default:
- order – Specifies the order of the gallery items.
- Default:
desc. - Options:
asc,desc. Specify one only.
- Default:
FILTER
- featured – Displays only featured gallery items.
- Default:
no. - Options:
no,yes. Specify one only.
- Default:
- categories – Filter gallery items by categories. Comma-separated list of category IDs or slugs.
- tags – Filter gallery items by tags. Comma-separated list of tag IDs or slugs.
- galleries – Filters gallery items by specific gallery IDs. Comma-separated list of post IDs.
Example Usage
[gallery_element layout="grid" per_row="4" heading="My Gallery" heading_size="h1"]
[gallery_element layout="carousel" autoplay="on" slider_speed="5" slider_arrows="on" slider_dots="off"]
| Example 1: This example displays the galleries in a grid layout with 4 posts per row, a heading titled “My Gallery”, and a heading size of h1.Example 2: This example displays the galleries in a carousel (slider) layout with arrows. The carousel will automatically slide through the posts every 5 seconds. |
classes attribute to add custom CSS classes for advanced styling.Pagination: The
pagination attribute allows you to control how additional galleries are loaded (e.g., loadmore).