Skip to main content

Install

Requirements​

  • XenForo 2.3.0 or newer.
  • SV/StandardLib 2.15.0 or newer (hard dependency).

Optional integrations:

  • SV/RedisCache — pattern-based cache purges run automatically when present.
  • SV/FontAwesomeNodeIcons — when active, supplies per-node icons used as the card-view cover fallback.

Install​

  1. Install the dependencies (SV/StandardLib) first if they are not already active.
  2. Download the release archive and extract it into your installation. The src/addons/MC/ForumLayouts/ directory should sit alongside the other add-ons.
  3. Navigate to AdminCP > Add-ons and click Install next to [MC] Forum Layouts. The add-on adds columns to xf_node, xf_user_option, and indexes to xf_thread.

First-run checklist​

  1. Visit AdminCP > Setup > Options > [MC] Forum Layouts. Pick a default layout, confirm which alternate layouts are enabled, and decide whether users may toggle between them.
  2. Navigate to AdminCP > Groups & permissions > Permissions and grant Toggle forum layouts to the member groups that should be able to switch layouts. See permissions.
  3. Edit the forums that should opt out of the alternate layouts and untick the per-forum display flags. See per-forum settings.
  4. For card view, optionally upload a cover image and set a node colour for each forum.
  5. Optionally remove branding under AdminCP > Setup > Options > [MC] Forum Layouts > General. See General options.

Verifying the install​

  • Confirm the add-on is listed as Active at AdminCP > Add-ons.
  • Visit /forum-layouts/ on the front-end; the configured default layout should render.