Skip to content

Link between articles with [[Article name]] - #22

Merged
bonelifer merged 4 commits into
mainfrom
article-links
Oct 7, 2026
Merged

bonelifer merged 4 commits into
mainfrom
article-links

Conversation

@bonelifer

Copy link
Copy Markdown
Contributor

Adds links between wiki articles, as asked for in the extension's phpBB.com topic.

  • Syntax: [[Article name]] links to that article; [[Article name|other text]] shows different text. It works in wiki articles and in forum posts. Brackets inside [code] stay plain text.
  • Missing articles: links to articles that don't exist yet are shown in red with a tooltip, and following one opens the editor to create the article.
  • What links here: each article lists the articles whose current version links to it.
  • Editor button: a "Wiki link" button in the editor toolbar inserts the brackets, with a tooltip and screen-reader text.
  • Older text: gets its links when next edited, or all at once with php bin/phpbbcli.php reparser:reparse phpbbmodders_wiki_article (and post_text for posts). The README documents this, with three new screenshots.

@ was avoided on purpose: phpBB 4.0 uses @name to mention members.

How it works: the text formatter turns the markup into a WIKILINK tag that renders without an address; after rendering, the extension adds each link's address from the wiki's own route and marks the articles that don't exist. "What links here" is read from the stored article text, so there is no new table or migration.

Testing
Claude added a phpbbmodders/wiki check to phpbbmodders/phpbb-release-tools' feature_checks.py (branch wiki-feature-check): all 8 checks pass on this branch and the link checks fail on main, as they should. The smoke test is clean, the new PHP passes php -l on PHP 7.4, template_a11y.py reports nothing, and Claude checked that the reparser converts older articles and posts.


Investigated and written by Claude on behalf of William Jacoby (bonelifer).

Write [[Article name]] or [[Article name|link text]] in a wiki article or
a forum post to link to that article. The text formatter turns the markup
into a WIKILINK tag; after rendering, the extension points each link at
the article's route and marks links to articles that don't exist yet
(shown in red, opening the editor). Brackets inside [code] stay text.

Each article lists the articles whose live version links to it under
"What links here". A "Wiki link" button in the editor toolbar inserts
the brackets, with a tooltip and screen-reader text.

README documents the syntax, the reparser commands for older text, and
three new screenshots.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bonelifer
bonelifer requested a review from kaileymsnay October 7, 2026 18:40
bonelifer and others added 3 commits October 7, 2026 13:52
All nine README screenshots now come from phpbb-test-board's screenshots.py
on a prosilver board, so they match and can be regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bonelifer
bonelifer merged commit 5d0f736 into main Oct 7, 2026
122 of 124 checks passed
@bonelifer
bonelifer deleted the article-links branch October 7, 2026 20:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant