没有项目描述

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使用关键字拆分字符串   Neo4j Java API模式索引范围查找?   java访问JButton[]   java如何混淆tomcat日志文件中的请求属性   apache运行CGI Java程序   java从一个Eclipse插件开始,我如何通过编程使Eclipse编辑某个文件?   从php中的SQL数据库到Java中的多个值作为单独的变量   java如何在多个osgi捆绑包之间共享资源   datetime Java time,无法从历元秒解析年份   java无法在安卓应用程序中使用morpho指纹扫描仪设备捕获指纹   java使用groovy/ratpack发送电子邮件   javascript在jsp页面中添加验证,但在控制台中仍然显示一些错误   java如何修复com。mysql。jdbc。DocsConnectionPropsHelper   java AlertDialog dispatchTouchEvent