django-hero-slider 1.3.1

安装

如果要安装pypi的最新稳定版本：

$ pip install django-hero-slider

如果您有冒险精神并希望安装来自github的最新提交：

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

将filer、easy_thumbnails和hero_slider添加到 INSTALLED_APPS：

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

如果您的INSTALLED_APPS中已经有sorl-thumbnail，则可能会遇到一些错误，因为sorl-thumbnail和easy_thumbnail使用相同的加载模板标记语法{% load thumbnail %}。请在此处查看更多详细信息：http://stackoverflow.com/questions/8174122/django-sorl-thumbnail-and-easy-thumbnail-in-same-project

包括此应用程序的URL:

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

运行迁移：

./manage.py migrate

用法

登录到django管理员并创建一些slideritem对象。每个滑块 应该指向其他对象（带有泛型外键）。

在您的模板中，您可以这样显示滑块：

{% 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>

或者，您可以使用get_slider_itemsassignment标记：

{% load hero_slider_tags %}

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

如果要更改滑块的外观，只需覆盖 hero_slider/carousel.html模板。

贡献

如果您想参与此项目，请执行以下步骤

# 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

为了运行测试，只需执行tox。这将安装两个新的 环境（适用于django 1.8和django1.9）并针对这两个环境运行测试 环境。