Wikipedia:Twinkle
![]() |
Shortcuts: |
---|
WP:TWINKLE |
WP:TWINK |
WP:TW |
![]() | Warning: You take full responsibility for any action you perform using Twinkle. You must read and understand Wikipedia policies and use this tool within these policies, or risk being blocked from editing. |
Twinkle is a set of JavaScript functions that gives confirmed and autoconfirmed registered users several new options to assist them in common Wikipedia maintenance tasks and to help them deal with acts of vandalism. It provides users three types of rollback functions and includes a full library of speedy deletion functions, user warnings, pseudo-automatic reporting of vandals, and much, much more.
Twinkle was and is developed by AzaToth and has its origins as a reversion script based on ideas found in Voice of All's script collection. It has grown quickly into a tool with many more capabilities than its reversion roots and is used by hundreds of Wikipedians.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/6/67/TwinkleARV_-_AIV.png/620px-TwinkleARV_-_AIV.png)
Requirements and limitations
Browser support
Twinkle is regularly tested and expected to work with: Mozilla Firefox, Camino, Safari, and Safari iPhone OS. It is recommended to use the latest versions of these browsers. It also appears to play well with the latest version of Google Chrome. For Opera you will need to enable Javascript Standard Library under the "Gadgets" tab of your Preferences. If you are running older versions of these browsers, such as Safari 2, Firefox 1.5 etc, you might be able to (partially) use Twinkle by enabling this Javascript Standard Library, but these versions (and other browsers, including Internet Explorer) are not actively supported.
Problems, bugs and feedback
- It is a known issue that firewall and security solutions such as ZoneAlarm and Norton Internet Security (specifically Norton's AntiSpam) can intercept and malform the http and xml webstreams that Twinkle uses. Because of that Twinkle might not work in combination with those products. In the case of Norton Internet security you can fix this by disabling popup blocking.
- Twinkle is considered to be stable, but in continuous development. All questions regarding Twinkle as well as bug reports and feature requests should be posted on the Talkpage.
Installation
To install all Twinkle modules, including all future updates and additions, simply activate Twinkle in the Gadgets section of your Preferences page.
Alternatively, you can install TWINKLE manually:
- Copy the text below and paste it into the bottom of your skin script file:
importScript('User:AzaToth/twinkle.js');
- Save the page, and
- Bypass your browser cache (Firefox: Control-Shift-R / Firefox Mac: Command-Shift-R)
- Done!
You may wish to re-configure TWINKLE's default settings. See the Configuration section in the documentation for instructions.
Documentation and configuration
Before you start using Twinkle you really should read its documentation to familiarize yourself with some of the possibilities and functions of Twinkle. There is also a multitude of options that you can configure to change some of the default behaviours of Twinkle. Never forget that you take full responsibility for any action performed using Twinkle. You must understand Wikipedia policies and use this tool within these policies, or risk being blocked.
Blacklisting
Problematic users abusing Twinkle may have their access to it revoked by an administrator. The Twinkle blacklist is an array of usernames located at User:AzaToth/morebits.js, at the very bottom. Users on the blacklist will not be able to use Twinkle. Note that disruption only accounts using Twinkle are typically blocked from editing altogether.
Administrators: When manipulating the list, be sure to use correct Javascript syntax for arrays as not doing so can cause errors for all Twinkle users.
Userboxes
Users of this tool can also add one of these userboxes to their page.
Code | Result | |||
---|---|---|---|---|
{{User:UBX/Twinkle}} |
|
Usage | ||
{{User:UBX/Twinkle2}} | Usage | |||
{{User:UBX/Twinkle3}} | Usage | |||
{{User:UBX/Twinkle4}} |
|
Usage | ||
{{User:UBX/Twinkleadmin}} |
|
Usage | ||
{{Template:User Newpages with Twinkle}} | Usage | |||
{{Template:User TwinkleOn}} | Template:User TwinkleOn | Usage |
Also, there is the Twinkle topicon. {{Twinkle topicon}}
Twinkle on IRC
Real time help can be found at #wikipedia-userscripts.
See also
- Friendly – Assists in adding welcome messages to users and placing maintenance tags in articles.
- FurMe – Assists in writing Fair Use rationales for non-free images.