djangocms-owl 0.1.11

依赖项

• Djangocms>=3.0

• Django>=1.6

安装

从Pypi安装Djangocms-owl。

pip install djangocms-owl

将Djangocms_owl添加到INSTALLED_APPS

INSTALLED_APPS = (
    ...
    'djangocms_owl',
    ...
)

Owl Carousel 依赖于JQuery，但当前该包中未包含文档。需要将其添加到模板中，例如base.html。

<script src="jquery.min.js"></script>

配置

可以通过选择框使用 DJANGOCMS_OWL_STYLES 设置元组将CSS类添加到插件中。

DJANGOCMS_OWL_STYLES = (
    ('style1', 'Style 1'),
    ('style2', 'Style 2'),
)

djangocms_owl/default.html是默认渲染的。如果设置了以下元组，用户可以选择自定义模板，如下例所示。

DJANGOCMS_OWL_TEMPLATES = (
    ('template1', 'Template 1'),
    ('template2', 'Template 2'),
)

限制Owl Carousel可用的插件

DJANGOCMS_OWL_CHILD_CLASSES = (
    'PicturePlugin',
)

包含或排除静态文件

DJANGOCMS_OWL_INCLUDE_CSS = True
DJANGOCMS_OWL_INCLUDE_JS_OWL = True
DJANGOCMS_OWL_INCLUDE_JS_JQUERY = True

在可用插件列表中设置CMS模块名称。默认为Generic。

DJANGOCMS_OWL_MODULE = _('Generic')

模板

base.html包含运行轮播所需的所有JavaScript和CSS，但它不渲染HTML。自定义模板可以扩展base.html，只要它们定义了一个包含html和插件渲染代码的插件块，如下例所示。

{% extends 'djangocms_owl/base.html' %}
{% load cms_tags %}

{% block plugin %}
  <div class="owl-carousel-plugin plugin{% if style %} {{ style }}{% endif %}" id="plugin-{{ instance.pk }}">
    <div class="row">
      <div class="small-12 columns">
        <div class="slider">
          {% for plugin in instance.child_plugin_instances %}
            <div class="item">
              {% render_plugin plugin %}
            </div>
          {% endfor %}
        </div>
      </div>
    </div>
  </div>
{% endblock plugin %}

待办事项

• 添加对owl carousel 2的支持

• 扩展包含的Owl Carousel配置选项

• 创建可覆盖的抽象基类模型

灵感来源

• cmsplugin-filer

贡献

• Lee Solway

历史

0.1.10 / 0.1.11 错误修复（2016-10-24）

0.1.9 (2016-10-24)

• 移除South迁移

• 在插件上使用get_render_template方法

• 将最小CMS版本提升到3.2.3，Django版本提升到1.8.1

0.1.8 (2016-04-08)

• 默认禁用响应模式，以尊重项目选项。选项可以在额外字段中覆盖。

• 当选择一个选项时，默认将singleItem添加到选项中

0.1.7 (2015-08-06)

• 迁移错误修复

0.1.6 (2015-08-05)

• 添加了JSON字段覆盖，以允许自定义选项

• 添加了对自定义CMS模块名的支持

0.1.5 (2015-07-22)

• 包含来自bower的静态文件

• 包含jQuery

• 包含用户使用的Owl Carousel的v2版本

• 添加了设置以包含/不包含jQuery、owlcarousel.js和owl*.css文件

• 重新添加了select_template，以支持Django 1.8

• 将模板分离以包含基础模板，以方便自定义模板的创建 - 例如，扩展base.html

0.1.4 (2015-07-17)

• 修复了Django 1.8的render模板错误（移除了select_template）

0.1.3 (2015-07-06)

• 关键错误修复

0.1.2 (2015-07-06)

• 将README.md转换为README.rst

• 添加了AppConf

• 添加了DJANGOCMS_CHILD_CLASSES配置选项

• 更新了初始Django迁移依赖项为CMS 0001初始

0.1.1 (2015-07-05)

• 文档更新

0.1.0 (2015-07-03)

• 首次在PyPI上发布