dynamic/silverstripe-carousel

A simple carousel for Silverstripe websites.

Installs: 1 586

Dependents: 3

Suggesters: 1

Security: 0

Stars: 0

Watchers: 3

Forks: 2

Open Issues: 5

Type:silverstripe-vendormodule

1.0.2 2023-10-12 22:49 UTC

This package is auto-updated.

Last update: 2024-04-14 21:12:07 UTC


README

A simple carousel for Silverstripe websites. The default template uses Bootstrap classes to power the carousel. If you are not using Bootstrap, you can use a custom template and include your own javascript.

CI codecov

Latest Stable Version Total Downloads Latest Unstable Version License

Requirements

  • Silverstripe CMS ^5

Installation

composer require dynamic/silverstripe-carousel

License

See License

Usage

To add a carousel to a page, apply CarouselPageExtension to a page type:

Page:
  extensions:
    - Dynamic\Carousel\Extension\CarouselPageExtension

In your template, include the Carousel template:

<% include Dynamic/Carousel/Carousel %> 

Template Notes

The default template assumes you are using Bootstrap 5, and requires no additional javascript. If you are not using Bootstrap, you can use a custom template and include your own javascript.

Note - if you are not including all of Bootstrap, you will need to manually include the carousel component.

Maintainers

Bugtracker

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

  • Create a new issue
  • Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
  • Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.