User:Krinkle/Tools/Real-Time Recent Changes

From Meta, a Wikimedia project coordination wiki
Jump to: navigation, search
Screenshot of RTRC in use.

Languages: EnglishNederlands

Description[edit]

English: This tool enables you to monitor the recent changes of a wiki in real-time. In doing so it provides a lot of features; such as Timeframing, Filtering, Auto-Diff and much more.
Deutsch: Dieses Helferlein ermöglicht das Überwachen der letzten Änderungen eines Wikis in Echtzeit. Dabei werden viele hilfreiche Funktionen wie Zeitraumbegrenzung, Filter, Auto-Unterschied u.v.m. unterstützt.
Español: Esta herramienta permite monitorizar los cambios recientes de una wiki en tiempo real. Así, proporciona muchas funcionalidades, tales como Plazo, Filtro, AutoDif y mucho más.
Bahasa Indonesia: Alat ini memungkinkan Anda untuk mengawasi perubahan terbaru dari sebuah wiki dalam waktu-nyata. Dengan melakukannya, ini menyediakan banyak fitur; seperti Timeframing, Penyaringan, Perbedaan-revisi otomatis (Auto-Diff), dan lebih banyak lagi.
Italiano: Questo strumento consente di monitorare i cambiamenti recenti di un wiki in tempo reale. In tal modo fornisce un sacco di funzioni: Arco di tempo, filtri, Auto-Diff e molto altro ancora.
日本語: このツールは、ウィキの最近の更新をリアルタイムで監視できるようにします。さらに、タイムフレーム、絞り込み、自動差分 (Auto-Diff) など数多くの機能を提供します。
Nederlands: Deze tool stelt je in staat recente wijzigingen van een wiki in real-time te monitoren. Tijdens het gebruik heb je de beschikking over verschillende middelen zoals timeframing, filteren, wijzigingen en meer.
Português: Esta ferramenta permite que monitore em tempo real as mudanças recentes de uma wiki, e oferece vários recursos, tais como filtro por editor ou intervalo de tempo, visualização automática de diferenças (diffs) e muito mais.
中文(简体)‎: 这个工具能让您观察一个维基的最新更改。这个工具有很多不同的设施。
Қазақша: Бұл құрал уикидегі нақты уақыттағы жуықтағы өзгерістерді қадағалауды жеңілдетеді. Ол өте көп мүмкіндітермен қамтамасыз етеді: бір айдағы кез келген уақыттағы өзгерістерді ғана көрсету (Timeframing), сүзгілеу (есім кеістігі бойынша, тіркелгісіздерді ғана көрсету, белгілі бір қатысушы өңдемесін ғана көрсету, тегтелген өзгерістерді ғана көрсету, нұсқалардың автоайырмашылғын көрсету және басқалар) Қазақша құжаттама беті: kk:Уикипедия:Гаджеттер/RTRC
Қазақша (кирил)‎: Бұл құрал уикидегі нақты уақыттағы жуықтағы өзгерістерді қадағалауды жеңілдетеді. Ол өте көп мүмкіндітермен қамтамасыз етеді: бір айдағы кез келген уақыттағы өзгерістерді ғана көрсету (Timeframing), сүзгілеу (есім кеістігі бойынша, тіркелгісіздерді ғана көрсету, белгілі бір қатысушы өңдемесін ғана көрсету, тегтелген өзгерістерді ғана көрсету, нұсқалардың автоайырмашылғын көрсету және басқалар) Қазақша құжаттама беті: kk:Уикипедия:Гаджеттер/RTRC

Install[edit]

Please leave the [[File:Krinkle_RTRC.js]] in for statistics+

If nothing appears, be sure to verify that you've put the above code on the wiki you use the tool on, not per se here on Meta. Note that this tool is optimized for WebKit (Safari, Chrome) browsers. It should also work fine in Mozilla (Firefox). Internet Explorer will not be supported.
Also clear your cache and do a hard refresh. If you encounter any issues, please let me know!

How to clear cache

Note: After saving, you may have to bypass your browser's cache to see the changes. Mozilla / Firefox / Safari: hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac); IE: hold Ctrl while clicking Refresh, or press Ctrl-F5; Konqueror: simply click the Reload button, or press F5; Opera users may need to completely clear their cache in Tools→Preferences.

Features

Auto-refresh

loader icon

Silently in the backgound, 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 automaticly hide from the list, leaving only behind what needs to be done from that timeframe, untill 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

