Features

• Add a Slick Slider to any page via Django CMS Plugin

• Change/set Slick options via JSONField

• Set some styling options such as color

CMS

Admin Form

Output

Documentation

The full documentation is at https://djangocms-slick-slider.readthedocs.io.

Quickstart

Install djangocms_slick_slider:

pip install djangocms-slick-slider

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'djangocms_slick_slider.apps.DjangocmsSlickSliderConfig',
    ...
)

Example project

You can quickly get an example project up to test / develop the plugin.

If you have virtualenvwrapper installed:

git clone https://github.com/oesah/djangocms_slick_slider.git
cd example
mkvirtualenv my_project_env
pip install -r requirements.txt
python manage.py runserver

Visit your homepage (usually http://localhost:8000).

User: admin Password: adminadmin

You should see some instances of the Slick Slider plugin. You can play around to see, how it works.

Settings

SLICK_SLICKER_DEFAULT_OPTIONS = {
    'dots': True,
    'slidesToShow': 2,
    'mobileFirst': False,
    'slidesToScroll': 1,
    'autoplay': True,
    'autoplaySpeed': 1500
}

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

If you have issues with different python versions, please take a look at these docs: https://www.holger-peters.de/using-pyenv-and-tox.html

Release to PyPi

For versioning, you need to have standard-version installed:

yarn install

Once you are ready and everything has been commited to git, you can run:

yarn run release

This will:

• Bump the version in the according files

• Commit everything to git and create a git tag

• Create a package for PyPi and upload it

• Push everything to Git including tags

Credits

Tools used in rendering this package:

• Cookiecutter

• cookiecutter-djangopackage

• Slick Slider

ToDos

• translations