User:Krinkle/Tools/Real-Time Recent Changes

Screenshot of the Real-Time Recent Changes-tool (version 0.8.1) showing the difference-view and a CVN IRC Blacklist-item.

Languages: English • Nederlands

Description

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.

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.

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.

中文（简体）‎: 这个工具能让您观察一个维基的最新更改。这个工具有很多不同的设施。

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.

Install

• Paste this code in your common.js:

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

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

• Visit User:Krinkle/RTRC on your wiki.
•  Done :-)

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 26 April 2013 17:59:21 use 20130426175921.
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:

Example

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

Usertools

[+filter] · WHOIS · CrossWiki When hovering a username in the recent changes list a toolbox like the one on the right will appear with links to a few popular tools such as adding the username to the Userfilter, checking WHOIS (for IP-addresses) and a link to Luxo's cross-wiki contributions tool.

License

Real-Time Recent Changes by Krinkle is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.

Feedback / Report a Bug

If you experience any issues, have suggestions for how something could be better, have an idea for a feature request – or want to report a bug ? Please leave a message on my Tools-talkpage.

Bug Report

If you're about to report a bug, please read the following closely:

• Close your browser, and restart it. Try again, does it happen again ? If so, report the bug and be sure to describe where, how and what goes wrong (ie.on load the "X-thing" looks fine, but when I do "X-action" and everytime "X-event" happends the "X-bug" appears)
• If you are able to, try other browsers, operating systems, connections. Include your testresults in the report.
• If you saw any error messages, besure to include them completely including any 'ErrorCode'-numbers or Warnings that you see (whether or not close to the main error) on that page.
• Use the preloaded form to leave a message on the Tools-talkpage by clicking here.
• Thanks in advance !

Error codes / Known issues

A few things about commons errors and issues.

• ...nothing so far.

Ideas and requested features

These are ideas for the future requested by users via IRC, Feedback or by myself.

• Improvement: AJAXify rollback links
• New feature: Internationalization; Translatable interface. => Done in 0.7.9. see User:Krinkle/RTRC.js/nl as example for Dutch.
• Improvement: Show a permalink to the current configuration. => Done in 0.8.0, the link can be found on top of the feed next to "Last update:"
• Improvement: Edits from "new users" aswell (+option to hide these) => Not possible due to limitations in the MediaWiki software
• New feature: See who else is online and what their permalink is (+option to hide yourself/your settings).
• New feature: Use the CVN Database to highlight watched pages
• New feature: Use the CVN Database to highlight blacklisted users => Done in 0.6.0
• Improvement: Compare sizes and highlight big edits. => Done in 0.6.0
• New feature: Rollback support => Done in 0.5.1
• Improvement: Also chronological order, as supposed to the default new-to-old order. => Done in 0.3.3

Changelog

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	Added: Automatic edit summary (AES) detection and highlighting for commonswiki & nlwiki (more can be added, request at Feedback-page) (See: #Automatic edit summary)
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	Added: Dynamic refresh system (See: #Auto-refresh)
2010-04-12 - 0.0.4	Added: Basic layout and styling
2010‑04‑12 ‑ 0.0.1	Initial version

Sourcecode

The sourcecode is available at: User:Krinkle/RTRC.js

An unminified version is available at: User:Krinkle/RTRC-dev.js

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. {{User:Krinkle/User RTRC}}

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 the recent changes in real-time.
Provides a lot of features (such as Timeframing, Filtering, Auto-Diff and much more).
See also [[m:User:Krinkle/RTRC-docs|Documentation]]. 

• Then add a line in MediaWiki:Gadgets-definition somewhere with:
  

  * RTRC[ResourceLoader]|RTRC.js 
  

See also

Check also my other Tools and Scripts here.