没有项目描述

emencia-django-slideshows的Python项目详细描述


简介

您可以有多个幻灯片,每个幻灯片都有自己的幻灯片。幻灯片可以排序,其中包含标题、可选内容文本、可选URL和可选图像。

幻灯片放映可以使用自定义模板和自定义配置模板。配置模板用于包含一些javascript,以便使用滑块库配置/初始化幻灯片放映。但默认情况下,幻灯片放映项没有配置模板,这是可选的。

它不包含任何资源来将其集成到站点中,这由您负责集成它(选择并安装滑块库、在需要的地方添加资源、自定义模板等)。

需要

可选

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插件。

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
多线程java线程。join未按预期工作   RegExp-GWT/Javascript的java测试方法   java Selenium RemoteWebDriver似乎无法识别对web元素的javascript更改   java当我从Excel工作表中读取inf时,无法按顺序打印文档文件中的信息   JAVAlang.OutOfMemoryError:尝试连接DB2时的Java堆空间   java无法使用smartband 2从google fit API获取心率数据   java外部化属性文件Widlfly&struts1。十、   java如何监视注入的单例?   如何使java日志输出显示在一行上?   java Jboss ws-wsdl问题   java toUpperCase(char)方法?   安卓 Gradle“应用程序”项目刷新失败原因:Java。Lang.NullPointerException   java Spring安全ACL错误无法找到对象标识的ACL信息   是否有一个REST Web服务API提供程序,如FRAPI(PHP),但用于Java?   java递归方法生成字符串的所有分区   JAVAlang.StringIndexOutOfBoundsException:字符串索引超出范围:9   java将项从集合<CustomObject>中获取到其属性列表中的最佳方法是什么   Java本机启动器性能   多捕获与多捕获的java性能差异   java如何创建BaseDAO+JDBC并像@Autowired变量一样使用它?