On request, I've added to version 0.5.3+ an option to Skip a diff. By clicking the "Skip"-tab in the Diff-view the diffnumber will be remembered through this session and both the AutoDiff system and the "Next »"-tab will skip diffs that have been Skipped this way.

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 it's (diff)-link again and click the "Unskip"-tab.

Userfilter

On request, I've added to version 0.7.+ an option to query results based on Username aswell. 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 "Untill"-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 06 April 2014 18:59:04 use 20140406185904.
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 untill 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).

IRC Blacklist

When enabled, all usernames in the feed are checked against the blacklist of the Countervandalism Network. If a match is found, the username will be bolden in red, as demonstrated below:

Reason: Cross-wiki linkspam. Adder: WutsjeExample

When you hover over the icon the reason and the adder of the entry will be shown in a tooltip.

Feedback

If you experience any issues or have suggestions for how something could be better, let me know by creating an issue.

Beta

Try out the next version to help find issues before release. Beware that there may be bugs (report them here), but most likely it will be an improvement. You can easily switch between the stable and beta versions by commenting out one and uncommenting-out the other.

// [[File:Krinkle_RTRCdev.js]]
mw.loader.load('//meta.wikimedia.org/w/index.php?title=User:Krinkle/RTRC-dev.js&action=raw&ctype=text/javascript');

You should now have:

// [[File:Krinkle_RTRC.js]]
//mw.loader.load('//meta.wikimedia.org/w/index.php?title=User:Krinkle/RTRC.js&action=raw&ctype=text/javascript');
// [[File:Krinkle_RTRCdev.js]]
mw.loader.load('//meta.wikimedia.org/w/index.php?title=User:Krinkle/RTRC-dev.js&action=raw&ctype=text/javascript');

To temporarily switch back to stable, comment out the 4th line and uncomment the 2nd line:

// [[File:Krinkle_RTRC.js]]
mw.loader.load('//meta.wikimedia.org/w/index.php?title=User:Krinkle/RTRC.js&action=raw&ctype=text/javascript');
// [[File:Krinkle_RTRCdev.js]]
//mw.loader.load('//meta.wikimedia.org/w/index.php?title=User:Krinkle/RTRC-dev.js&action=raw&ctype=text/javascript');
Pre-2013 release notes
2012-02-21 - 0.9.0
  • Removed several redundant utility functions in favor of MediaWiki's central utilities
  • Removed references to hardcoded paths of MediaWiki 1.16, 1.17 and 1.18.
  • Using ResourceLoader to load the diff-styling.
  • Coding style
2011-12-28 - 0.8.8
  • Coding style
2011-12-27 - 0.8.7
  • Fixes due to changes in 1.18wmf1 deployment
2011-10-16 - 0.8.6
  • Support for protocol-relative urls
2011-10-16 - 0.8.5
  • Load diff.css from /skins-1.17/ instead of /skins-1.5/ (which was deleted on bits.wikimedia.org)
2010-09-25 - 0.8.1
  • When jumpstart is on the window automatically scrolls down a bit to where the tool starts (only in newer browsers)
  • Small fixes
