产品.轮播图 3.0.2

配置轮播图横幅文件夹

Carousel 显示的项目称为“Carousel 横幅”，可以存在于网站任何部分的“Carousel 文件夹”中。为了演示目的，让我们在网站根目录中添加一个 Carousel 文件夹。

Carousel 文件夹更多是配置问题而不是内容问题，因此它们不会出现在“添加”菜单中。相反，有一个“Carousel”标签。在尚未拥有 Carousel 文件夹的某个部分中单击它将导致创建一个新的文件夹

>>> browser.open('http://nohost/plone')
>>> browser.getLink('Carousel').click()
>>> browser.url
'http://nohost/plone/carousel/@@edit-carousel'

新文件夹现在应该提供 ICarouselFolder 接口

>>> from Products.Carousel.interfaces import ICarouselFolder
>>> ICarouselFolder.providedBy(self.portal.carousel)
True

另一方面，如果我们已经在一个已经拥有 Carousel 文件夹的文件夹中，则将使用现有的一个

>>> browser.goBack()
>>> browser.getLink('Carousel').click()
>>> browser.url
'http://nohost/plone/carousel/@@edit-carousel'

如果我们尝试在已经进行配置时配置 Carousel，则不应发生任何变化

>>> browser.getLink('Carousel').click()
>>> browser.url
'http://nohost/plone/carousel/@@edit-carousel'

添加轮播图横幅

现在我们已经处于 Carousel 文件夹中，我们可以使用添加菜单添加 Carousel 横幅

>>> browser.getLink('Carousel Banner').click()
>>> browser.url
'http://nohost/plone/carousel/portal_factory/Carousel...Banner/carousel_banner.../edit...'

我们可以设置各种内容，包括标题、目标 URL 和图片

>>> browser.getControl('Title').value = 'Pirates and Cowboys agree: Ninjas suck'
>>> browser.getControl('Link URL').value = 'http://www.plone.org'
>>> browser.getControl(name='image_file')
<Control name='image_file' type='file'>
>>> browser.getControl('Save').click()
>>> 'Changes saved.' in browser.contents
True

我们需要发布新的横幅。

>>> browser.getLink('Publish').click()

查看横幅

现在，如果我们返回到最初配置横幅的首页，我们刚刚添加的横幅应该被渲染（在标签之前）

>>> browser.open('http://nohost/plone')
>>> browser.contents
<BLANKLINE>
...Pirates and Cowboys...
...class="contentViews"...

在其他场景中添加横幅

非结构化文件夹：将横幅放在包含文件夹中

>>> self.setRoles(['Manager'])
>>> self.portal.invokeFactory('Folder', 'nonstructural')
'nonstructural'
>>> from zope.interface import alsoProvides
>>> from Products.CMFPlone.interfaces import INonStructuralFolder
>>> alsoProvides(self.portal.nonstructural, INonStructuralFolder)
>>> browser.open('http://nohost/plone/nonstructural')
>>> browser.getLink('Carousel').click()
>>> browser.url
'http://nohost/plone/carousel/@@edit-carousel'

集合，非默认项目：将横幅放在集合本身中

>>> try:
...     self.portal.invokeFactory('Topic', 'collection')
...     self.portal.default_page = 'collection'
... except:
...     self.portal.invokeFactory('Collection', 'collection')
'collection'
>>> browser.open('http://nohost/plone/collection')
>>> browser.getLink('Carousel').click()
>>> browser.url
'http://nohost/plone/carousel/@@edit-carousel'

3.0.2 (2017-04-11)

• 通过添加 Products.PloneTestCase 作为测试依赖项，在 4.3 版本中修复了测试。 [maurits]

3.0.1 (2017-03-07)

• 从接口中删除了标签，以修复权限错误。

• 将宽度和高度添加到横幅对象中，因为我们无法从宏中访问视图。

• 修复了一些小错误，并更新了 MANIFEST.in [jladage]

3.0 (2017-03-06)

• 为横幅添加了 Retina 支持。只需上传双倍大小的图片即可。因此，如果您将 Carousel 设置为 800x350 像素，现在可以上传大小为 1600x350 像素的图片。在 Retina 屏幕上，您的横幅将具有更多的细节。

  • 使用 @@images 生成到具有在 Carousel 选项中定义的尺寸的缩放图像的 url。这提高了加载速度，因为它们被永久缓存在浏览器中。它还防止用户使用过大的图片。

  • 模板现在有两个尺寸，一个用于常规屏幕，另一个用于 Retina 版本的 2x 图像，并在 srcset 属性中定义它。当使用懒加载时，JavaScript 简单地添加 srcset。

  • 从本版本开始，不再支持 Plone 3。

  [jladage]

• 添加了 z3c.autoinclude-entrypoint 以将其标记为 Plone 插件。这避免了显式加载 zcml-slug 的需要。 [WouterVH]

