stezkoy / flarum-feed2forum

v2.1.1 2026-09-30 14:34 UTC

Requires

• php: ^8.3
• flarum/core: ^2.0
• flarum/tags: *
• guzzlehttp/guzzle: ^7.9
• php-feed-io/feed-io: ^6.4

Requires (Dev)

• flarum/phpstan: ^2.0
• flarum/testing: ^2.0

MIT

• Stezkoy

• atom
• rss
• feeds
• discussions
• flarum

Published on Packagist.org on 2026-09-30 14:34 UTC

README

A Flarum 2.x extension that turns RSS/Atom feeds into real forum discussions: each fetched article becomes a native Flarum discussion, created by a user you choose and tagged with up to two tags you bind to the feed.

Русская версия

Features

Real discussions from feeds

• Fetch RSS/Atom sources on a schedule and turn every new article into an immediate, native Flarum discussion.
• One global author user for all imported discussions, configured once in the admin panel.
• Use the article's publication date from the feed as the discussion creation date (or the approval moment — a global setting, article date by default).
• Content converted from HTML (paragraphs, lists, images, links) into Flarum formatting.

Feeds

• Bind up to two tags (one primary + one secondary) to each feed — imported discussions are posted with those tags, including their parents. Tag selection uses the standard Flarum dialog.
• Per-feed publish limit: only the N most recent new articles are kept per fetch (0 = unlimited). In manual mode this also caps how many items land in the approval queue. Articles beyond the limit are skipped permanently — a per-feed "Restore skipped" action brings them back to the queue when you raise the limit.
• Per-feed publish mode: Immediately (auto) or Manually (approval queue).
• Pause any feed with a single toggle — paused feeds are skipped during fetching.
• Preview a feed in the admin panel by fetching it live.

Approval queue & safety

• Manual approval queue — articles wait in the admin panel until you publish each one with a single click (the discussion is created immediately).
• Edit before publishing — adjust the title and the exact post text of a queued item in a dialog before approving it; edits survive feed refreshes and can be reset to the original.
• Restored items whose discussion was deleted from the forum come back with a "Previously deleted" badge and are never auto-published — you decide.
• Skipped items stay in the database as tombstones, so they are never re-imported.
• Deduplicate articles by their GUID/link so nothing is imported twice.
• Clear the whole queue or refresh all feeds on demand with dedicated buttons.
• Publish all — approve every pending item at once (restored "Previously deleted" items stay for individual review).

Work log

• A collapsible log below the queue shows fetches, publications, skips and errors.
• Capped at 500 rows in the database (pruned on every write), the admin panel loads only the last 100 entries.

Performance & ops

• Heavy work (feed fetching and discussion creation) runs as queue jobs (Flarum\Queue).
• Fetch interval is set in minutes (default 60) via the Flarum scheduler.
• Optional link to the original article at the beginning of each imported post (can be disabled globally).
• Configurable article text retention — old published/skipped items keep their dedup skeleton while the full text is pruned from the database.
• English and Russian locales.

Requirements

• Flarum ^2.0
• PHP ^8.3
• flarum/tags (installed automatically as a dependency)

Installation

composer require stezkoy/flarum-feed2forum
php flarum migrate
php flarum cache:clear

Enable Feed2Forum from the Flarum admin panel.

Update

composer update stezkoy/flarum-feed2forum
php flarum migrate
php flarum cache:clear

Admin Configuration

Open Admin → Extensions → Feed2Forum.

General settings

• Author — the user who authors imported discussions. Select any user; removal/change is supported.
• Check frequency (minutes) — how often feeds are fetched through the Flarum scheduler (default 60 minutes).
• Add links to original articles — show or hide the "Original article" link at the beginning of each imported post (on by default).
• Use the article's RSS date — when enabled (default), imported discussions are dated with the article's publication date from the feed; when disabled, with the moment they are approved or published.
• Article text retention (days) — full text of published and skipped items older than this is removed from the database (default 90; 0 = keep forever). Deduplication is not affected.

Feeds

Each row of the Feeds table is edited in place and saved on blur:

• Title and URL of the feed.
• Tag — up to two tags (one primary + one secondary) imported discussions are posted with (opened via the standard tag dialog).
• Publish limit — how many of the newest new articles are kept per fetch (leave empty for 5, set 0 for unlimited).
• Publishing — per-feed mode: Immediately or Manually (approval queue).
• Status — toggle to pause/resume the feed.
• Actions — Fetch now, Preview (fetch the feed live) and Delete.

Add new feeds via the blank row at the bottom of the table. Use Check all feeds now (top right) to trigger a manual fetch of every active feed.

Approval queue

Feeds in Manually mode place their new articles here: publish any of them with one click, publish everything at once, skip them, or clear the whole queue. Every item has an Edit dialog — adjust the title and the exact post text before approving. Restored items are marked with a "Previously deleted" badge, edited items with an "Edited" badge.

Work log

A collapsible log below the queue: fetches, publications, skips and errors. Refresh or clear it with the toolbar buttons.

Fetching Feeds

The extension registers the feed2forum:fetch command.

Fetch all active feeds:

php flarum feed2forum:fetch

Inspect a single URL without storing it:

php flarum feed2forum:fetch "https://example.com/feed.xml"

The command does not fetch anything itself: it dispatches one FetchFeedJob per active feed into the Flarum queue. Each job reads the feed, stores new items and (in auto mode) dispatches PublishItemJob jobs that create the discussions.

With the default sync driver every job runs inline, so the extension works out of the box — but for many feeds or posts, configure a real queue (database/Redis) and run a worker:

php flarum queue:work

The command runs on the interval chosen in the settings through Flarum's scheduler. Make sure your server runs the Flarum scheduler, for example:

* * * * * cd /path/to/flarum && php flarum schedule:run >> /dev/null 2>&1

How It Works

All steps below run asynchronously through the Flarum queue (default driver: sync).

1. On each run the fetcher reads every active feed.
2. New articles (not seen before, deduplicated by GUID/link) are stored with their RSS publication date.
3. Existing articles are updated with the latest title/content/date and never re-imported.
4. Items whose discussion was deleted on the forum are restored to the queue with a "Previously deleted" badge (manual approval only).
5. In auto mode, up to the feed's publish limit of the newest new articles are converted into discussions right away.
6. In queue mode, nothing is published automatically — approve articles from the admin panel instead.
7. Each discussion gets:
   • the article's RSS publication date as its creation date (or the approval moment, depending on the setting),
   • content converted from HTML (paragraphs, lists, images, links) plus the source link,
   • the configured global author as its author,
   • the feed's tags (including their parent tags) applied.

Links

GitHub Repository · Packagist

License

MIT