Skip to content

Latest commit

 

History

History
33 lines (22 loc) · 1.63 KB

README.md

File metadata and controls

33 lines (22 loc) · 1.63 KB

djangocms-slider

A simple django cms slideshow plugin. For of https://github.com/urga/djangocms-slider, but using easy-thumbnails by default.

Features:

  • There are 2 plugins: SlideShow and Slide. A SlideShow can only contains Slides. Those can be arranged in the order you want just like any other plugin.
  • Each image can have a url specified (creating an anchor around the image)
  • By default, creates a flexslider slideshow.
  • By default, uses easy-thumbnails as a thumbnail plugin.
  • Allows use of a custom thumbnail configuration in Django settings, using an slider_thumb_id field that should correspond to your id in THUMBNAIL_ALIASES.

So a settings of 'home_slider': {'size': (400, 200), 'crop': False}, in your THUMBNAIL_ALIASES, and a slider_thumb_id of home_slider in your Slider plugin/model (with use_simple_settings set to False) will result in the images being 400x200 instead of the settings in the slide.html template.

Of course, you can still override templates.

Installation

This plugin requires django CMS 3.0 or higher to be properly installed and configured.

To install:

  • run pip install djangocms-slider-easy on your virtualenv
  • add easy_thumbnails to your INSTALLED_APPS setting if you want to use default template.
  • add djangocms_slider to your INSTALLED_APPS setting (mind the underscore)
  • Run ./manage.py migrate djangocms_slider

Usage

To override the template, just add slider.html and or 'slide.html' in a django template directory under templates/djangocms_slider.