Plone的简单幻灯片解决方案
项目描述
简介
EasySlideshow是一个Plone产品，它使得任何内容编辑都易于创建和管理在线幻灯片。它包含所有您需要的自定义幻灯片的设置，例如
调整幻灯片切换之间的延迟；
管理幻灯片图像的高度/宽度；
控制是否在幻灯片中显示标题；
选择用户是否可以在鼠标悬停在幻灯片上时暂停幻灯片；
选择幻灯片超时时间；
以数字、标题、缩略图或根本不显示的方式显示导航。
为了创建一个幻灯片，内容编辑只需将图片上传到普通文件夹，点击文件夹的“操作”菜单，并选择“启用幻灯片”。这会将普通文件夹转换为幻灯片文件夹，并自动将文件夹显示更改为幻灯片视图。为了修改幻灯片显示图像的顺序，内容编辑只需在“内容”选项卡中将图片上下拖动以重新排列。
除了存储在专用文件夹中，EasySlideshow 还支持在侧边栏（也称为侧边框）中显示图片的能力。幻灯片实际上可以通过调用 EasySlideshow 附加的幻灯片宏在任何模板中显示。
虽然 EasySlideshow 的全局参数通过控制面板（登录，点击网站设置，然后选择EasySlideshow 配置）进行控制，但内容编辑人员也有能力在文件夹级别直接覆盖特定幻灯片的全局设置。这允许在不使所有幻灯片的外观和功能相同的情况下，在网站上的多个位置使用 EasySlideshow。
EasySlideshow 与 Plone 4 兼容（Plone 3.3.x 及以上版本）且无需自定义安装，因为它利用了 Plone 已附带 的 jQuery 库。EasySlideshow 使用 Plone 图像类型中已有的字段进行展示。该产品的 jQuery 插件基础是 jQuery Cycle2。
示例
使用 EasySlideshow 的网站包括
安装
在您的 buildout.cfg 中，将 collective.easyslideshow 添加到 [instance] 部分中的 eggs 列表。该包使用 z3c.autoinclude，因此如果您使用 Plone 3.2+，则无需将其添加到 zcml。
[instance] eggs = collective.easyslideshow zcml = collective.easyslideshow
运行 buildout 并启动实例
通过 portal_quickinstaller 安装 collective.easyslideshow
注意：* 版本 2.1 需要 Plone >= 4.1 * 版本 2.2 需要 >= 4.3
卸载
通过 portal_quickinstaller 卸载 collective.easyslideshow
现有的幻灯片文件夹将完全恢复为普通文件夹
标记接口、布局和注释将被删除
幻灯片边栏将被删除
升级到 3.x
当升级到 EasySlideshow 3.0 或更高版本时，您首先需要升级到 2.2。版本 2.2 移除了对 p4a.subtyper 的依赖。
升级步骤
将版本 2.2 安装到您现有的 Lineage 驱动的网站上
转到 Plone 网站设置，并从“插件”面板中点击升级 EasySlideshow 的按钮
安装版本 3.x
转到 Plone 网站设置，并从“插件”面板中点击升级 EasySlideshow 的按钮
使用
在您的网站上创建一个文件夹
一旦 EasySlideshow 已安装，您就可以通过点击“子类型”选项卡然后选择“幻灯片”，将文件夹子类型化，使其成为幻灯片文件夹
将图片添加到文件夹中
幻灯片顶部图片的标题显示每个图片的 标题 和 描述
要将幻灯片链接到您网站上的页面，请编辑图片，点击 分类 选项卡，并设置相关链接。每个幻灯片都可以有自己的相关链接。
属性可以在整个站点范围内更改，也可以在每个幻灯片单独更改。转到网站设置以设置整个站点的属性。对于更改单个幻灯片的属性，每个幻灯片文件夹上都有一个可用的 幻灯片 选项卡。
还有一个可用的幻灯片边栏。每个边栏都有自己的设置，并显示您选择的文件夹中的图片。
图片将自动调整大小以适应幻灯片属性中设置的高度和宽度，除非您选择以原始大小显示它们。不匹配幻灯片宽高比的图片将在右侧或底部显示空白。
自定义
幻灯片的外观可以通过覆盖 slideshow_macros.pt 进行进一步修改。
可以通过以下代码将幻灯片宏放入自定义模板：
<metal:block use-macro="here/slideshow_macros/macros/slideshow"> slideshow here... </metal:block>
在自定义模板中使用时，幻灯片将在与显示页面同一级别的名为 Slideshow Folder (id slideshow-folder) 的文件夹中查找图片。该文件夹的名称可以在宏中修改。
有关更多过渡选项，请参阅 Cycle2 下载页面 http://malsup.com/jquery/cycle2/download/
有关更多功能和自定义选项，请参阅 http://malsup.com/jquery/cycle2
变更日志
2.2 (2015-02-06)
添加升级步骤以删除 p4a 接口 [cdw9]
更新过渡选项，Cycle2 默认情况下可用的选项较少 [cdw9]
删除与 p4a 相关的所有内容。允许在操作菜单中启用和禁用幻灯片文件夹 [cdw9]
添加新选项以显示原始大小的图片而不是缩放图片，添加新选项以显示导航标题（使用图片标题）[cdw9]
删除皮肤，将所有内容放入资源目录 [cdw9]
升级到 Cycle2。这需要 jQuery 1.7+ (Plone 4.3+) [cdw9]
删除对 base_properties 的依赖 [cdw9]
2.1.2 (2013-06-03)
修复了 ZPT 中寻找图片路径的错误调用。 [calvinhp]
2.1.1 (2013-06-02)
修复了变更日志，以便正确编译 rst。 [calvinhp]
2.1 (2013-06-02)
修复以兼容 Plone 4.3，向后兼容 Plone 4.1 [calvinhp]
添加升级步骤以更新 getRelatedLink 索引。注意：需要运行此升级步骤，以便相关项链接继续正常工作。 [davidblewett]
将 random_order 设置导入升级步骤，以便迁移到最新 Easy Slideshow 的站点。这样，幻灯片文件夹将不再出现错误。 [cwainwright]
添加了对 CMFCore permissions.zcml 的包含，以避免在某些 Plone 版本上出现错误 [cwainwright]
2.0 (2012-02-10)
添加了一个随机化选项，以随机顺序显示幻灯片中的幻灯片 [tbesluau]
使 quickinstall 实际执行安装/卸载，而不仅仅是运行默认配置文件 [claytron, tbesluau]
处理卸载时移除幻灯片端口 [tbesluau]
处理卸载时移除幻灯片文件夹上的标记接口和注释 [tbesluau]
更新 README 以提供卸载说明 [cwainwright, tbesluau]
测试/质量保证 [clshaw01, elizabeth]
迁移分支以添加 i18n 支持和法语翻译 [tbesluau]
添加了将幻灯片导航显示为缩略图的选项。仍然提供显示数字或无导航的选项 [cwainwright]
将 propertiestool.xml 移动到初始配置文件，以便默认配置文件不会覆盖幻灯片设置 [cwainwright]
使用 plone.app.imaging 对幻灯片中显示的图片进行缩放。将使用单独幻灯片属性中设置的尺寸。适用于幻灯片文件夹和端口。参考 #6 [cwainwright]
更新了 slideshow_folder_view 以适应 Plone 4：使用内容-core 宏，删除了视图管理器 refs #3 [cwainwright]
修复了禁用 JavaScript 时的幻灯片显示。显示第一张幻灯片，并确保溢出被正确隐藏。refs #2 [cwainwright]
压缩了 jquery-cycle.js [cwainwright]
更新了幻灯片端口导航的颜色/显示 [cwainwright]
修复了幻灯片端口，使其可以添加多个端口，并且所有端口都将使用其各自的设置正常工作 [cwainwright]
删除粘贴安装，因为这不在 Windows 上工作，并且不是产品正常工作所需的 [claytron]
1.0 (2011-01-07)
修复文档，为 1.0 版本发布做准备 [claytron]
允许单个文件夹有自己的幻灯片属性 [tbesluau]
创建 CSS 删除仅针对 #slideshow 的特定内容类型图片 [cwainwright]
为配置文件添加了浏览器测试 [tbesluau]
添加了对SlideshowView的getImages方法的测试和getPortletImages的存根。[davidblewett]
更新了变更日志格式。[clayton]
在collective/easyslideshow文件夹中添加了version.txt，并修改了setup.py以自动获取它。[tbesluau]
修复了小部件，使其能够正确获取幻灯片文件夹。[lucielejard]
在网站设置中为easyslideshow配置创建了一个图片。[cwainwright]
将propertiestool.xml移动到初始配置文件中。[cwainwright]
使卸载在重新安装时停止运行。[tbesluau]
在metadata.xml中更新了版本化样式。[cwainwright]
将cssregistry、jsregistry、portlets和skins添加到卸载配置文件中，以确保删除所有内容。[cwainwright]
清理了README，使其成为有效的reStructuredText。[cwainwright]
将安装说明添加到README中。[cwainwright]
使用z3c.autoinclude。[tbesluau]
编写了一些关于如何使用幻灯片的文档。[cwainwright]
移除了insert-after=custom代码。这通常会在easyslideshow在主题之后安装时导致问题 - 幻灯片宏的覆盖功能停止工作。[cwainwright]
幻灯片小部件。它几乎完成了，但我还没有成功让选定的文件夹在幻灯片中显示其图片。[cwainwright]
0.5 (2010-02-22)
在安装时添加了一个条件 - 如果显示下拉菜单中已经有了，则不要将幻灯片文件夹视图添加到显示下拉菜单中。[cwainwright]
修复了幻灯片propertiestool.xml的标题属性。[cwainwright]
0.4 (2009-12-11)
从egg中包含文档以避免安装时出错。[cwainwright]
0.2 (2009-10-23)
更改了slideshow_folder_view的提供方式，使其在默认配置文件中运行，而不仅仅是安装。[cwainwright]
0.1 (2009-10-15)
当easyslideshow安装时，从显示菜单中提供了一个幻灯片文件夹视图 - 在卸载时，从显示菜单中删除slideshow_folder_view，并重置使用该视图的任何文件夹为folder_listing。[cwainwright]
创建了一个卸载配置文件，用于从控制面板中删除EasySlideshow配置。[cwainwright]
添加了有关所有图片大小相同的免责声明 - 修复了字幕间距。[cwainwright]
更改了字幕的位置，使其始终位于幻灯片容器的底部，无论图片大小如何 - 使变量描述更详细。[cwainwright]
由于缓存问题，将高度和宽度变量从CSS移动到模板中。[cwainwright]
通过网站设置添加了一个幻灯片控制面板，以便进行自定义功能。[cwainwright]
清理了幻灯片宏代码 - 设置幻灯片在一切加载完成之前隐藏（以避免在幻灯片加载完成之前看到所有幻灯片）[cwainwright]
将样式表和JS移动到skins目录中，以便样式表可以使用dtml。还向样式表中添加了dtml变量，以便幻灯片使用在base_properties中设置的颜色。[cwainwright]
修复了指向portal_url的链接 [cwainwright]
确保在搜索/重新索引之前索引存在 [claytron]
修复了接口路径 [claytron]
不要在skins.xml中设置未更改的选项 - 递归注册皮肤 [claytron]
首次导入基于jQuery的幻灯片产品 [claytron]
collective.easyslideshow-3.0.zip的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 122b344f277b3959e189f73c21650a4f14dcfa8bf6d2e5e4b3053d96d6720b83 |
|
| MD5 | 9e6f17b85fceddf7d6b6bc871624ff3d |
|
| BLAKE2b-256 | a411f83b462939559e0a5ddc22f67e023717cd15be374a3776abaabcb6d3230c |
