README

免责声明: 此扩展已从 the-turk/flarum-ext-fancybox 分支而来

功能

• 基于 fancyBox v3。
• 在帖子中点击图片将启动fancyBox模态。这允许用户放大图片、平移并浏览同一帖子上的多个图片、视频或iframe，作为一个画廊。
• 图像以格式显示，以标准化大小和布局。
• 如果帖子的作者在图片周围包裹了链接，它将显示为外部链接。（在这种情况下，点击图片不会启动fancyBox模态。）
• 图像或URL标题被视为标题。

注意: 此扩展不生成缩略图。图像的存储位置、文件大小/带宽使用不受影响。

冲突

• 此包与 squeevee/flarum-ext-fancybox 和 the-turk/flarum-ext-fancybox 冲突，因此您需要先删除它们。
• 似乎这个包与 reflar/recache 不兼容（见 #4）。

安装

composer require malago/flarum-ext-fancybox

更新

composer update malago/flarum-ext-fancybox
php flarum cache:clear

使用

启用扩展。

图像布局

可以通过帖子标记的格式（例如，其BBCode或Markdown）来控制图像布局。

如果图像不在包含任何文本或其他图像的段落中，即它通过至少两个换行符与其他文本或图像分开，则图像是“独立的”。独立的图像以大格式显示。

如果图像在包含文本或其他图像的段落中，则图像是“内联的”。内联图像以小格式显示，以便适应文本流。

（由于技术原因，如果图像仅通过一个换行符与其他文本或图像分开，则被视为内联。）

如果您有 flarum/bbcode 扩展，您可以使用 [img fancy=off][/img] 防止图像被此扩展格式化。这将还将它们排除在帖子的fancyBox画廊之外。

链接

如功能部分所述，如果图像被链接包裹，其行为和外观将改变。最值得注意的是，为了保留链接，点击图像将打开链接而不是打开fancyBox模态。链接内的图像也不会添加到帖子的fancyBox画廊中。

尽管如此，如果您有 flarum/bbcode 扩展，您可以使用 URL 标签的 fancy 属性在fancyBox模态中显示视频或iframe。它们将被添加到帖子的fancyBox画廊中。

• 使用 [URL fancy=iframe] 为iframe

  

• 使用 [URL fancy=video] 为视频（fancyBox支持YouTube、Vimeo和MP4）

  

标题

您需要安装 flarum/bbcode 扩展才能添加标题。 IMG 或 URL 标签的 title 属性将自动被视为标题（IMG 标签具有更高的优先级）。以下是一些可能的用法示例

[img title="Caption this."][/img]
[url title="Caption this." fancy]![](src)[/url]
[url title="Caption this." fancy=video][img][/img][/url]
[url fancy][img title="Caption this."][/img][/url]

链接

• Flarum Discuss 帖子
• GitHub 上的源代码
• 变更日志
• 通过Packagist下载