i-lateral/silverstripe-carousel

A base framework for creating sliders/carousels on your SilverStripe site

Installs: 2 815

Dependents: 0

Suggesters: 0

Security: 0

Stars: 4

Watchers: 5

Forks: 4

Type:silverstripe-vendormodule

2.1.5 2020-12-18 13:27 UTC

This package is auto-updated.

Last update: 2022-05-18 16:52:11 UTC


README

Scrutinizer Code Quality

GitHub license

Module that adds the ability to generate Carousels/Sliders to your SilverStripe website.

Requirements

  • SilverStripe Framework: 4.*
  • SilverStripe CMS: 4.*

Installation

Either via composer:

composer require "i-lateral/silverstripe-carousel"

Or manually by by downloading and adding to:

[silverstripe-root]/carousel

Then run:

./vendor/bin/sake dev/build flush=1

or (from yuor browser):

http://yoursiteurl.com/dev/build/

Usage

The following is a quick guide to getting using this module:

Step 1: Add variable to template

Once installed, you have to add the following template variable to any templates you require a carousel to appear on:

$CarouselSlides

Step 2: Enable carousel on your page

Next, log into the admin interface and edit the page you want to add a carousel to.

Then click the "Settings" tab, and tick the "show carousel" checkbox.

Step 4: Setup Carousel

Once this is done you will be able to set the following fields:

  • Width and Height settings (this will determine the size of the rendered images)
  • Show Controls (this will add next/prev buttons) NOTE if you want this to work correctly, you will need to disable hash rewrites in SilverStripe
  • Show Indicators (show the blips at the bottom of aa page).
  • Interval (how quickly will each slide be displayed).

Step 5: Add some slides

Once you have finished configuring, you can go back to the "content" tab and a "carousel" tab should have appeared in the right hand side of the editing pane.

You can now add slides, attach images and edit their titles.

Using a different carousel

By default this module uses Bootstrap 4 carousel from a CDN. If you want to use your own carousel, you will need to copy the CarouselSlides template into your theme and amend the HTML and Requirements calls