A Django CMS Slider Plugin with Slick
Project description
=============================
Django CMS Slick Slider Plugin
=============================
.. image:: https://badge.fury.io/py/djangocms-slick-slider.svg
:target: https://badge.fury.io/py/djangocms-slick-slider
.. image:: https://travis-ci.org/oesah/djangocms-slick-slider.svg?branch=master
:target: https://travis-ci.org/oesah/djangocms-slick-slider
.. image:: https://codecov.io/gh/oesah/djangocms_slick_slider/branch/master/graph/badge.svg
:target: https://codecov.io/gh/oesah/djangocms_slick_slider
A Django CMS Slider Plugin with `Slick Slider <http://kenwheeler.github.io/slick/>`_.
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**
.. image:: docs/media/admin.png
:alt: alternate text
:align: right
**Admin Form**
.. image:: docs/media/admin_form.png
:alt: alternate text
:align: right
**Output**
.. image:: docs/media/slider.png
:alt: alternate text
:align: right
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`:
.. code-block:: python
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: :code:`admin`
Password: :code:`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:
* Cookiecutter_
* `cookiecutter-djangopackage`_
* `Slick Slider`_
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage
.. _`Slick Slider`: http://kenwheeler.github.io/slick/
ToDos
-----
* make slider respect the order of ``SlickSliderImage`` Plugins
* add more styling options to plugin
* translations
History
-------
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 (:code:`#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.
Django CMS Slick Slider Plugin
=============================
.. image:: https://badge.fury.io/py/djangocms-slick-slider.svg
:target: https://badge.fury.io/py/djangocms-slick-slider
.. image:: https://travis-ci.org/oesah/djangocms-slick-slider.svg?branch=master
:target: https://travis-ci.org/oesah/djangocms-slick-slider
.. image:: https://codecov.io/gh/oesah/djangocms_slick_slider/branch/master/graph/badge.svg
:target: https://codecov.io/gh/oesah/djangocms_slick_slider
A Django CMS Slider Plugin with `Slick Slider <http://kenwheeler.github.io/slick/>`_.
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**
.. image:: docs/media/admin.png
:alt: alternate text
:align: right
**Admin Form**
.. image:: docs/media/admin_form.png
:alt: alternate text
:align: right
**Output**
.. image:: docs/media/slider.png
:alt: alternate text
:align: right
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`:
.. code-block:: python
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: :code:`admin`
Password: :code:`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:
* Cookiecutter_
* `cookiecutter-djangopackage`_
* `Slick Slider`_
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage
.. _`Slick Slider`: http://kenwheeler.github.io/slick/
ToDos
-----
* make slider respect the order of ``SlickSliderImage`` Plugins
* add more styling options to plugin
* translations
History
-------
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 (:code:`#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
Close
Hashes for djangocms-slick-slider-0.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5e315299d6c5010a80c7a26520d3c1b357e3e55429b427e49c93da821d2f6525 |
|
MD5 | 31063d220f3072d5fb9bc0bc577b91a9 |
|
BLAKE2b-256 | 1792a95a21875104dc1fd6b36a99a6d6901d3168c4952fa65fce301316504311 |
Close
Hashes for djangocms_slick_slider-0.5.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 350f7cc7d7c4f673cb889454eeae9c8128b272521b722c5d6746c6e7c7eb3b81 |
|
MD5 | 76c3657f60a4a2b58936c43e8a5cb8e6 |
|
BLAKE2b-256 | 530a14678087691a0247b82ea2df8f17639fb5950ec06491ad2a7b9356029efe |