Back to Main Site

PolyCMS Plugin: Banner Slider for RISE CRM

Last updated on Nov 22, 2026 7:37 AM 7:37 AM 2,161.81 ms

The bundled Banner Slider plugin (plugins/polycms/plugins/banner-slider/) adds responsive Bootstrap 5 promotional carousels to your PolyCMS frontend inside RISE CRM. Activate it under PolyCMS > Plugins, then create, schedule, style, and reorder slides from PolyCMS > Banner Slider (/polycms/banner-slider) with separate desktop and mobile imagery.

Activating Banner Slider

  1. Navigate to PolyCMS > Plugins in the RISE CRM sidebar.
  2. Locate Banner Slider and click Activate.
  3. Upon activation, Banner Slider automatically executes its database migration (migrations/001_create_banner_tables.php) and registers a new sidebar item at PolyCMS > Banner Slider (/polycms/banner-slider).

Managing Banners

Open PolyCMS > Banner Slider and stay on the Banners tab to manage all carousel slides. Access respects RISE CRM PolyCMS permissions (polycms_view, polycms_create, polycms_edit, polycms_delete).

Creating or Editing a Banner

  1. Click Add New Banner.
  2. Configure the banner content and visual design fields:
    • Title: Internal banner label (if left empty, PolyCMS automatically generates a title from the banner content or timestamp).
    • Content: Rich text promotional message or announcement overlay (optional when an image banner is used).
    • Call-to-Action Button: Configure Button Text, Button URL, Button Background Color, Button Text Color, link rel attribute, and Link Target (same tab _self or new tab _blank). When you enter a Button URL without Button Text, the entire slide becomes clickable.
    • Desktop Image & Mobile Image: Pick dedicated images for desktop and mobile screens directly from the PolyCMS Media Library.
    • Background & Colors: Set a solid Background Color, optionally enable a Gradient Background (Start Color, End Color, Direction angle), adjust Text Color, and fine-tune Image Opacity (0 to 100%).
    • Schedule (Start Date / End Date): Optionally schedule time-limited campaigns so banners appear and expire automatically without manual intervention.
    • Active Status: Toggle the banner live or draft immediately.
  3. Click Save to persist the banner via AJAX.

Reordering, Duplicating, and Deleting Slides

  • Drag-and-Drop Order: Drag rows in the Banners list to reorder how slides rotate on the frontend; positions save immediately.
  • Quick Toggle: Switch individual banners active or inactive directly from the list.
  • Duplicate: Clone an existing campaign banner with one click to speed up seasonal variations.
  • Delete: Permanently remove outdated slides from the carousel.

Carousel Settings

Switch to the Settings tab inside PolyCMS > Banner Slider to configure global slider behavior:

Setting Description Recommended / Default
Enable Slider Master switch controlling whether Banner Slider outputs on the frontend Enabled (1)
Auto-play Automatically cycle through active slides Enabled (1)
Auto-play Speed Interval between automatic slide transitions in milliseconds 5000 ms
Show Controls Display previous and next navigation arrows Enabled (1)
Show Indicators Display clickable slide indicator dots Enabled (1)
Transition Effect Choose between Slide horizontal movement or smooth Fade Slide

Responsive Behavior and Bootstrap 5 Carousel

Banner Slider initializes natively on Bootstrap 5 Carousel with keyboard navigation, continuous wrap-around looping, and automatic pause-on-hover behavior:

  • Desktop: Uses the configured Desktop Image with full-width layout and visible controls.
  • Tablet & Mobile: Swaps automatically to the Mobile Image (when provided) and supports touch swipe gestures.
  • Sticky Topbar Integration: Automatically registers .banner-slider-topbar with window.PolycmsStickyManager so topbar banners stack cleanly beneath the PolyCMS admin bar without overlapping page headers.

Displaying the Slider on Your Site

You can render Banner Slider through three flexible methods:

1. Automatic Homepage Display

When Enable Slider is turned on and at least one active, within-schedule banner exists, Banner Slider automatically displays on your blog homepage.

2. Shortcode in Any Post or Page

Insert the [banner_slider] shortcode inside any PolyCMS post, static page, or MTBuilder HTML block:

[banner_slider]

3. Direct Theme Template Integration

Theme developers can embed Banner Slider at a specific position inside a custom theme template using either the helper function or action hook:

<?php
if (function_exists('banner_slider_render_frontend')) {
    banner_slider_render_frontend();
}
?>

Or trigger the core placement hook inside your template:

<?php
polycms_do_action('polycms_before_posts');
?>

Related Documentation