没有项目描述
emencia-django-slideshows的Python项目详细描述
简介
您可以有多个幻灯片,每个幻灯片都有自己的幻灯片。幻灯片可以排序,其中包含标题、可选内容文本、可选URL和可选图像。
幻灯片放映可以使用自定义模板和自定义配置模板。配置模板用于包含一些javascript,以便使用滑块库配置/初始化幻灯片放映。但默认情况下,幻灯片放映项没有配置模板,这是可选的。
它不包含任何资源来将其集成到站点中,这由您负责集成它(选择并安装滑块库、在需要的地方添加资源、自定义模板等)。
链接
- 下载他的PyPi package;
- 克隆到他的Github repository;
需要
- django>;=1.8;
- django-filebrowser-no-grappelli>;=3.5.6;
可选
- djangocms_text_ckeditor>;=2.4.0或django-ckeditor>;=4.4.4(见Ckeditor部分);
ck编辑器
可以安装一个ckeditor django应用程序,将其用于Slide.contentmodel属性,而不是简单的TextField。
因此,如果您需要的话,可以手动安装其中一个(使用pip、buildout等)。一旦安装好,你就不用再担心这个了。
注意,默认的假定应用程序是djangocms_text_ckeditor,如果没有安装,则假定为django-ckeditor。如果两者都安装了,djangocms_text_ckeditor将被使用。如果没有安装,将使用默认的django字段TextField。
选择要安装的应用程序主要取决于您是否已经安装了Allready djangocms。如果你有,你可能已经准备好安装它的ckeditor应用,所以不需要安装另一个应用,因为。如果您没有安装djangocms,只需安装django-ckeditor。
最后,您可以为ckeditor添加自定义设置,请参阅其文档以了解如何设置这些设置(您可能需要转到官方ckeditor文档以了解可用设置)。
安装
在“设置”中将其添加到已安装的应用程序中:
INSTALLED_APPS = ( ... 'slideshows', 'filebrowser', ... )
如果您已经为ckeditor安装了一个django应用程序,请将其也添加到您的settings.INSTALLED_APPS。
然后添加其设置:
from porticus.settings import *
请参阅应用程序settings.py文件,查看可以覆盖的设置。
还有一些关于django-filebrowser-no-grappelli的设置(有关详细信息,请参阅其文档)。
并将其视图添加到主视图urls.py:
from django.conf.urls import url, patterns from filebrowser.sites import site as filebrowser_site urlpatterns = patterns('', ... url(r'^slideshows/', include('slideshows.urls', namespace='slideshows')), url(r'^admin/filebrowser/', include(filebrowser_site.urls)), ... )
最后,使用django迁移在数据库中安装应用程序模型:
python manage.py migrate
用法
构建html的过程是生成可选的配置html(如果有的话),然后生成内容html。
常见的方法是显示一个包含所有幻灯片的幻灯片,这称为slides show。还有一种模式叫做random slide,它只显示从已发布的幻灯片放映中随机获取的单个幻灯片。
模板标签
从管理员处创建幻灯片放映,提供一些幻灯片,然后在模板中使用:
{% load slideshows_tags %} ... {% slideshow_render 'your-slug' %}
第一个参数接受slug字符串或slideshow实例。
您还可以覆盖模板标记中保存的内容模板和配置模板:
{% load slideshows_tags %} ... {% slideshow_render 'your-slug' 'slideshows/slides_show/custom.html' 'slideshows/slides_show/configs/custom.html' %}
(如果只想重写配置模板,请使用'None'作为第二个参数)。
注意,如果给定幻灯片弹头不存在,这将引发一个HTTP404。
视图
视图使用幻灯片实例中定义的模板,没有要定义的特定过程。
- 您可以使用类似于/slideshows/show_slides/SLUG/的url访问幻灯片视图,其中SLUG是幻灯片对象上定义的slug;
- 您可以进入随机图像模式具有类似于/slideshows/random_slide/SLUG/的url的幻灯片视图,其中SLUG是幻灯片对象上定义的slug;
在djangocms页面内
您可以安装一个附加软件包,以便在页面占位符内容中使用幻灯片。见cmsplugin-slideshows。
模板
幻灯片内容模板将具有以下上下文变量:
- slideshow_js_config:生成的配置模板(如果有),否则为空字符串;
- slideshow_instance:幻灯片模型实例;
- slideshow_slides:幻灯片放映实例的已发布幻灯片的查询集;
幻灯片配置模板将具有以下上下文变量:
- slideshow_instance:幻灯片模型实例;
- slideshow_slides:幻灯片放映实例的已发布幻灯片的查询集;
这可用于模板标签和CMS插件。