Extension: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 | GitHub:
Note: 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-unbluruser right to determine whether a user may uncensor NSFW content. - Grants
nsfw-unblurautomatically to thesysop,bureaucrat, andadultreadergroups. - 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:
sysopbureaucratadultreader
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]- Download the extension:
- Place the extension in your MediaWiki
extensions/directory:extensions/ContinuumNsfwFilter
- Enable it in
LocalSettings.php:wfLoadExtension( 'ContinuumNsfwFilter' );
- 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]- Bug reports and feature requests: GitHub Issues
License
[edit]This extension is released under the GPL. See the repository for details.
