[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

  1. listing_only – If set to on, only the listing will be displayed without additional layout.
    • Default: off.
    • Options: on, off. Specify one only.
  2. layout – The layout type.
    • Default: grid.
    • Options: grid, carousel.
  3. 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-60split-50-50split-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.
  4. per_row – Number of items to display per page.
    • Default: 3.
    • Options: 16. Specify one only.
  5. per_page – Number of items to display per page.
    • Options: Any numeric value. Specify one only.
  6. pagination – Pagination type.
    • Default: loadmore.
    • Options: loadmore, pagination. Specify one only.
  7. search_filter – Enable or disable search filter.

GRID LAYOUT

  1. 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.

CAROUSEL LAYOUT

  1. carousel_layout – The carousel layout style.
    • Default: default-carousel-layout.
  2. autoplay – Enable or disable autoplay for the carousel.
    • Default: off.
    • Options: on, off. Specify one only.
  3. slider_speed – Autoplay speed in seconds.
    • Default: 6.
    • Options: Any numeric value.
  4. slider_arrows – Show or hide navigation arrows.
    • Default: on.
    • Options: on, off. Specify one only.
  5. slider_dots – Show or hide navigation dots.
    • Default: on.
    • Options: on, off. Specify one only.

DESIGN

  1. element_width – Width of the element.
    • Default: default-width.
    • Options: default-width, small-container, medium-container, large-container, row-fluid. Specify one only.
  2. alignment – Alignment of the content.
    • Default: default-alignment.
    • Options: default-alignment, text-left, text-center, text-right, text-justified. Specify one only.
  3. 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.
  4. background – Background image for the element.
    • Options: Any image URL.
  5. classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS. Use spaces to separate
  6. id – Custom ID for the element.

HEADER

  1. heading – Main heading text on the post element section.
    • Options: Any text value.
  2. heading_size – HTML tag for the heading.
    • Default: h2.
    • Options: h1, h2. Specify one only.
  3. sub_heading – Sub-heading text.
    • Options: Any text value.

CONTENT

  1. group_by_category – Groups gallery items by category.
    • Default: off.
    • Options: on, off. Specify one only.
  2. lightbox – Enables lightbox functionality for images.
    • Default: off.
    • Options: on, off. Specify one only.
  3. meta – Specifies metadata to display.
    • Default: description.
    • Options: description, gallery_count, category, tag. Use commas , to separate values.
  4. max_words – Limits the number of words displayed in the gallery description.
    • Default: 20.
    • Options: Any numeric value.
  5. link_type – Defines how the link to the gallery is displayed.
    • Default: button.
    • Options: button, text, none. Specify one only.
  6. show_in_modal – Determines whether the gallery content should be displayed in a modal (popup) window.
    • Default: off.
    • Options: on, off. Specify one only.
  7. limit – Limits the number of gallery items displayed.
    • Options: Any numeric value.
  8. orderby – Specifies the criteria for ordering the gallery items.
    • Default: date.
    • Options: id, date, title, menu_order, rand. Specify one only.
  9. order – Specifies the order of the gallery items.
    • Default: desc.
    • Options: asc, desc. Specify one only.

FILTER

  1. featured – Displays only featured gallery items.
    • Default: no.
    • Options: no, yes. Specify one only.
  2. categories – Filter gallery items by categories. Comma-separated list of category IDs or slugs.
  3. tags – Filter gallery items by tags. Comma-separated list of tag IDs or slugs.
  4. 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.
Custom Styling: Use the 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).