README

A simple and clean image slider/carousel component for OctoberCMS. This plugin provides a drag-and-drop slider component that can be easily added to any page.

Features

• Responsive design that works on all devices
• Touch-friendly for mobile devices
• Configurable number of slides per view
• Optional autoplay with configurable delay
• Optional navigation arrows
• Optional pagination dots
• Beautiful transitions and effects
• Support for titles, descriptions, and links
• Image optimization with thumbnails
• Easy drag-and-drop reordering in the backend

Installation

1. Clone this repository to your OctoberCMS plugins directory:

git clone https://github.com/yourusername/slider-carousel.git plugins/kirsten/slidercarousel

1. Run the following commands in your OctoberCMS root directory:

php artisan plugin:refresh Kirsten.SliderCarousel
php artisan october:up

1. Add Swiper.js to your theme's layout file:

<link rel="stylesheet" href="https://unpkg.com/swiper@8/swiper-bundle.min.css" />
<script src="https://unpkg.com/swiper@8/swiper-bundle.min.js"></script>

Usage

1. Go to the backend and click on the "Slider" menu item
2. Add your slides with images, titles, descriptions, and links
3. Reorder slides using drag and drop
4. To add the slider to any page:
   • Go to the CMS page editor
   • Click the "Components" button
   • Find "Image Slider" in the list
   • Drag it onto your page
   • Configure the options as needed

Configuration Options

• Slides per view: Number of slides to show at once
• Autoplay: Enable/disable automatic sliding
• Autoplay delay: Time between slides in milliseconds
• Show navigation: Enable/disable next/previous buttons
• Show pagination: Enable/disable pagination dots

Version History

• v1.0.1 - Initial release

License

This plugin is licensed under the MIT License - see the LICENSE file for details.