PHPackages                             club-1/flarum-ext-cross-references - 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. [Utility & Helpers](/categories/utility)
4. /
5. club-1/flarum-ext-cross-references

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

club-1/flarum-ext-cross-references
==================================

Add cross reference links when a discussion is mentioned from another one.

v1.1.1(3y ago)58.0k↓57.6%2[11 issues](https://github.com/club-1/flarum-ext-cross-references/issues)[1 PRs](https://github.com/club-1/flarum-ext-cross-references/pulls)AGPL-3.0-or-laterPHPPHP >=7.3CI passing

Since Dec 5Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/club-1/flarum-ext-cross-references)[ Packagist](https://packagist.org/packages/club-1/flarum-ext-cross-references)[ GitHub Sponsors](https://github.com/sponsors/n-peugnet)[ RSS](/packages/club-1-flarum-ext-cross-references/feed)WikiDiscussions main Synced 3d ago

READMEChangelogDependencies (6)Versions (22)Used By (0)

CLUB1 Cross-references
======================

[](#club1-cross-references)

[![License](https://camo.githubusercontent.com/5d1137208046c32f5816ef2f15afe28fa539465ff10b3d2a501ee822e1ef2f28/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4147504c2d2d332e302d2d6f722d2d6c617465722d626c7565)](https://camo.githubusercontent.com/5d1137208046c32f5816ef2f15afe28fa539465ff10b3d2a501ee822e1ef2f28/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4147504c2d2d332e302d2d6f722d2d6c617465722d626c7565) [![Latest Stable Version](https://camo.githubusercontent.com/1a445df59d0a4a1139dbd3ddc2f804fa4e523dcaded596d47a5f8f2f3dd77f2f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c75622d312f666c6172756d2d6578742d63726f73732d7265666572656e6365732e737667)](https://packagist.org/packages/club-1/flarum-ext-cross-references) [![Total Downloads](https://camo.githubusercontent.com/a43c8f9c664b4770dd235627c3959692153d8ceeff2ecfaca7770baf50a470dc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c75622d312f666c6172756d2d6578742d63726f73732d7265666572656e6365732e737667)](https://packagist.org/packages/club-1/flarum-ext-cross-references) [![Coverage](https://camo.githubusercontent.com/bf8a6efb52d577bcd9001e0654604045ded6cdfdc80b1d3c2432d5f83cb3a080/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f67682f636c75622d312f666c6172756d2d6578742d63726f73732d7265666572656e6365732f6d61696e3f746f6b656e3d465a464745314d334757)](https://codecov.io/gh/club-1/flarum-ext-cross-references) [![Build Status](https://camo.githubusercontent.com/316ef64e51159e9f69cf201ebbc7293a754e31f746bd7ac16dbfb3e544296aea/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636c75622d312f666c6172756d2d6578742d63726f73732d7265666572656e6365732f636865636b2e796d6c3f6272616e63683d6d61696e)](https://github.com/club-1/flarum-ext-cross-references/actions/workflows/check.yml)

A [Flarum](http://flarum.org) extension. Add cross reference links when a discussion is mentioned from another one.

[![cross reference screenshot](https://camo.githubusercontent.com/96283338ecb4c2ec9ce458f120b3076185097006ca0e5e7a6977b6b778ab8cf1/68747470733a2f2f7374617469632e636c7562312e66722f6e69636f6c61732f70726f6a656374732f666c6172756d2d6578742d63726f73732d7265666572656e6365732f62616e6e65722e706e67)](https://camo.githubusercontent.com/96283338ecb4c2ec9ce458f120b3076185097006ca0e5e7a6977b6b778ab8cf1/68747470733a2f2f7374617469632e636c7562312e66722f6e69636f6c61732f70726f6a656374732f666c6172756d2d6578742d63726f73732d7265666572656e6365732f62616e6e65722e706e67)

Features
--------

[](#features)

This extension is mainly inspired by GitHub cross linking features. It adds similar features to Flarum forums.

- EventPost in target discussion:
    - is created when a post referencing it is saved
    - links back to the source and displays its title
    - shows the ID of the source (option)
    - shows the primary tags of the source (option)
    - shows the secondary tags of the source (option)
- Links in source discussion:
    - are changed to show the title of target discussion when the text is the same as the href
    - have `(comment)` indication if it points to a specific comment
    - load the target discussion faster as they use the *FrontEnd Router*
    - are shown in the preview the way they will be seen once posted
    - are automatically created from `#` text (e.g. `#42`) (option)
    - are auto-completed with a selection box when `#` is entered
    - show the ID of the target (option)
    - show the primary tags of the target (option)
    - show the secondary tags of the target (option)
- Discussion list:
    - shows the ID of the discussions (option)
- HeaderRow
    - shows the ID of the discussion (option)

Known issues
------------

[](#known-issues)

### Discussion links sometimes show plain links instead of the discussion title in rendered post, but are shown as expected in preview.

[](#discussion-links-sometimes-show-plain-links-instead-of-the-discussion-title-in-rendered-post-but-are-shown-as-expected-in-preview)

This is because the renderer is called with `$request = null`. It is probably due to another extension not setting this parameter when calling [`Formatter->render()`](https://api.docs.flarum.org/php/v1.6.0/flarum/formatter/formatter#method_render)or [`CommentPost->formatContent()`](https://api.docs.flarum.org/php/v1.6.0/flarum/post/commentpost#method_formatContent).

Enable [Flarum's debug mode](https://docs.flarum.org/troubleshoot/#step-0-activate-debug-mode)then check [Flarum's log](https://docs.flarum.org/troubleshoot/#step-3-collect-information)to find the source of the issue.

Here is an example of how this issue should be fixed in said extensions: [the-turk/flarum-diff#35](https://github.com/the-turk/flarum-diff/pull/35)

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

[](#installation)

Install with composer:

```
composer require club-1/flarum-ext-cross-references:"*"
```

### Recommendation

[](#recommendation)

This extension alone does not apply the formatting changes to previously posted comments. I you want to reparse all the comments posts of the database it is recommended to install and enable the [`club-1/flarum-ext-chore-commands`](https://github.com/club-1/flarum-ext-chore-commands) extension and use its `chore:reparse` command.

Updating
--------

[](#updating)

```
composer update club-1/flarum-ext-cross-references:"*"
php flarum migrate
php flarum cache:clear
```

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/club-1/flarum-ext-cross-references)
- [GitHub](https://github.com/club-1/flarum-ext-cross-references)
- [Discuss](https://discuss.flarum.org/d/32100)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.3% 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 ~8 days

Recently: every ~19 days

Total

19

Last Release

1151d ago

Major Versions

v0.6.1 → v1.0.02023-02-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/23519418?v=4)[Nicolas Peugnet](/maintainers/n-peugnet)[@n-peugnet](https://github.com/n-peugnet)

---

Top Contributors

[![n-peugnet](https://avatars.githubusercontent.com/u/23519418?v=4)](https://github.com/n-peugnet "n-peugnet (135 commits)")[![rob006](https://avatars.githubusercontent.com/u/5972388?v=4)](https://github.com/rob006 "rob006 (1 commits)")

---

Tags

cross-referencesflarumflarum-extensiongithubflarum

### Embed Badge

![Health badge](/badges/club-1-flarum-ext-cross-references/health.svg)

```
[![Health](https://phpackages.com/badges/club-1-flarum-ext-cross-references/health.svg)](https://phpackages.com/packages/club-1-flarum-ext-cross-references)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

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

1938.7k](/packages/flarum-lang-french)[fof/gamification

Upvotes and downvotes for your Flarum community

4066.1k8](/packages/fof-gamification)[fof/best-answer

Mark a post as the best answer in a discussion

25154.0k20](/packages/fof-best-answer)

PHPackages © 2026

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