Skip to main content

Install

Requirements

  • XenForo 2.3.0 or newer.
  • PHP 7.4 or newer.

Install

  1. Download the release archive and extract it into your installation. The src/addons/MC/ThreadSplit/ directory should sit alongside the other add-ons.
  2. Navigate to AdminCP > Add-ons and click Install next to [MC] Thread Split. The add-on creates its own chain and override tables (xf_mc_threadsplit_chain, xf_mc_threadsplit_chain_thread, xf_mc_threadsplit_forum_config, xf_mc_threadsplit_thread_override).
  3. Two cron entries are activated automatically: Process pending splits (runs every minute) and Cleanup stuck splits (runs every 15 minutes).

First-run checklist

  1. Visit AdminCP > Setup > Options > [MC] Thread Split. Confirm Enable auto-split globally is on, then choose a default threshold and split mode.
  2. Edit the forums where auto-split should fire. Per-forum overrides let you enable, disable, or change thresholds independently of the global default. See per-forum overrides.
  3. Navigate to AdminCP > Groups & permissions > Permissions and grant the moderator permissions (Manual split, Override thread split, Detach from chain) to the groups that should hold them. See permissions.
  4. Optionally update the Title template and Continuation post template to match your house style.

Verifying the install

  • Confirm Active at AdminCP > Add-ons > [MC] Thread Split.
  • Confirm both cron entries are listed at AdminCP > Tools > Cron entries with [MC] Thread Split in the title.
  • Open AdminCP > Logs > Thread Split errors. The list will be empty on a fresh install.