Skip to main content

Install

Requirements​

  • [MC] Downloads Manager 0.6.0 or newer.
  • XenForo 2.3.0 or newer.

Install​

  1. Download the release archive and extract it into your installation. The src/addons/MC/NSFWGateForDM/ directory should sit alongside Downloads Manager.
  2. Navigate to AdminCP > Add-ons and click Install next to [MC] Downloads Manager: NSFW Gate. The installer adds an is_nsfw column to the download table, an nsfw_mode column to the category table, and two columns to the user options table for the confirmation timestamp and the listings preference.
  3. The install seeds the default options group at AdminCP > Setup > Options > [MC] Downloads Manager: NSFW Gate and registers the gate on Downloads Manager's gate registry automatically.

First-run checklist​

  1. Visit AdminCP > Setup > Options > [MC] Downloads Manager: NSFW Gate. Decide which user groups can view NSFW content, how guests are handled, which confirmation prompt to show, and whether NSFW items should be excluded from feeds and widgets. See configuration.
  2. Edit any category that should default every download to NSFW and set NSFW gating to "Treat every download in this category as NSFW". Categories left on "Mark NSFW per download" only gate downloads whose individual NSFW flag is on. See configuration.
  3. Edit existing downloads that need to be gated and turn on Mark this download as NSFW.
  4. Confirm the gate fires by visiting an NSFW download as a logged-out visitor.

Verifying the install​

  • The add-on is listed as Active at AdminCP > Add-ons.
  • The options group [MC] Downloads Manager: NSFW Gate appears under AdminCP > Setup > Options.
  • The category edit form shows an NSFW gating field.
  • The download edit form shows a Mark this download as NSFW field.

Upgrading​

Standard XF upgrade flow: extract the new release over the existing files, then go to AdminCP > Add-ons and click Upgrade. The upgrade from 1.0.1 to 1.0.2 migrates the legacy force_nsfw category column to the new nsfw_mode column automatically, mapping force_nsfw=1 to nsfw_mode=force. The 1.0.3 upgrade adds the per-account "hide NSFW downloads" preference.

Uninstalling​

Uninstall from AdminCP > Add-ons. The uninstaller drops the four columns it added (is_nsfw, nsfw_mode, mc_nsfwgate_confirmed_date, mc_nsfwgate_hide_listings) and removes the gate from Downloads Manager's registry. Existing downloads remain; they simply stop being gated.