• 添加了巴西葡萄牙语翻译。 [lepri]

• 添加了德语翻译。 [pabo3000]

• 更新了内容类型的图标：Carousel 横幅。 [taito]

• 在创建横幅文件夹时，通过 ISelectableConstrainTypes 适配器设置 exclude_from_nav 和限制类型，以与 plone.app.contenttypes (Dexterity) 文件夹兼容。 [danjacka]

2.2.1 (2013-03-15)

• 修复了悬停时的错误。 [kroman0]

2.2 (2012-12-12)

• 添加了对显示和隐藏 carousel 视图的支持。 [taito]

• 懒加载 carousel 图像 [miohtama]

• 不要显示 carousel 图像上的 <img alt=""> 文本，因为它会导致部分加载的 carousel 图像产生混淆 [miohtama]

• 添加了复选框以启用懒加载 carousel 图像。 [kroman0]

• 添加了复选框以随机化显示图片的顺序 [miohtama]

• 添加了对 Plone 4.3 的兼容性 [davilima6]

2.1 (2011-09-06)

• 更新了 i18n 辅助脚本，以反映当前翻译。 [yomatters]

• 添加了芬兰语翻译。 [datakurre]

• 允许具有站点管理员角色的用户默认添加 Carousel 横幅。 [davisagli]

• 添加了集体.googleanalytics跟踪插件，用于跟踪横幅点击。[yomatters]

• 添加了荷兰语翻译。[jladage]

2.1b3 (2011-01-19)

• 将默认横幅更改为首先使用图片URL，然后回退到上传的图片。[yomatters]

• 使Carousel尊重横幅文件夹的顺序。[yomatters]

• 修复了滑动Carousel的动画逻辑。[yomatters]

• 使链接URL成为可选的。[yomatters]

• 添加了输入外部图片URL的能力，而不是上传图片。[yomatters]

• 修复了影响未发布Carousel文件夹的权限问题。[yomatters]

• 修复了Carousel横幅查找，以便尊重横幅查看权限。[yomatters]

• 修复了影响包含ID为“carousel”但不是Carousel文件夹的项目的文件夹的bug。[yomatters]

2.1b2 (2010-12-08)

• 修复了Plone 3上的javascript错误。[yomatters]

2.1b1 (2010-12-06)

• 修复了已知良好版本设置链接。[yomatters]

• 使添加和修改横幅的说明更加突出。[yomatters]

• 添加了设置Carousel ID的选项。[yomatters]

2.0 (2010-11-19)

• 将插件拆分为函数，使覆盖Carousel行为的一部分更容易。[yomatters]

2.0b1 (2010-09-30)

• 添加了滑动作为可能的过渡类型。[yomatters]

• 重构javascript作为jQuery插件，触发过渡时的jQuery事件。[yomatters]

• 添加了设置横幅和翻页器外观以及过渡长度和类型的选项。[yomatters]

• 添加了可选的翻页器，用于在横幅之间导航。[yomatters]

• 将Carousel横幅上的描述字段替换为富文本正文字段。[yomatters]

• 移除浏览器层，以帮助在Plone 2.5中使用。[davisagli]

1.1 (2010-03-26)

• 在Plone 4中，默认将视图小部件添加到上述内容视图小部件管理器中，以避免奇怪的样式。[davisagli]

• 添加了西班牙语翻译。[tzicatl]

• 在Carousel中仅显示已发布的横幅，即使用户有查看其他横幅的权限也不例外。[davisagli]

1.0 (2009-03-31)

• 更改了文本链接的行为，使其在鼠标悬停时交换横幅。[davisagli]

1.0b3 (2009-02-07)

• 将“Carousel横幅”添加到不进行搜索的类型中。[davisagli]

• 正确定位用作默认页面的容器（例如，主题）上的carousel文件夹。[davisagli]

• 为横幅类型的getSize和tag方法应用适当的权限声明，以便在TTW定制时视图可以正常工作。[davisagli]

• 仅在默认视图中显示carousel；不在任何其他选项卡中。[davisagli]

• 修复了卸载时视图小部件移除的问题。[davisagli]

• 修复了快速安装器中的重复条目。[davisagli]

1.0b2 (2009-02-04)

• 声明我们自定义GS导入步骤对视图步骤的依赖。[davisagli]

• 将（全局注册的）模板与（本地注册的）视图小部件分开，这样就可以使用portal_view_customizations对前者进行定制。[davisagli]

• 将横幅描述添加到模板中。将“carousel-title”类更改为“carousel-button”，这样我就可以将“carousel-title”和“carousel-description”分开。[davisagli]

• 正确处理非结构化文件夹。[davisagli]

1.0b1 (2009-02-03)

• 初始发布。[davisagli]