用于owl carousel v1的djangocms插件
djangocms-owl的Python项目详细描述
djangocms owl是一个可重用的插件,django-cms 实现javascript carousel库Owl Carousel。版本1 支持猫头鹰旋转木马。
依赖关系
- djangocms>;=3.0
- django>;=1.6
安装
从pypi安装djangocms owl。
pipinstalldjangocms-owl
将djangocms_owl添加到已安装的应用程序中
INSTALLED_APPS=(...'djangocms_owl',...)
owl carousel依赖于jqueryDocs,而jquery不是 当前包含在此包中。添加副本需要添加到 模板,如base.html。
<scriptsrc="jquery.min.js"></script>
配置
通过使用 djangocms_owl_styles设置元组。
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=TrueDJANGOCMS_OWL_INCLUDE_JS_OWL=TrueDJANGOCMS_OWL_INCLUDE_JS_JQUERY=True
在可用插件列表中设置CMS模块名称。默认值是泛型。
DJANGOCMS_OWL_MODULE=_('Generic')
模板
html包含运行carousel所需的所有javascript和css,但它不呈现html。 自定义模板可以扩展base.html,只要它们定义了一个包含html和插件呈现代码的插件块,如下例所示。
{% extends 'djangocms_owl/base.html' %} {% load cms_tags %} {% block plugin %} <divclass="owl-carousel-plugin plugin{% if style %} {{ style }}{% endif %}"id="plugin-{{ instance.pk }}"><divclass="row"><divclass="small-12 columns"><divclass="slider"> {% for plugin in instance.child_plugin_instances %} <divclass="item"> {% render_plugin plugin %} </div> {% endfor %} </div></div></div></div> {% endblock plugin %}
待办事项
- 添加对owl carousel 2的支持
- 展开包含的owl carousel配置选项
- 创建可以重写的抽象基模型
贡献
- 李索威
历史记录
0.1.10/0.1.11错误修复(2016-10-24)
0.1.9(2016-10-24)
- 移除了南迁
- 在插件上使用get_render_template方法
- 将最低CMS版本提升至3.2.3+django版本提升至1.8.1
0.1.8(2016-04-08)
- 默认情况下禁用响应模式,以尊重项选项。选项可以在额外字段中重写。
- 选择1个选项时,默认情况下会将singleitem添加到opions中
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文件的设置
- 重新添加支持django 1.8的select_模板
- 将模板分开以包含一个基,以便于自定义模板的创建-例如extend base.html
0.1.4(2015-07-17)
- 使用django 1.8修复渲染模板错误(已删除选择模板)
0.1.3(2015-07-06)
- 关键错误修复
0.1.2(2015-07-06)
- 已将readme.md转换为readme.rst
- 添加了appconf
- 添加了djangocms_child_classes配置选项
- 将初始django迁移依赖项更新为cms 0001 initial
0.1.1(2015-07-05)
- 文档更新
0.1.0(2015-07-03)
- pypi上的第一个版本