PHPackages                             squeevee/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 &amp; Media](/categories/media)
4. /
5. squeevee/flarum-ext-fancybox

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

squeevee/flarum-ext-fancybox
============================

Image formatting and lightbox modal using FancyBox. (see https://fancyapps.com/fancybox)

0.2-beta(7y ago)52.1k4[3 issues](https://github.com/squeevee/flarum-ext-fancybox/issues)[1 PRs](https://github.com/squeevee/flarum-ext-fancybox/pulls)GPL-3.0-or-laterJavaScriptCI failing

Since Apr 1Pushed 5y agoCompare

[ Source](https://github.com/squeevee/flarum-ext-fancybox)[ Packagist](https://packagist.org/packages/squeevee/flarum-ext-fancybox)[ RSS](/packages/squeevee-flarum-ext-fancybox/feed)WikiDiscussions master Synced 2d ago

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

FancyBox Extension for Flarum
=============================

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

Image formatting and lightbox modal using FancyBox.

For more information about FancyBox, see:

Features
--------

[](#features)

- 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 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.)

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

Usage
-----

[](#usage)

### 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/468fa8f3612049b6012f923f1b142eb87c2b012eb9d0bb9ed3ce45f33b1aa965/68747470733a2f2f692e696d6775722e636f6d2f6b3745707030542e706e67)](https://camo.githubusercontent.com/468fa8f3612049b6012f923f1b142eb87c2b012eb9d0bb9ed3ce45f33b1aa965/68747470733a2f2f692e696d6775722e636f6d2f6b3745707030542e706e67)

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/dc3c83735d3535477fcbbe6fd037b624f91d798eaedada4f3af4ef9d2b5219db/68747470733a2f2f692e696d6775722e636f6d2f784c4b7752686e2e706e67)](https://camo.githubusercontent.com/dc3c83735d3535477fcbbe6fd037b624f91d798eaedada4f3af4ef9d2b5219db/68747470733a2f2f692e696d6775722e636f6d2f784c4b7752686e2e706e67)

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

### Image links

[](#image-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 image in the FancyBox modal. Images within links are also not added to the FancyBox gallery for a post.

As an indicator of this altered behavior, images in links have a visible margin and an external link icon. Stand-alone images in links are displayed smaller than usual.

[![Example of a standalone image wrapped in a link](https://camo.githubusercontent.com/442e5a76178d0736b20820f182cad5cca499ccce195d8f70954ef5feb89d3d81/68747470733a2f2f692e696d6775722e636f6d2f45637448314b542e706e67)](https://camo.githubusercontent.com/442e5a76178d0736b20820f182cad5cca499ccce195d8f70954ef5feb89d3d81/68747470733a2f2f692e696d6775722e636f6d2f45637448314b542e706e67)

Note that, if desired, text may also be placed *within* the same link as an image, as well as multiple images. This, of course, will cause the image to be inline rather than stand-alone.

[![Example of an inline image wrapped in a link with some text](https://camo.githubusercontent.com/c343877f3e0f945319ec9a9ba3885abfbdd502f5ffa8682924f7234c08806e01/68747470733a2f2f692e696d6775722e636f6d2f6f4669445843722e706e67)](https://camo.githubusercontent.com/c343877f3e0f945319ec9a9ba3885abfbdd502f5ffa8682924f7234c08806e01/68747470733a2f2f692e696d6775722e636f6d2f6f4669445843722e706e67)

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

[](#installation)

Install this extension with Composer using the command

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

```

Support
-------

[](#support)

This extension is currently in beta. To report a bug, please open an issue on the GitHub repo:

License
-------

[](#license)

This extension is licensed under GPLv3. This extension is not affiliated with or endorsed by the makers of FancyBox.

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance8

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~29 days

Total

2

Last Release

2617d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2ff330fbf48891d6e634289edf98c31dbdd5d97e03a965fb0c2497edf36fe4eb?d=identicon)[squeevee](/maintainers/squeevee)

---

Top Contributors

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

### Embed Badge

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

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

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12127.5k](/packages/flarum-lang-russian)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1936.5k](/packages/flarum-lang-french)[fof/formatting

Customize TextFormatter with plugins through the admin interface

27118.3k5](/packages/fof-formatting)[flarum-lang/german

German language pack for Flarum.

2149.7k](/packages/flarum-lang-german)

PHPackages © 2026

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