entidi/silverstripe-gallery

一种新的页面类型,可以嵌入响应式、触摸屏支持的图片画廊,带有条形缩略图导航和可缩放的幻灯片

安装: 282

依赖项: 0

建议者: 1

安全: 0

星标: 2

关注者: 2

分支: 4

语言: Scheme

类型: silverstripe-module

3.1.1 2022-05-17 12:23 UTC

This package is auto-updated.

Last update: 2024-09-17 17:32:21 UTC


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>

请注意,默认模板仅使用HeightThumbnailHeight设置:它们必须设置为大于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