跳转到主要内容

幻灯片文件夹为Plone提供简单、优雅的动画幻灯片。

项目描述

关于

幻灯片文件夹为Plone提供简单、优雅的动画幻灯片。

幻灯片文件夹将幻灯片2 JavaScript类集成到Plone中。幻灯片2是一个功能强大、特性丰富、易于定制的幻灯片库 - 感谢Aeron Glemann为其投入的所有辛勤工作!

幻灯片文件夹提供以下功能

  • 可配置过渡效果的动画幻灯片

  • 导航缩略图

  • 图像标题

  • 智能预加载图像以节省带宽

  • 播放/暂停/前进/后退幻灯片控制器

  • 循环和随机顺序幻灯片

  • 可选支持“灯箱”风格的图像弹出窗口

  • 外观和感觉完全可通过CSS自定义

设计理念

幻灯片文件夹使用Zope 3开发技术,使常规Plone文件夹、集合和图像具有可配置的幻灯片视图。

我们希望开发一个适用于Plone的幻灯片产品,以便避免为图片和幻灯片文件夹创建自定义内容类型,从而实现易于安装、在网站中重复使用现有图片以及避免在未来的升级或删除产品时“丢失”内容。

依赖关系

在Plone 3.x下安装和使用幻灯片文件夹最为简单,但也支持Plone 2.5.2及以上版本。然而,要在Plone 2.5下使用幻灯片文件夹,您必须熟悉从SVN签出安装软件。

幻灯片文件夹需要

安装

Plone 3.x,基于buildout的安装程序

如果您正在使用基于buildout的安装程序安装Plone 3.x,只需将“Products.slideshowfolder”添加到您的buildout的[eggs]部分即可。

  • 从Plone 3.1开始,Plone的Unix通用安装程序使用buildout。

  • Plone 3.2及以上版本将使用buildout进行Windows、Mac OSX和Unix通用安装程序。

Plone 3.0.x,非buildout安装程序

幻灯片文件夹以传统方式安装。解压缩tar包,将产品文件夹“slideshowfolder”复制到您的Zope Products目录,然后重启您的Zope实例。您可以从Plone控制面板或ZMI的portal_quickinstaller安装它。以相同的方式卸载。

Plone 2.5.x,非buildout安装程序

下载幻灯片文件夹及其依赖项,如上所述。

在您的Zope实例的产品文件夹中正常安装幻灯片文件夹、CMFOnFive和Five。

plone.app.form必须从SVN签出并安装到您的Zope实例的lib/python/plone/app/form目录。这可能有点棘手,正确解压缩目录。提示:您会得到一个名为plone.app.form的目录,但您需要转到您的Zope实例的lib/python文件夹并做

