README

为 SilverStripe 3.1 实现幻灯片/轮播图/滑块后端支持的幻灯片模块。为了演示目的，它附带了一个使用 slick 的即插即用示例。它可以很容易地移除而不会影响功能。更多关于 slick 的内容，请参阅下面的 slick 部分。

安装

一般来说，在安装模块之前备份您的数据库并以管理员身份登录您的网站是一个好主意，尽管没有什么会出错，但您仍然可以这样做。

要求

SilverStripe 3.1

使用 Composer

打开终端并 cd 到您的 SilverStripe 根目录。
运行 composer require kreationsbyran/kb-slideshow。
转到 http://your.site/dev/build?flush=all（用您网站的网址替换 "your.site"）

手动

下载主分支的压缩文件（这里）。
将内容移动到您的 SilverStripe 安装根目录。
转到 http://your.site/dev/build?flush=all（用您网站的网址替换 "your.site"）

此外（可选）

KBSlideshow 与 SortableGridField 配合良好，允许拖放排序幻灯片。

用法

在模板中

在 SilverStripe 模板中使用 <% include KBSlideshow %> 将包含默认模板。您可以轻松地替换或编辑此模板。

/templates/includes/KBSlideshow.ss markup ouput

├──div.kbslideshow (if exists)
|  └──div.kbslide  (loop)
|     ├──img       (if exists)
|     ├──h1        (if exists)
|     └──p         (if exists)

在 CMS 中

该模块扩展了页面，一旦安装，它将在所有页面的 CMS 中创建一个名为“幻灯片”的标签页。

"调整图像宽高比"将设置所有幻灯片的宽高比，如果两个选项都设置了。如果只设置了其中一个，则将使用 SilverStripes 的 Image.SetWidth() 或 Image.SetHeight() 函数裁剪图像。如果没有设置任何选项，则选定的图像不会被调整大小或裁剪，可能导致负载过重。如果幻灯片包含图像，建议至少设置一个。

Slick

该模块附带了一个使用 slick 的演示。为了使用不同的幻灯片/滑块/轮播图库而移除模块与 slick 之间的耦合，只需遵循以下两个步骤

删除 /templates/includes/KBSlick.ss。
从 /templates/includes/KBSlideshow.ss 中删除 <% include KBSlick %>。

设置

如果您希望继续使用 slick，您将在 /templates/includes/KBSlick.ss 中找到设置。目前没有后端支持来管理 slick 设置，但可以很容易地通过修改 KBSlideshow 类来添加。

许可

版权（c）2015 Kreationsbyrån Sverige AB

MIT 许可证下授权

kreationsbyran / kb-slideshow

维护者

详细信息