README.rst

Bootstrap carousel plugin for Django-CMS

A Django-CMS plugin to easily create carousel components using Bootstrap, from Twitter. Forked from: https://bitbucket.org/tonioo/cmsplugin-bootstrap-carousel

This plugin supports filer and will use it if it is found in your INSTALLED_APPS.

Requirements

• Django-CMS >= 2.4
• Bootstrap
• easy-thumbnails
• Pillow
• filer is optional.

Installation

To use it into your project, just follow this procedure:

1. Install the the plugin in your virtualenv, using:

   pip install cmsplugin-bootstrap-carousel
   

and remember to add it to your requirements.txt file, if you use one.

1. Open the settings.py file and add cmsplugin_bootstrap_carousel to the INSTALLED_APPS variable

2. This plugin will use filer if it is in your INSTALLED_APPS

3. add:

   THUMBNAIL_HIGH_RESOLUTION = True
   

to settings.py, if you want to support retina displays in the admin. (Otherwise you may encounter missing image placeholders in image file listings.)

1. Run the following command:

   $ ./manage.py syncdb
   

Note

Bootstrap is not included with this plugin.

Contributing

Contributors please submit pull requests to the develop branch.

History

0.2.3:

• List element wasn't being closed properly in carousel template on inactive indicators.

0.2.2:

• Fixing setup.py for pip>=1.6.

0.2.1:

• Changed plugin name from CarouselPlugin to BootstrapCarouselPlugin to avoid name collision with djangocms-cascade.

0.2.0:

• Added fields for toggling visibility of carousel controls and slide indicator. Improved the included template.