PolyCMS Plugin: Banner Slider for RISE CRM
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
- Navigate to PolyCMS > Plugins in the RISE CRM sidebar.
- Locate Banner Slider and click Activate.
- 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
- Click Add New Banner.
- 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
relattribute, and Link Target (same tab_selfor 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 (
0to100%). - 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.
- 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-topbarwithwindow.PolycmsStickyManagerso 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
- PolyCMS Media Library Guide - Upload and organize desktop and mobile banner graphics.
- PolyCMS Plugin Management - Activate, deactivate, and inspect bundled PolyCMS plugins.
- Head Random Bundled Theme - Pair Banner Slider with the default Bootstrap 5 theme.
- Building a Custom Theme for PolyCMS - Integrate
banner_slider_render_frontend()into custom themes.