Jump to content

Extension:ContinuumNsfwFilter

From mediawiki.org
MediaWiki extensions manual
ContinuumNsfwFilter
Release status: beta
Implementation Hook
Description Replaces NSFW prose and images with filtered placeholders based on age, user preferences, and permissions.
Author(s) Continuum Universes Studio, ChatGPT 5.2, OnikaGPT 4o (cdjensen94talk)
Maintainer(s) cdjensen94
Latest version main branch (no releases published yet)
Latest preview version 2.6.0
MediaWiki >= 1.45
PHP 8.4+
ContinuumNsfwFilter
Licence GNU General Public License (any version)
Download
https://github.com/Continuum-Universes-Studio/mediawiki-extensions-ContinuumNsfwFilter/blob/main/README.md
Example https://continuum-universes-wiki.com/

ContinuumNsfwFilter is a custom MediaWiki extension for the Continuum Universes wiki that filters NSFW prose and images based on page/file categories, user age, user preferences, and permissions.

The extension replaces article text marked as NSFW prose and replaces NSFW images with placeholders unless the viewer is signed in, has provided an age value in preferences, has the required permission, and has chosen to display the relevant content type.

What it does

[edit]

ContinuumNsfwFilter filters two main kinds of content:

  • NSFW prose — articles in [[Category:NSFW Prose]] have their article text replaced for users who are not permitted to view NSFW prose.
  • NSFW images — files in [[Category:NSFW Sexual]] or [[Category:NSFW Gore]] are replaced with placeholders depending on the user's preferences and permissions.

Readers must be signed in, have an age value set in their user preferences, and have the nsfw-unblur right to uncensor filtered content.

Features

[edit]
  • Replaces article text for pages categorized under:

[[Category:NSFW Prose]]

  • Replaces images categorized under:

[[Category:NSFW Sexual]]

  • Replaces images categorized under

[[Category:NSFW Gore]]

  • Uses user preferences under Preferences → Appearance to control which NSFW content types may be displayed.
  • Requires users to be signed in before NSFW content can be unfiltered.
  • Requires age input under the user profile section of user preferences.
  • Uses the nsfw-unblur user right to determine whether a user may uncensor NSFW content.
  • Grants nsfw-unblur automatically to the sysop, bureaucrat, and adultreader groups.
  • Designed for MediaWiki 1.45 and PHP 8.4.

Marking content as NSFW

[edit]

Marking prose as NSFW

[edit]

To mark an article as NSFW prose, add the following category to the page:

[[Category:NSFW Prose]]

Pages in this category have their article text replaced for users who are not allowed to view NSFW prose.

Marking sexual images as NSFW

[edit]

To mark a file as NSFW sexual content, add the following category to the file page:

[[Category:NSFW Sexual]]

Marking gore images as NSFW

[edit]

To mark a file as NSFW gore content, add the following category to the file page:

[[Category:NSFW Gore]]

Files in these categories are replaced with placeholders unless the user is allowed to view that content type.

User preferences

[edit]

Users can control NSFW display behavior from:

  • Preferences → Appearance

The extension uses user preferences to determine whether permitted users want filtered content displayed or replaced.

Users must also provide their age information under the user profile section of preferences before NSFW content can be unfiltered.

Permissions

[edit]

ContinuumNsfwFilter uses the following user right:

Right Description
nsfw-unblur Allows users to uncensor NSFW content according to their preferences and age settings.

The nsfw-unblur right is automatically assigned to the following groups:

  • sysop
  • bureaucrat
  • adultreader

Readers must be signed in and have the adultreader group permission to view adult-filtered content.

Compatibility

[edit]
  • Designed for the Continuum Universes wiki.
  • Tested with MediaWiki 1.45.
  • Tested with PHP 8.4.
  • Intended for wikis that need age-aware filtering of prose and file content.

Installation

[edit]
  1. Download the extension:
  2. Place the extension in your MediaWiki extensions/ directory:
    • extensions/ContinuumNsfwFilter
  3. Enable it in LocalSettings.php:
    • wfLoadExtension( 'ContinuumNsfwFilter' );
  4. Visit Special:Version to confirm that the extension loaded.

Configuration

[edit]

ContinuumNsfwFilter is intended to work out of the box after installation.

The extension expects the relevant NSFW categories, user preferences, and permission groups to exist or be configured according to the wiki's needs.

Internationalization

[edit]

ContinuumNsfwFilter includes interface messages for MediaWiki's internationalization system.

Translations can be expanded or improved through the extension repository.

Support

[edit]

License

[edit]

This extension is released under the GPL. See the repository for details.

See also

[edit]