FANDOM


AjaxBlock allows you to block and unblock users without leaving the current page you're on, by showing a block modal when you click on any block/unblock link.

Note: The modal won't open if you're holding either the shift or control key. This is to allow users to access the block and unblock special pages normally.

Installation

Usage

The block modal will show up when you click on any Special:Block link with a target, using it is pretty self-explanatory. Set a block length from either the dropdown or typing on the input the custom time you prefer (times like 4 months and 2 weeks are acceptable too). Then select one of the common block reasons or type your own on the input. You can specify the reason further if you choose a common reason and input your own at the same time, which would appear as: <common reason>: <further ellaboration>. Check the options you'd like to be applied to the block and finally click the "Block this user" button, or "Cancel" to close the modal.

When unblocking a modal will pop up prompting you to input a reason. Clicking "Unblock this user" will unblock the user, or "Cancel" to close the modal.

Customization

All custom variables are under the window.AjaxBlock object.

Custom default expiry times

To set custom expiry times, you just need to add to the window.AjaxBlock.ajaxBlockExpiryTimes object in the syntax: 'time to submit': 'time to display',. For example:

window.AjaxBlock = {
    expiryTimes: {
        '2 hours': '2 hours',
        '1 day': 'one day',
        '1 week': 'a week',
        '2 months 4 weeks 2 days 7 hours': 'overly specific block duration'
    }
};

Default: 2 hours, 5 hours, 12 hours, 1 day, 3 days, 5 days, 1 week, 2 weeks, 1 month, 3 months, 6 months, 1 year, 2 years, 3 years, infinite.

Custom default block reasons

Pretty much the same as with expiry times. Example:

window.AjaxBlock = {
    blockReasons: {
        '[[w:Help:Vandalism|Vandalism]]': 'Vandalism',
        '[[w:Help:Spam|Spam]]': 'Spam',
        'Under the legal age': 'COPPA',
        'Removing information/blanking articles': 'Blanking',
        'Failing to comply with the [[Project:File Policy|File Policy]]': 'File policy'
    }
};

Vandalism: Vandalism
Spam: Spam,
Sockpuppetry/Ban Evasion: Sockpuppetry,
Removing content/blanking pages: Page blanking,
Inserting false information or nonsense: Gibberish,
Intimidating behaviour/harassment/trolling: Troll/Harassment,
Unacceptable username, avatar, or global masthead: Name/avatar,
Under the legal age: COPPA,
Repeated policy violations: Repeated violations.

Auto-check options

Automatically checked checkboxes on the block modal.

window.AjaxBlock = {
    check: {
        talk: true,
        autoBlock: true,
        override: true
    }
};

Default checked: AutoBlock.
Default unchecked: talk (prevent posting on talk page) and override (override current blocks).

Example configuration

window.AjaxBlock = {
    expiryTimes: {
        '2 hours': '2 hours',
        '1 day': 'one day',
        '1 week': 'a week',
        '2 months': '2m',
        'never': 'Never'
    },
    blockReasons: {
        '[[w:Help:Vandalism|Vandalism]]': 'Vandalism',
        '[[w:Help:Spam|Spam]]': 'Spam',
        'Under the legal age': 'COPPA',
        'Removing information/blanking articles': 'Blanking',
        'Failing to comply with the [[Project:File Policy|File Policy]]': 'File policy'
    },
    check: {
        talk: true,
        autoBlock: true,
        override: true
    }
};
Text above can be found here (edit)
Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+