PHPackages                             malago/flarum-ext-fancybox - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. malago/flarum-ext-fancybox

ActiveFlarum-extension[Image & Media](/categories/media)

malago/flarum-ext-fancybox
==========================

Image formatting and lightbox modal using fancyBox (original from the-turk and squeevee).

0.3.0(4y ago)01.4k2GPL-3.0-or-laterJavaScript

Since Apr 1Pushed 4y agoCompare

[ Source](https://github.com/malago86/flarum-ext-fancybox)[ Packagist](https://packagist.org/packages/malago/flarum-ext-fancybox)[ RSS](/packages/malago-flarum-ext-fancybox/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (2)Versions (9)Used By (0)

fancyBox Extension for Flarum
=============================

[](#fancybox-extension-for-flarum)

[![GPLv3 license](https://camo.githubusercontent.com/6b8d7ad7a3702389f74a27a2f5b0ab9e9b7774aee6b03ce273edce1096f90ac8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c76332d626c75652e737667)](https://github.com/malago/flarum-ext-fancybox/blob/master/LICENSE) [![Latest Stable Version](https://camo.githubusercontent.com/a305faeec871d8e802339e17612ef4e374fb8d0169427f199398af59e59c145e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616c61676f2f666c6172756d2d6578742d66616e6379626f782e737667)](https://packagist.org/packages/malago/flarum-ext-fancybox) [![Total Downloads](https://camo.githubusercontent.com/dfe14e19c835f3a0ba109b046bd52c157728d3db9411323dfdd155137978d5e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d616c61676f2f666c6172756d2d6578742d66616e6379626f782e737667)](https://packagist.org/packages/malago/flarum-ext-fancybox)

**Disclaimer:** This extension has forked from `the-turk/flarum-ext-fancybox`

[![fancyBox](https://camo.githubusercontent.com/e6f2e0217c92b5476cfa0c8f25dd5fd7920764a089263199408c1ed09b0c0c02/68747470733a2f2f692e6962622e636f2f6b4257444a534c2f66616e6379426f782e706e67)](https://camo.githubusercontent.com/e6f2e0217c92b5476cfa0c8f25dd5fd7920764a089263199408c1ed09b0c0c02/68747470733a2f2f692e6962622e636f2f6b4257444a534c2f66616e6379426f782e706e67)

Features
--------

[](#features)

- Based on [fancyBox v3](https://github.com/fancyapps/fancybox).
- Clicking on an image in a post launches the fancyBox modal. This allows users to zoom in on the image, pan around, and navigate among multiple images, videos or iframes on the same post as a gallery.
- Images are displayed with formatting to normalize sizes and layout.
- If the author of the post has wrapped the image in a link, it will be shown as an external link. (Clicking on the image will not launch the fancyBox modal in this case.)
- Image or URL titles are considered as captions.

**Note:** This extension does not generate thumbnails. The storage location of images, and the file size / bandwidth usage are not affected.

Conflictions
------------

[](#conflictions)

- This package conflicts with `squeevee/flarum-ext-fancybox` and `the-turk/flarum-ext-fancybox`, so you need to remove them first.
- It seems like this package is not compatible with `reflar/recache` (see [\#4](https://github.com/squeevee/flarum-ext-fancybox/issues/4)).

Installation
------------

[](#installation)

```
composer require malago/flarum-ext-fancybox
```

Updating
--------

[](#updating)

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

Usage
-----

[](#usage)

Enable the extension.

### Image layouts

[](#image-layouts)

Image layouts can be controlled by the formatting of the post's markup (e.g., its BBCode or Markdown).

An image is "stand-alone" if it is not in a paragraph with any text or other images, i.e., it is separated from text or other images by *at least two returns*. A stand-alone image is displayed in large format.

[![Example of a stand-alone image](https://camo.githubusercontent.com/f82a3325f2cecbdba9b9164c27746da2df7595dd46848ad5319aafcda7a39365/68747470733a2f2f692e6962622e636f2f706a38686259742f66616e63792d626c6f636b2e706e67)](https://camo.githubusercontent.com/f82a3325f2cecbdba9b9164c27746da2df7595dd46848ad5319aafcda7a39365/68747470733a2f2f692e6962622e636f2f706a38686259742f66616e63792d626c6f636b2e706e67)

An image is "inline" if it is in a paragraph with text or other images. An inline image is displayed in small format, in order to fit into the flow of text.

[![Example of an inline image](https://camo.githubusercontent.com/bd94a1b7ffa03ddc706e32c7825eb4abf060060e51872ad68e751704ea73089b/68747470733a2f2f692e6962622e636f2f6b4442386e64542f66616e63792d696e6c696e652e706e67)](https://camo.githubusercontent.com/bd94a1b7ffa03ddc706e32c7825eb4abf060060e51872ad68e751704ea73089b/68747470733a2f2f692e6962622e636f2f6b4442386e64542f66616e63792d696e6c696e652e706e67)

(For technical reasons, an image is considered inline if it is separated from text or another image by only one return.)

If you have the `flarum/bbcode` extension, you can use `[img fancy=off][/img]` to prevent images from formatting by this extension. This will also exclude them from the fancyBox gallery of the post.

### Links

[](#links)

As mentioned under Features, if an image is wrapped in a link, its behavior and appearance are altered. Most notably, in order to preserve the link, clicking on the image opens the link instead of opening the fancyBox modal. Images within links are also not added to the fancyBox gallery for a post.

[![External linked image](https://camo.githubusercontent.com/fc3be50ea953bb151a269f2c81d6a8da3a2897b70a71a6d7f57cf5f552914dbb/68747470733a2f2f692e6962622e636f2f57473178534e6d2f66616e63792d65787465726e616c2e706e67)](https://camo.githubusercontent.com/fc3be50ea953bb151a269f2c81d6a8da3a2897b70a71a6d7f57cf5f552914dbb/68747470733a2f2f692e6962622e636f2f57473178534e6d2f66616e63792d65787465726e616c2e706e67)

That said, if you have the `flarum/bbcode` extension, you can use `fancy` attribute of the `URL` tag to show videos or iframes on the fancyBox modal. They will be added to the fancyBox gallery of the post.

- Use `[URL fancy=iframe][/URL]` for iframes:

    [![Iframe](https://camo.githubusercontent.com/b76b7369e2de6adf83c4b69cd575056c45c73ac79cf0114fa7f4233f42b1f1f3/68747470733a2f2f692e6962622e636f2f7376486850724d2f66616e63792d696672616d652e706e67)](https://camo.githubusercontent.com/b76b7369e2de6adf83c4b69cd575056c45c73ac79cf0114fa7f4233f42b1f1f3/68747470733a2f2f692e6962622e636f2f7376486850724d2f66616e63792d696672616d652e706e67)
- Use `[URL fancy=video][/URL]` for videos (fancyBox supports YouTube, Vimeo & MP4):

    [![Video](https://camo.githubusercontent.com/3b0cc0672e0076b3b7f0df9687686eca0aba8c13e5fb0638c3a9edd74d822896/68747470733a2f2f692e6962622e636f2f644752727477662f66616e63792d766964656f2e706e67)](https://camo.githubusercontent.com/3b0cc0672e0076b3b7f0df9687686eca0aba8c13e5fb0638c3a9edd74d822896/68747470733a2f2f692e6962622e636f2f644752727477662f66616e63792d766964656f2e706e67)

### Captions

[](#captions)

You need to have the `flarum/bbcode` extension in order to add captions. The `title` attribute of the `IMG` or the `URL` tag will be automatically considered as a caption (the `IMG` tag has the higher priority). Here are some possible usage examples:

[![Caption](https://camo.githubusercontent.com/03e16ef6c85f7562b8b61def47e2adc54632c4815b76e905fd2d13ac959e9fa8/68747470733a2f2f692e6962622e636f2f344e78625a73742f66616e63792d63617074696f6e2e706e67)](https://camo.githubusercontent.com/03e16ef6c85f7562b8b61def47e2adc54632c4815b76e905fd2d13ac959e9fa8/68747470733a2f2f692e6962622e636f2f344e78625a73742f66616e63792d63617074696f6e2e706e67)

```
[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]

```

Links
-----

[](#links-1)

- [Flarum Discuss post](https://discuss.flarum.org/d/19535-fancybox-extension-beta)
- [Source code on GitHub](https://github.com/malago86/flarum-ext-fancybox)
- [Changelog](https://github.com/malago86/flarum-ext-fancybox/blob/master/CHANGELOG.md)
- [Download via Packagist](https://packagist.org/packages/malago/flarum-ext-fancybox)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~112 days

Recently: every ~92 days

Total

8

Last Release

1816d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0fb4954171240619fdf5799c5ff23cc8f9fe21682bb2fae1513a3cf3aee23f8d?d=identicon)[malago](/maintainers/malago)

---

Top Contributors

[![squeevee](https://avatars.githubusercontent.com/u/42689506?v=4)](https://github.com/squeevee "squeevee (12 commits)")[![malago86](https://avatars.githubusercontent.com/u/11331203?v=4)](https://github.com/malago86 "malago86 (3 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/malago-flarum-ext-fancybox/health.svg)

```
[![Health](https://phpackages.com/badges/malago-flarum-ext-fancybox/health.svg)](https://phpackages.com/packages/malago-flarum-ext-fancybox)
```

###  Alternatives

[fof/formatting

Customize TextFormatter with plugins through the admin interface

26112.3k4](/packages/fof-formatting)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)