This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Django app to define images to be shown on a frontpage slider. They can link to any object.

Project Description

A Django application for defining images that should be shown on the frontpage of your website in a slider. Each image can have a title, description and a generic foreign key to any object in your database.

Installation

If you want to install the latest stable release from PyPi:

$ pip install django-hero-slider

If you feel adventurous and want to install the latest commit from GitHub:

$ pip install -e git://github.com/bitmazk/django-hero-slider.git#egg=hero_slider

Add filer, easy_thumbnails and hero_slider to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...,
    'filer',
    'easy_thumbnails',
    'hero_slider',
)

If you have sorl-thumbnail already in your INSTALLED_APPS you may run across some errors since sorl-thumbnail and easy_thumbnail use the same load template tag syntax {% load thumbnail %}. Please see more details here: http://stackoverflow.com/questions/8174122/django-sorl-thumbnail-and-easy-thumbnail-in-same-project

Include the urls for this app:

urlpatterns = patterns(
    '',
    url(r'^hero-slider/', include('hero_slider.urls')),
)

Run the migrations:

./manage.py migrate

Usage

Login to the Django admin and create some SliderItem objects. Each SliderItem should point to some other object (with a generic foreign key).

In your template you can display the slider like this:

{% load hero_slider_tags %}

{% render_hero_slider %}

<script type="text/javascript">
$(document).ready(function() {
    // put all your jQuery goodness in here.
    $('.carousel').carousel({
        /* interval: 3000 */
    })
});
</script>

Alternatively you can use the get_slider_items assignment tag:

{% load hero_slider_tags %}

{% get_slider_items as items %}
{% include "some_template/slider.html with items=items %}

If you want to change the look and feel of the slider, just override the hero_slider/carousel.html template.

Contribute

If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
mkvirtualenv -p python2.7 django-hero-slider
make develop

git co -b feature_branch master
# Implement your feature and tests
git add . && git commit
git push -u origin feature_branch
# Send us a pull request for your feature branch

In order to run the tests, simply execute tox. This will install two new environments (for Django 1.8 and Django 1.9) and run the tests against both environments.

Release History

Release History

This version
History Node

1.3.1

History Node

1.3

History Node

1.2.1

History Node

1.2

History Node

1.1

History Node

1.0.1

History Node

1.0

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-hero-slider-1.3.1.tar.gz (16.0 kB) Copy SHA256 Checksum SHA256 Source Aug 8, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting