Soyjak Wiki:Twinkle
 | |
 A screenshot of Twinkle's articles for deletion feature in Wikisneedia. | |
| Description | Tag pages, start discussions, leave messages, and provide a richer user interface for admin actions such as block and protect |
|---|---|
| Author | AzaToth |
| Maintainers | Novem Linguae, SD0001 |
| Source | |
| GitHub repository | twinkle |
Twinkle, also called Hunky Twinkle Wiki Machine, is a gadget you can only be allowed to turn on if you have rollback perms.[a] It allows autoconfirmed users to have extra options to assist them in common tasks while you edit in this very wiki, and help you deal with vandalism. It provides people with rollback tools and speedy deletion functions, user warnings, user welcomes, maintenence tags, reporting of vandals, and more tools. It also gives more tools to help with Admin tasks in general.
It was created by Azatoth in 2007, its Maintainers are Novem Linguae and SD0001, and its github repository is here.
Info
[edit | edit source]- Getting started
- To enable Twinkle on your account and receive any future updates automatically, you can simply enable the "Twinkle" gadget in the Gadgets section of your Preferences page. You'll need to be autoconfirmed and have rollback perms for Twinkle to appear in your Preferences.
- Customizing Twinkle
- To modify many aspects of your Twinkle's operation, you can visit the Twinkle preferences panel. Make your changes and click "Save changes" at the bottom of the page. If you are not seeing your intended changes, make sure to completely clear your browser cache so your changes take effect.
- Getting help
- There is comprehensive information about Twinkle at the documentation page. If that page does not answer your question, consider asking at the talk page. IRC users can connect to the #wikipedia-userscripts or #wikipedia-en IRC channels. Why? Because Wikipedia is in charge of EVERYTHING and you will be supported and you VVILL be happy.
- Reporting bugs or requesting features
- You can report bugs or request features on the talk page, or directly at our GitHub. Twinkle development is focused on maintenance; not many patches are being written. Please expect long wait times unless it is an emergency.
- Contributing code
- Twinkle is open source and we welcome code contributions. Twinkle is written in JavaScript, with a linter that enforces ES7/ES2016 (an old version of JavaScript that we have to use because it is a MediaWiki gadget). If you would like to write code and submit patches to Twinkle, feel free to submit a pull request to our GitHub. Tools you should install on your local machine include Git and npm. You can see a list of easy patch requests here. You can get more details about how to compile and run Twinkle so you can test your changes here. You should test your patch before you open a pull request; we recommend test.wikipedia.org.
- Maintainers
- As of 2026, Novem Linguae and SD0001 are the ones that approve most pull requests and do most deploys.
- Notes
- If your account is very new, you will not be able to use Twinkle. You need to be autoconfirmed (at least four days old and have ten edits) and have rollback perms to enable the Twinkle gadget.
- As with all JS functionality on the site, it is no longer possible to use Twinkle on Wikipedia: Internet Explorer.[b] If you are still using IE (somehow), try switching to another browser such as Wikipedia:Mozilla Firefox or Google Chrome, as Twinkle is functional on most other modern browsers (including modern smartphone browsers).
- Some browser add-ons may interfere with Twinkle. If Twinkle still does not load after following the instructions above, consider disabling one or more of your add-ons and then restarting your browser.
- If you're using a touchscreen device, you may need to tap and hold the "TW" button in the Vector skin to show the Twinkle menu.
For a visual demonstration of many of the aforementioned items, it may be useful to view the "Twinkle" video tutorial on WMF Labs.
Dokvmentation
[edit | edit source]
Main article: Soyjak Wiki:Twinkle/doc
Before using Twinkle, you should read its documentation to familiarize yourself with its functions. Experienced Twinkle jannies are welcome to expand or improve the documentation based on their use of the tool.
Abuse of Twinkle
[edit | edit source](You) VVILL NEVER forget that one takes full responsibility for any action performed using Twinkle. One must understand the rules of the Soyjak Wiki and use this tool within these policies or risk having one's account 'nished . Please take particular care with the rollback links provided by it. Only obvious vandalism qualifies for a Twinkle based rollback without an edit summary. If you believe an editor's contribution is done in good faith, you should include an edit summary.
If a change is merely "unsatisfactory" in some way, undoing/reverting should not be the first response. Editors should either make a reasonable attempt to improve the change, or should simply leave it in place for future editors to improve. Undo/revert is appropriate in cases where the contribution is arguably wrong (consider moving it to a Talk page of said page), or is unreasonably difficult to fix (e.g. incomprehensible, and the author is unresponsive), or is actually harmful to the article (such as vandalism, if that matters). A plain language edit summary (not merely tags) should be used when reverting changes that appear to have been made in good faith because many contributors will not recognize minimalistic tags and will not learn what the problem was and are likely to repeat it.
Officer Twinkleplier, are you loading unreliably?
[edit | edit source]In the past, you could install Twinkle by adding the text importScript('User:AzaToth/twinkle.js'); to your personal script page; however, this practice can make Twinkle load unreliably. (Twinkle might not load on every page you visit, or it might show up but not work properly. TLDR: A dnb.)
To fix this problem, you should remove the line: importScript('User:AzaToth/twinkle.js'); from your personal script file, and then turn on the Twinkle gadget using the instructions above.
If you have any old configuration set up using TwinkleConfig or FriendlyConfig, it will still be effective. However, if you use the preferences panel to modify your configuration, you are advised to remove all old Twinkle/Friendly configuration variables from your skin JavaScript file.
History
[edit | edit source]Twinkle has its origins as a reversion script based on ideas found in a literal who (Aaron Schulz)'s script collection. It was developed by another literal who named AzaToth and released in 2007. It has grown into a tool with many more capabilities than its reversion roots. It is currently one of the most installed non-default gadgets on English Wikipedia, with around 49,000 users. Not as much as in this very wiki doe. The toolset has expanded over the years: the collection of tools formerly known as Friendly, developed by yet another literal who, (Ioeth) became part of Twinkle in 2011, and a new module to make user blocking a smoother process for administrators was developed in 2015. Other major contributors include Amalthea, Amorymeltzer, MusikAnimal, SD0001, This, that and the other, and Novem Linguae. The gadget continues to be updated and improved, in order to accommodate user requests and changes to Soyjak Wiki and other processes.
Since 5 September 2020, edits and log actions done through Twinkle bear the "twinkle" tag. In December 2025, Twinkle changed its logo. If that matters
Install on your dnb wiki NOWWWWNOWWNOW
[edit | edit source]You want to use Twinkle in your new wiki, there is a way:
- Install twinkle-starter on your wiki. Written in 2021 using a WMF grant, this was specifically designed to be easy to copy, localize, and customize on other projects, and it was designed to be easy to update the core files after installing. The README has the instructions on setting up. You can ask for help at Wikipedia:WT:TW, or by contacting the maintainer SD0001 directly via email.
- Add TwinkleGlobal to your common.js. It allows reverting edits, reporting IPs and accounts to SRG, and requesting speedy deletion of pages.
- Copy and paste all the Twinkle files from English Wikipedia to your project using the procedure at Wikipedia:Twinkle/Localisation. This method is now discouraged (you should install twinkle-starter instead, see first bullet) as it results in Twinkle becoming outdated with no easy way of getting it up-to-date – eventually resulting in broken installations on many wikis. Syncing the updates from enwiki is usually non-trivial.
Userboxes
[edit | edit source]The Twinkle userboxes can be found here. Note that there are parameters that change the template slightly, see the source code for it.