2010-09-06 - 0.8.0
  • Added: Type-filter (Edits or New pages)
  • Added: Namespace-filter
  • Added: MassPatrol (see #MassPatrol)
  • Changed: Settings bar has been re-arranged to save space. Pause-button was also moved up here.
  • Added: You can now bookmark your favorite RTRC-configurations. An auto-generated permalink is placed on top of the feed next to the Last-update message. Whenever you apply new settings, this link is updated too.
2010-07-28 - 0.7.10
  • Get rid of diffonly=1 in the links generated within the (diff)-frame (such as "<- Previous revision / Next revision ->")
2010-07-28 - 0.7.9
  • Interface translation system created (as a start Dutch (nl) translation added, please contact me for requests or additions of languages)
  • Small fixes and optimalizations
2010-07-26 - 0.7.8
  • Added: New-page patrol support from within the tool. No more pop-up work around.
  • Added: Tooltips when hovering on usernames with ability to quickly access commmon tools + an addUserToFilter-button to directly add the hovered username in the "User"-filter setting (See: #Usertools).
  • Added: [mark]-button for the Diff-frame (this because on a new page the mark to patrol button is on the bottom, with this button there's no need to scroll
2010-07-26 - 0.7.7
  • Bugfix: Multiple slashes in a URL now properly handled aswell, as supposed to only one (subpages etc., see 0.7.6), fixes the subpage-subpage-404-not-found bug
2010-07-15 - 0.7.6
  • Bugfix: HTML-characters in the editsummary (such as "Created page with '<div class="toccolours">...'") are now escaped instead of thrown raw on the page. Although rare, caused very weird layout issues
2010-06-17 - 0.7.5
  • Bugfix: repair visual break in Monobook-skin due to different with Vector-skin (should be fully compatible with Monobook again now).
2010-06-17 - 0.7.4
  • Update "Last-update: "-line even if an error occured to allow [pausing] and see how long ago the error occured if it stops refreshing.
2010-06-03 - 0.7.3
  • Consistant self-window and new-window links throughout the application
2010-06-03 - 0.7.2
  • Added: Ability to filter by User (See: #Userfilter)
  • Added: Close-button ("X") for the Diff-frame
  • Small fixes and updates (jQuery 1.4.2)
2010-06-02 - 0.7.1
  • Bugfix: Slashes won't be escaped in titles, fixes the subpage-404-not-found bug
2010-05-30 - 0.7.0
  • Javascript fully minified + seperate "-dev" version both stored on Meta.
2010-05-17 - 0.6.9
  • Small fixes (CSS)
2010-05-12 - 0.6.8
  • Added: Monobook-support from the core
2010-05-12 - 0.6.7
  • Small fixes
2010-05-04 - 0.6.6
  • Bugfixes in the blacklist highlighting
2010-05-02 - 0.6.5
  • Bugfix: Pause-button was unclickable in some browers, jumped away when pressed
2010-05-02 - 0.6.4
  • Added: Tooltip with exact details from the database entry on the blacklist-icon (See: #IRC Blacklist)
2010-05-02 - 0.6.3
  • Added: Local timezone support in input (timeframe)
2010-05-02 - 0.6.2
  • Added: Local timezone support in output (feed)
2010-04-27 - 0.6.1
  • Inserted a little "..." progress indication when an edit is being marked as patrolled (during slowness this prevents confusion whether it's been doing something or that the user might have miss-clicked it)
2010-04-27 - 0.6.0
  • Added: IRC Blacklist highlighting from the Countervandalism Network (CVN) (See: #IRC Blacklist)
  • Added: New column to the right with the size of the edit in bytes (eg. (+5), (0) or (-17))
2010-04-27 - 0.5.4
  • Added: Local cache of patrolled diff-ids
    ^ fixes issue with patrolled edits in the 'unpatrolled' feed (server delay)
2010-04-27 - 0.5.3
  • Added: Helpicons + Skip functionality (See: #Skip)
2010-04-27 - 0.5.2
  • Bugfix: JSLint validation + some Firefox issues fixed + published on Meta now
2010-04-27 - 0.5.1
  • Added: Rollback links in Diff-view
2010-04-27 - 0.5.0
  • Rewrite from a selfhosted PHP-tool as an on-wiki JavaScript script, complete !

 

2010-04-22 - 0.3.3d
  • Added: Toggle-button to pause/resume the refresh-functionality.
2010-04-22 - 0.3.3b
  • Made a little code adjustment following a critical bugreport.
  • Order-option can now be used stand-alone whether the Timeframe-option is set or not. (See: #Order)
2010-04-22 - 0.3.3
  • Added: Option to reverse order (Ascending and Descending)
2010-04-21 - 0.3.2
  • Headings in the Recent Changes feed by date
2010-04-18 - 0.3.0
  • Complete code rewrite for more effeciency and speed
2010-04-17 - 0.2.1
  • New graphical user interface

 

2010-04-15 - 0.2.0
  • Added: In-page Diff-viewer + On-the-fly patrollinks
2010-04-15 - 0.1.7
  • Added: Options for RCstart and RCend timeframe (See: #Timeframe)
2010-04-14 - 0.1.5
2010-04-14 - 0.1.3
  • Testing: Frontend API Login
2010-04-13 - 0.1.1
  • Testing: Other wmf-wikis besides commonswiki
2010-04-13 - 0.1.0
2010-04-12 - 0.0.4
  • Added: Basic layout and styling
2010‑04‑12 ‑ 0.0.1   
  • Initial version

Other tools

Userbox

Spread the word by adding this box to your userpage

Userboxes
RTRC This user uses the
Real-Time Recent Changes tool and likes it.

Install as Gadget

(These instructions are for sysops who can edit in the MediaWiki:-namespace)

  • 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[edit]

Check also my other Tools and Scripts here.