purplespider / basic-galleries
基础照片画廊功能
3.1.0
2023-07-11 11:35 UTC
README
简介
为 Silverstripe 网站提供基本的图片画廊功能。
旨在为用户提供一种简单、易用的方式,将图片画廊添加到他们的网站中。
将 基本图片画廊扩展 应用到 PhotoGalleryPage
页面类型,并包括 PhotoGalleryHolder
类型。
维护者联系方式
- James Cocker (ssmodulesgithub@pswd.biz)
需求
- Silverstripe 5
安装说明
-
安装
composer require purplespider/basic-galleries ^3
-
访问 yoursite.com/dev/build 重建数据库。
-
登录 CMS,并创建一个新的照片画廊持有者页面。
-
然后您可以在该持有者下创建照片画廊页面。
-
在照片画廊页面上,点击图像画廊选项卡,然后点击批量上传添加图片。
截图
配置
您可以自定义画廊在 CMS 中显示的选项卡,以及 CMS 中显示的画廊标题。
HomePage:
extensions: - PurpleSpider\BasicGalleries\PhotoGalleryExtension
gallery-title: Image Gallery
gallery-cms-tab: Main
自动删除图像文件
当从画廊中删除图像时自动删除图像文件
--- Name: custom-basic-gallery-extension After: basic-gallery-extension --- PurpleSpider\BasicGalleryExtension\PhotoGalleryImage: ondelete_delete_image_files: true
这使用 Delete Asset If Unused Extension 检测图像是否在网站的其他地方使用,并且只有在未使用时才会删除。但也有一些限制,因此请检查该模块的说明,例如,您可能不想在已从 Silverstripe 3 升级的网站上使用此功能。
版本详细信息
- 0.* = SilverStripe 3
- 1.* = Silverstripe 4
- 2.* = Silverstripe 4(使用较新的
PhotoGalleryExtension
版本,具有多态关系,因此从 1 升级到 2 将破坏现有的画廊。) - 3.* = Silverstripe 5
升级说明
到 v1 或更高版本(扩展移动到单独的模块)
- 更改对扩展的任何引用,例如,如果应用于主页类型,则从
PurpleSpider\BasicGalleries\PhotoGalleryExtension
更改为PurpleSpider\BasicGalleryExtension\PhotoGalleryExtension
PurpleSpider\BasicGalleries\PhotoGalleryImage
现在是PurpleSpider\BasicGalleryExtension\PhotoGalleryImage
(如果您已将其应用到自己的扩展中)- 运行 dev/build 自动更新表名(通过 legacy.yml)
到 v2 或更高版本(单个页面和元素关系更改为单个多态关系)
- 完整的 "到 v1" 升级说明,包括
dev/build
- 运行
/dev/tasks/upgrade-basic-galleries
脚本以更新现有画廊的数据库。
到 v3(Silverstripe 5)
- 不需要额外操作,只需将版本更改为
^3
。