mkdir plone (if it doesn't exist)
cd plone
mkdir app (if it doesn't exist)
cd app
mkdir form

然后转到您解压缩的plone.app.form目录并做

mv plone/app/form/*  yourzopeinstance/lib/python/plone/app/form

Plone 2.5.x,基于buildout的安装

将“Products.slideshowfolder”添加到您的buildout的[eggs]部分。

有关从SVN安装CMFOnFive、Five tar包和plone.app.form的提示,请参阅buildout文档。警告:这需要一些使用buildout进行更复杂安装的经验。

使用幻灯片文件夹

您的网站中的每个文件夹和集合在其“操作”菜单中都将有一个新的选项——“制作幻灯片”。选择该选项将为该文件夹选择幻灯片视图,并为您提供一个新的“幻灯片设置”配置选项卡。一旦文件夹中有已发布的图片,您就会看到幻灯片。(集合依赖于您在其中设置的准则来为幻灯片渲染图片。非图片将被忽略。这意味着工作流限制仅基于您的集合准则。)

要更改幻灯片的设置,请参阅文件夹上的新“幻灯片设置”选项卡。

每张图片的描述将用作其标题。如果没有描述,则使用标题。

每个幻灯片在操作菜单中都有一个“禁用幻灯片”选项。这将将其还原为普通文件夹(或智能文件夹),包括删除幻灯片设置。(它不会删除任何内容。)

注意:幻灯片将仅包括文件夹中的已发布图片。您可以通过自定义folder_slideshow.pt并调用幻灯片视图上的setWorkflowFilter方法(选项包括“None”或任何有效的工作流状态)来自定义此设置(相当粗糙)。有关这些方法的文档,请参阅interfaces.py。(或者,您可以使用集合,并对您的准则不设置任何工作流限制。)

注意:通过“幻灯片设置”标签页仅支持Aeron Glemann库的一部分选项。有关选项的完整列表,请参阅http://code.google.com/p/slideshow/wiki/Slideshow。如果需要通过Web界面暴露的选项之外进行自定义,您可以自定义slideshow_settings.js.pt以指定附加选项。

注意:只要它实现了Products.slideshowfolder.interfaces.ISlideshowImage接口(该接口在其模式中需要一个名为‘image’的Archetypes ImageField),您就可以使用自己的自定义图像内容类型。(仅适用于Plone 3.0+。)

限制

幻灯片文件夹目前存在一些限制,其中大多数来自其基于的幻灯片2javascript类。

致谢

幻灯片文件夹由Johnpaul Burbank编写,后续由Jon Baldivieso修改。版本4.0由David Glick编写。

初始概念、项目管理以及一些调整由ONE/Northwest完成,包括Jon Stahl和Andrew Burkhalter。

特别感谢Conservation Northwest的部分资助和beta测试。

幻灯片文件夹包括并基于Aeron Glemann的Slideshow 2,Slideshow 2使用Mootoolsjavascript库。

更多信息

有关更多信息、更新、文档和错误报告,请参阅http://www.plone.org/products/slideshowfolder

ONE/Northwest是一家非营利组织,为环境非政府组织提供技术援助(包括Plone驱动的网站!)如果您想支持我们的工作,包括发布像幻灯片文件夹这样的开源软件,请参阅:http://www.onenw.org/about/supporters/support-our-work

历史

4.0 - 最终版本(2008-07-30)

  • 记录了在登录、使用IE浏览器并访问http://localhost/时查看幻灯片时出现的难以捉摸的问题的解决方案。[davisagli]

  • 修改了决定是否显示关于需要在启用了幻灯片功能的文件夹中添加图像的警告时检查的权限为“ATContentTypes: Add Image”。还删除了有关发布的详细信息,因为默认情况下图像不再与工作流相关联。[jessesnyder]

4.0 - 发布候选版本2(2008-07-18)

4.0 - 发布候选版本1(2008-07-11)

  • 添加了“Slideshowfolder: Manage slideshow settings”权限(默认分配给Manager、Editor和Owner角色。)[davisagli]

  • 添加了i18n基础设施。[davisagli]

  • 提高了与实现相同接口(ISlideshowImage)但不属于ATImages的项目的兼容性。[davisagli]

  • 将设置表单切换到使用formlib。[davisagli]

  • 修改了mootools的‘protect’标志,以解决与kupuhelpers.js仍然存在的冲突。[davisagli]

  • 切换到“Slideshow 2”javascript和Mootools 1.2。更改模板、设置以显示新功能。[jonstahl]

3.0 alpha 2 - 未发布

  • 使用正确的noLongerProvides zope.interface API从内容对象中删除标记接口。[andrewb]

  • 由于mootools.js和slideshow.js不再存在于JS注册表中,已移除testJSRegisteryHasResources。现在通过金属槽(详见下文)引入。[andrewb]

  • 通过金属槽而不是通过javascript注册表加载javascript,以避免与kupu冲突。[davisagli]

3.0 alpha 1 - 2007.12.11

  • 将“幻灯片设置”动作的注册移动到通用设置;在Plone 3.0中通过单独的配置文件重新注册到不同的动作ID。[jbaldivieso]

1.2.2 - 2007.12.11

  • 以更优雅的方式修复了条件zope.annotations导入。[FinnArild]

  • 从图像描述中移除了换行符;它们破坏了js。感谢“Taun”发现此问题。[jbaldivieso]

  • 修复了由放置不当的逗号引起的另一个js错误。[jbaldivieso]

1.2.1 - 2007.10.29

  • 修复了一个小错误,由于不正确的JS,持续时间设置没有得到尊重。[jbaldivieso]

1.2 - 2007.10.22

  • 完成了对智能文件夹的支持——幻灯片现在在它们中显示正确。(支持丰富主题。)(问题#14)[jbaldivieso]

  • 修复了幻灯片设置javascript,使其在IE中正常工作。[jbaldivieso]

  • 清理了通用设置的安装步骤。(尽管没有报告错误,但在之前安装可能有点问题。)[jbaldivieso]

  • 幻灯片现在使用完整的绝对URL作为图像源。这意味着图像名称中的空格将被正确转义。(问题#15)[jbaldivieso]

1.1 - 2007.10.04

  • 重构了幻灯片设置传递到模板的方式。将数据从演示文稿中分离出来(不再直接从浏览器视图获取HTML/JS)。在这个过程中

    • 提供了对Unicode图像标题的支持(问题#8)

    • 提供了基于WF(即,在幻灯片中显示未发布的图像现在是模板更改)的皮肤级别支持来过滤幻灯片图像内容。[jbaldivieso]

    [jbaldivieso]

  • 修改了幻灯片模板,当文件夹没有幻灯片内容时提供反馈(包括如果你是内容编辑器的建议信息)。(问题#7)[jbaldivieso]

  • 卸载过程检查目录中的所有文件夹并将它们取消幻灯片化(只要您不是重新安装)。卸载还会从portal_actions中删除其痕迹。[jbaldivieso]

  • 重构了激活幻灯片的方式。一个开关就可以完成所有操作(包括更改视图模板)。现在所有文件夹都可以激活,无论它们是否已经包含图像。幻灯片也可以取消激活。[jbaldivieso]

  • 使用base_properties中的backgroundColor作为幻灯片背景颜色(问题#3)。[jbaldivieso]

1.0 - 2007.09.??

  • 首个发布版本。

项目详情


下载文件

下载适用于您平台的应用程序。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

Products.slideshowfolder-4.0.tar.gz (185.2 kB 查看散列)

上传时间:

构建分布

Products.slideshowfolder-4.0-py2.4.egg (213.8 kB 查看散列)

上传时间:

由以下支持