User:Krinkle/Tools/Real-Time Recent Changes
Description
Install
- Paste this code in your common.js:
// [[File:Krinkle_RTRC.js]]
(mw.loader.getState('ext.gadget.rtrc') ? mw.loader.load('ext.gadget.rtrc') : mw.loader.load('https://www.mediawiki.org/w/load.php?modules=ext.gadget.rtrc&lang=' + mw.config.get('wgUserLanguage', 'en')));
- Visit Special:BlankPage/RTRC on your wiki.
Done :-)
If you encounter any problems, let me know.
How to clear cache
|
|---|
|
Note: After publishing, you may have to bypass your browser's cache to see the changes.
|
Features
Auto-refresh
Silently in the background, using JavaScript, it loads a new list. When that's good and ready, it's pushed in place of the one on screen (So, no interruption).
Patrolling
This is perhaps the most important feature of the tool. If you are logged in with an account that has the patrolright on that wiki, patrolled edits can be hidden from the list by checking the "Unpatrolled only"-checkbox. The recent changes list is also refreshed on-the-fly, so patrolled edits hide right away (either because you patrolled them, or because someone else did). This enables easy live-patrolling without wasting time clicking links that somebody else has already patrolled in the mean time!
Additionally it is also ideal to work on an anonymous checklist (such as on Commons) on your own (or with others at the same time) as patrolled edits automatically hide from the list, leaving only behind what needs to be done from that timeframe, until the message "Nothing matched your criteria" appears at which you know you're done with this list. See also Timeframe below for more info on how to deal with these checklists enabling you to cut out a piece from the history and view only that part.
Skip
(New in version 0.5.3). This feature lets you skip an edit in the list of changes. By clicking the "Skip"-tab in the Diff-view the edit ID will be remembered throughout the current session and both the AutoDiff system and the "Next »"-tab will automatically jump over edits that have been skipped.
- Unskip
- When a diff has been skipped it will remain in the feed marked blue. If you want to get a skipped diff back in the normal system, simply click its (diff)-link again and click the "Unskip"-tab.
Userfilter
This feature lets you query results based on a user name. By putting in an IP-address or username in this field, there will be only contributions shown from that user.
This can be used as with MassPatrol to easily patrol a series of edits by one particular user.
Timeframe
Timeframing allows list generation from a certain point in time. When using Timeframing, the "Until"-field is required, and optionally the "From"-field can be set aswell. This allows a list to be generated of, for example, a day-part in the Anonymous checklists. When there is nothing left in that timeframe, it'll say "Nothing matched your criteria".
- Format
- The timestamps need to be in a very strict 14-digit format: YYYYMMDDHHMMSS (Year, month, day, hour, minute, second).
- Example
- For instance, for 15 November 2024 07:14:07 use
20241115071407.
Click the following link to view edits of yesterday between 6 PM and 7 PM: Click here.
Order
- Asc
- Stands for Ascending, means oldest first. So the items get newer down the list.
- Desc
- (default) stands for Descending, means newest first. Here the items get older down the list.
Reload Interval
The value in this inputfield is used as the number of seconds the script will wait, after a completed refresh, to refresh again.
Default: 3 seconds
An average broadband cable connection should have no problem with "0". The interval timer starts after a completed refresh, so even on "0" it will never refresh while there is a refresh being loaded.
Automatic edit summary
Edits that have automatic edit summaries are recognized and will be highlighted for easy reference. See an example below:
Foobar . . ←Blanked the page
AutoDiff
- On
- When you enable AutoDiff the script will automaticly load the next (diff)-link from the list for you when you have succesfully marked a contribution as patrolled.
- From top
- This checkbox (which also affects the "Next »"-tab in the Diff-view) makes the script pick from the top of the list rather than the bottom of it.
- Warning
- Please use the AutoDiff-feature knowing that when you click a [mark as patrolled]-link there will be no time left to act upon the contribution (like reverting it). So, if you need to rollback or anything, with AutoDiff Enabled: Do that first, and mark as patrolled when ready to go to the next Diff!
- => If you don't like this, don't use AutoDiff. If you do like to automatically have it grab the next (diff)-link without having to scroll down to the list, there is a "Next »"-tab on the top right of every Diff-frame, this will also load the next (diff)-link when clicked, just like AutoDiff does.
MassPatrol
By heavy request as of version 0.8+ this feature blindly patrols all edits in the list until it is exhausted. AutoDiff has to be enabled and to avoid mistakes it can only be used if there is atleast 1 content filter utilized (ie. Userfilter).
CVN Scores
When enabled, RTRC will consult the blacklist of the Countervandalism Network about all usernames in the changes list.
If a record is found, the username will be highlighted, as demonstrated below:
JohnDoe2000
When CVN records are changed, patrollers may leave a comment to explain why the user is blacklisted and until when. Hover the highlighted row to see this information in a tooltip.
ORES Scores
When enabled, RTRC will query ORES to compute scores for all changes in the feed. Any score with high probability will be highlighted.
The damage probability can be read from the tooltip by hovering the highlighted row.
Feedback
If you experience any issues or have suggestions for how something could be better, let me know by creating an issue.
Userbox
Spread the word by adding this box to your userpage
| Userboxes | ||
|---|---|---|
|
Install as Gadget
(These instructions are for administrators.)
- Copy the the Install snippet to your wiki's MediaWiki:Gadget-RTRC.js (just like when you would install it in your user script)
- Create MediaWiki:Gadget-RTRC with something like the following:
''Real-Time Recent Changes'': Monitor and patrol recent changes in real-time ([[m:User:Krinkle/RTRC-docs|documentation]]).
- Then add a line in MediaWiki:Gadgets-definition somewhere with:
* RTRC[ResourceLoader]|RTRC.js
See also
- Krinkle's other Tools and Scripts.
- LiveRC (fr.wikipedia.org), which inspired RTRC.