> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sitestorepro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Site Store Pro Display Plugins: Shortcode Reference Guide

> Embed slideshows, live search, events calendars, featured products, and more using Site Store Pro's built-in display plugins and shortcodes.

Display plugins are self-contained, embeddable UI components that you drop into any CMS page, layout block, or widget area using a shortcode. Site Store Pro ships with seven built-in plugins plus a Testimonials plugin, each with its own configurable parameters. Manage all plugins from **Admin → Display Plugins** (`/admin/plugins`).

## Plugin Manager

Each plugin in the manager has a settings drawer with three tabs:

<Tabs>
  <Tab title="Settings">
    A data-driven options form with inputs, textareas, a dark CSS code editor, checkboxes, and select dropdowns. Use this tab to configure global defaults for the plugin.
  </Tab>

  <Tab title="Usage">
    A copyable shortcode snippet and a full parameter reference guide. Copy the base shortcode from here and customise the parameters for each embed.
  </Tab>

  <Tab title="Activation">
    For plugins that require a license, enter and validate your license key here to activate them.
  </Tab>
</Tabs>

<Tip>
  While editing any CMS page, open the **Plugins Panel** drawer on the right side of the editor to browse all installed plugins, view their shortcode syntax, and inspect every available parameter — without leaving the page editor.
</Tip>

***

## Slideshow Plugin

Renders a full-featured image slideshow. Manage slide content at **Admin → CMS → Slideshows**.

```text theme={null}
[plugin:slideshow-2026 id=1]
[plugin:slideshow-2026 id=1 nav=on paging=on autoplay=on speed=3000]
```

| Parameter  | Values        | Description                                  |
| ---------- | ------------- | -------------------------------------------- |
| `id`       | integer       | ID of the slide deck to render               |
| `nav`      | `on` \| `off` | Show previous/next arrow navigation          |
| `paging`   | `on` \| `off` | Show dot paging indicators                   |
| `autoplay` | `on` \| `off` | Auto-advance through slides                  |
| `speed`    | integer (ms)  | Time between slide transitions (e.g. `3000`) |

***

## Featured Items Plugin

Displays a responsive product grid populated with products you have marked as featured in the catalog.

```text theme={null}
[plugin:featured-items]
[plugin:featured-items max=8 columns=4 category=apparel]
```

| Parameter  | Values      | Description                                |
| ---------- | ----------- | ------------------------------------------ |
| `max`      | integer     | Maximum number of products to display      |
| `columns`  | integer     | Number of grid columns                     |
| `category` | slug string | Filter results to a specific category slug |

***

## Cross-Sell List Plugin

Renders the cross-sell recommendations you have configured at the product level.

```text theme={null}
[plugin:cross-sells product_id=42]
[plugin:cross-sells product_id=42 title="You May Also Like"]
```

| Parameter    | Values  | Description                                    |
| ------------ | ------- | ---------------------------------------------- |
| `product_id` | integer | ID of the product whose cross-sells to display |
| `title`      | string  | Heading text displayed above the list          |

***

## Multi-Content Live Search Plugin

Provides a real-time search experience that searches across six content types simultaneously: Categories, Brands, Products, CMS Pages, Knowledge Base Articles, and Testimonials.

```text theme={null}
[plugin:live-search-2026 mode=input placeholder="Search the store..."]
[plugin:live-search-2026 mode=results layout=grid]
```

| Parameter     | Values               | Description                                                                |
| ------------- | -------------------- | -------------------------------------------------------------------------- |
| `mode`        | `input` \| `results` | `input` renders the search bar; `results` renders the results display area |
| `placeholder` | string               | Placeholder text shown inside the search input                             |
| `layout`      | `list` \| `grid`     | Display style for search results                                           |

***

## Events Calendar Plugin

Displays upcoming events in one of three views with ticket booking support. Event data is managed at the product variant level.

```text theme={null}
[plugin:events-calendar-2026]
[plugin:events-calendar-2026 layout=list category=workshops max=50]
```

| Parameter  | Values                      | Description                                                   |
| ---------- | --------------------------- | ------------------------------------------------------------- |
| `layout`   | `month` \| `list` \| `grid` | Display mode: 7-column month grid, agenda list, or cards grid |
| `category` | slug string                 | Filter events to a specific category slug                     |
| `max`      | integer                     | Maximum number of events to load                              |

Clicking any event opens a glassmorphism modal with a **Book Event Ticket** checkout link.

***

## Social Media Icons Plugin

Renders icon links to your configured social media profiles. Supports Facebook, Twitter, Instagram, LinkedIn, and YouTube.

```text theme={null}
[plugin:social-icons-2026]
[plugin:social-icons-2026 size=lg font_awesome=on]
```

| Parameter      | Values               | Description               |
| -------------- | -------------------- | ------------------------- |
| `size`         | `sm` \| `md` \| `lg` | Icon display size         |
| `font_awesome` | `on`                 | Use Font Awesome icon set |

***

## Brands Display Plugin

Shows a visual grid or carousel of your store's brands, each linking to its `/brands/{slug}` page.

```text theme={null}
[plugin:brands-2026]
[plugin:brands-2026 layout=carousel show_logos=true]
```

| Parameter    | Values               | Description                     |
| ------------ | -------------------- | ------------------------------- |
| `layout`     | `grid` \| `carousel` | Display mode for the brand list |
| `show_logos` | `true`               | Display brand logo images       |

***

## Testimonials Plugin

Manages and displays customer testimonials. Add and edit testimonials at **Admin → Testimonials** (`/admin/testimonials`). Each testimonial record includes an author name, title or company, avatar image, star rating (1–5), content body, sort order, and active toggle.

```text theme={null}
[plugin:testimonials-2026]
[plugin:testimonials-2026 layout=grid]
[plugin:testimonials-2026 count=3]
```

| Parameter | Values                   | Description                                         |
| --------- | ------------------------ | --------------------------------------------------- |
| `layout`  | `grid` (default: slider) | Display as a card grid instead of a slider carousel |
| `count`   | integer                  | Limit the number of testimonials displayed          |