Skip to main content

Install

Requirements

  • XenForo 2.3.0 or newer.
  • Outbound HTTP (and HTTPS) from the web server to feed origins.

Install

  1. Download the release archive and extract it into your installation. The src/addons/MC/NewsAggregator/ directory should sit alongside the other add-ons.
  2. Navigate to AdminCP > Add-ons and click Install next to [MC] News Aggregator.
  3. Two cron entries are activated automatically: Fetch feeds (runs on its configured cadence to pull new items from active sources) and Prune news items (enforces the retention policies).

First-run checklist

  1. Visit AdminCP > [MC] News Aggregator > Sources. Add at least one feed URL. See sources.
  2. Visit AdminCP > Setup > Options > [MC] News Aggregator. Set the retention windows, fetch concurrency and timeout, and the duplicate-detection threshold to suit your traffic. See options overview.
  3. Optionally configure the global news ticker under the Ticker section of the options. See ticker and widget.
  4. Navigate to AdminCP > Groups & permissions > Permissions and grant View news feed to the groups that should see the public page and ticker.

Verifying the install

  • Confirm the add-on is Active at AdminCP > Add-ons.
  • After the Fetch feeds cron runs once (or trigger it manually under AdminCP > Tools > Cron entries), visit /news/. Recent items from your active sources should be listed.
  • Confirm both cron entries are listed at AdminCP > Tools > Cron entries with [MC] News Aggregator in the title.