dorsetdigital / silverstripe-photoswipe
允许在页面上嵌入一个简单的由Photoswipe提供的相册
v1.0
2019-10-15 11:07 UTC
Requires
- bummzack/sortablefile: ^2.0
- silverstripe/cms: ^4.0
- silverstripe/vendor-plugin: ^1.0
This package is auto-updated.
Last update: 2024-09-15 21:48:57 UTC
README
提供了一种简单的方法,通过使用Photoswipe库在页面上嵌入响应式图像相册。
包括相册功能以及一个懒加载的缩略图加载器,有助于提高页面加载效率。
如果你使用Elemental,可以在以下位置找到这个附加组件的版本,以便在页面块中使用:https://github.com/DorsetDigital/silverstripe-photoswipe-elemental
需求
- Silverstripe 4.x
- bummzack/sortablefile
当前的前端代码需要jQuery才能运行。如果您网站上还没有jQuery,可以通过简单的需求调用添加,例如:
Requirements::javascript('https://code.jqueryjs.cn/jquery-3.3.1.min.js');
安装
- 使用以下命令安装代码:
composer require dorsetdigital/silverstripe-photoswipe
- 运行
dev/build?flush
以更新您的项目
使用方法
默认情况下,该模块不会向您的网站添加任何内容。您可以通过添加一个yml配置文件来选择要扩展的页面类型。您需要将扩展添加到Page类本身以及其控制器,以便所有功能都能正常工作。以下示例将相册功能添加到基本页面类,因此它将可用于扩展该类的任何页面
--- Name: photoswipe-gallery --- PageController: extensions: - DorsetDigital\SilverstripePhotoswipe\ControllerExtension Page: extensions: - DorsetDigital\SilverstripePhotoswipe\PageExtension
要将相册添加到实际页面,您还需要添加一个新模板变量,例如:
<div class="mygalleryholder">
$Gallery
</div>
用于生成标准相册标记的模板可以被覆盖,但请注意,某些标记结构是必需的,以便使一切正常工作!
致谢
- 出色的PhotoSwipe库 - http://photoswipe.com/
- Bummzack的SS4排序文件扩展 - https://github.com/bummzack/sortablefile