entidi / silverstripe-gallery
一种新的页面类型,可以嵌入响应式、触摸屏支持的图片画廊,带有条形缩略图导航和可缩放的幻灯片
Requires
Suggests
- entidi/silverstrap: A silverstripe theme that supports silverstripe-gallery out of the box
README
一种新的页面类型(GalleryPage),提供管理相册所需的一切。
您可以通过在CMS内专用标签(Gallery)中拖放缩略图来批量上传图片并重新排序。同一图片可以共享到多个画廊中。
用法
您可以编写自己的模板并支持您选择的JavaScript库。默认情况下,使用的是Fotorama库。您可以通过包含ContentGallery.ss来在您的页面上嵌入默认的画廊块,例如。
<%-- This is a typical Page.ss --%>
<h1>$Title</h1>
<div class="gallery">
<% include ContentGallery.ss %>
</div>
<div class="content">
$Content
</div>
请注意,默认模板仅使用Height和ThumbnailHeight设置:它们必须设置为大于0的值,否则将生成错误。默认情况下,它们应由CMS分别设置为400和64。
或者,还提供了GalleryPage.ss布局模板。它渲染一个完整的(标准)页面,尽管它仅与silverstrap一起使用,因为它依赖于该主题采用的一些约定。
配置
此模块向设置标签添加了一些字段。这将在运行时允许根据页面定制画廊的一些方面,例如缩略图条的高度、图片幻灯片的高度以及显示或隐藏标题的标志。
可以通过利用SilverStripe 配置API来自定义回退值。只需在mysite/_config中创建自己的YAML文件,例如。
---
Name: DefaultSettings
After:
- 'gallery/*'
---
GalleryPage:
defaults:
Captions: false
Height: 480
ThumbnailWidth: 0
ThumbnailHeight: 80
上述设置将应用于每个 GalleryPage类的实例。
作者
尽管该项目最初是silverstripe-gallery的分支,由i-lateral创建,但实际代码几乎是从头开始由ntd重写的,除了名称外,几乎所有其他内容都发生了变化。
该项目的主页与其他SilverStripe模块和主题共享。
要查看代码、报告问题或提出改进建议,请访问专用跟踪器。或者,您也可以通过利用官方github仓库来完成这些操作。
安装
画廊模块作为silverstripe-carousel的扩展实现,因此您必须先安装它。这将反过来安装sortablefile模块,该模块提供拖放重新排序功能。
要安装silverstripe-gallery本身,您应按常规操作进行:将目录树放入您的SilverStripe根目录,并执行/dev/build/。您将在CMS中获得新的GalleryPage类型。
如果您使用composer,依赖项将自动拉取,因此您只需运行以下命令
composer require entidi/silverstripe-gallery dev-master