A Django CMS Slider Plugin with Slick
Project description
Django CMS Slick Slider Plugin
A Django CMS Slider Plugin with Slick Slider.
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_SLIDER_VERSION
Version of Slick Slider that should be used. Keep in mind, that this version needs to be in static/vendor/ folder with the appropriate folder name.
If you want to upgrade, download and copy the new version into the before mentioned folder and change the version in the settings.
default: 1.8.0
SLICK_SLICKER_DEFAULT_OPTIONS
ToDo
SLICK_SLIDER_ACE_THEME
ToDo
SLICK_SLIDER_ACE_MODE
ToDo
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
Credits
Tools used in rendering this package:
ToDos
make slider respect the order of SlickSliderImage Plugins
add more styling options to plugin
translations
History
0.6.0 (2019-12-02)
Add ability to render full width sliders
added max image width and max slider height for better image thumbnails
If full width, dots are placed inside slider container
Cleaned up repository
0.5.0 (2018-02-01)
Made title and settings not required anymore
Added support for multiple sliders on one page
Fixed bug, which made arrow color option not work
reworked the example project so you can use it with preconfigured data
changed default arrow color to a darker gray (
#666
)
0.2.4 (2017-10-13)
fixed jsonfield default error due to encoding
0.2.2 (2017-10-13)
bug fixes that caused whitenoise to crash due to relative paths
0.2.1 (2017-10-13)
bug fixes that cause the slider not to show up
better python 3 compatibility
0.2.0 (2017-10-13)
major database change
fixed many bugs
you need to completey delete the old db and use the new one
0.1.4 (2017-10-13)
changed structure of settings
0.1.2 (2017-10-13)
added django-cms as dependency to pypi package (setup.py)
0.1.1 (2017-10-12)
fixed github link in setup.py
0.1.0 (2017-10-12)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for djangocms-slick-slider-0.6.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c42e0c552ec2a7f85d44f396dcae1d4f763d0d90d2cc89bf125133ec517eee8a |
|
MD5 | 00b7aa980584e8ad129e6c6dc3e96552 |
|
BLAKE2b-256 | 5b471658f5a459e78b4cb0160082863b2e3593078c7500cba39eff17a60d58f6 |
Hashes for djangocms_slick_slider-0.6.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 636afc94822267275317cee8d93b9eb49865545102663e0f61f95f9a9ab4e94e |
|
MD5 | 2e85bbd2f1d68d2f1cb94e115d3d92cb |
|
BLAKE2b-256 | c83049715f40f66cd7a640f780f4df50fe37104bf2399ea44116146f6187680f |