This is a User Script documentation page! This page describes a user script written by Wikipedia user. |
Description | Easy copy/paste diffs from history and contributions pages |
---|---|
Author(s) | Alexander Davronov |
Status | Rare bug fixes (since January 2022) |
First released | May 12, 2021 |
Version | 2.6.7 |
Updated | August 7, 2023 |
Browsers | Chrome 92.0+ (Blink-based), Firefox 90.0+ |
Skins | Vector Legacy |
Source | HistoryHelper.js (on github) |
History Helper is a plugin for Wikipedia that allows you to extract WP:DIFF links from «View history» and «User contributions» pages into a Wikitext markup to be further used on talk pages. It's is primarily intended for discussions and advanced users. See demos & examples below.
This plugin creates a toolbar at the top of the «View history» pages with buttons and adds a checkbox to every revision entry down below. When entries are selected by using checkboxes click the button to copy wiki markup linking these revisions into the clipboard.
Depending on the button chosen, all selected entries are going to be wrapped into a list of {{diff2}} template tags, table, or special:diff/ links which then can be used on the talk pages. By default, plugin adds names of the users who made copied edits. Move cursor over any button to see a pre-rendered preview of the selected entries.
By default it also {{Highlight}}s some uncivil words in the summaries. Additional words can be added by using regular expressions.
Usage
edit- Go to any «View history» or «User contributions» page
- Select entry by clicking on the checkbox[es]
- Hit the button on the toolbar to copy selected entry's diff as a text
- Paste into your reply on the talk page (see Examples below)
Controls
editPlugin binds a few key strokes. See demons below.
- Click+drag — on checkbox to select multiple entries simultaneously.
- ⇧ Shift+Click — on checkbox to select multiple entries simultaneously.
- Ctrl+Alt+C —
to copy entries into the clipboard as Diff2s list.- Deprecated in 2.6.0
Demo
edit-
Hold left mouse button (LMB) & and drag to select multiple entries
-
Hold ⇧ Shift & press LMB to select multiple entries
Examples
editHere are listed examples of the copied diff links entries and their corresponding rendered results. The diff links were taken from different history pages.
Diffs button
editCopies selected entries as {{diff}} template content:
Table button
editCopies selected entries as table content:
# | DIFF | CURRENT | USER | SUMMARY |
---|---|---|---|---|
0 | 18:50, July 23, 2021 | 18:50, July 23, 2021 | Theroadislong | Reporting The official Gabriel Tembo. |
1 | 18:48, July 23, 2021 | 18:48, July 23, 2021 | Slatersteven | User-reported |
2 | 18:47, July 23, 2021 | 18:47, July 23, 2021 | Slatersteven | User-reported |
Links button
editCopies selected entries as WP:SPECIAL diff link. These are useful for summary edits links (this feature was requested by Qwerfjkl on [15:11, July 18, 2021).
Install
editInsert the following into your common.js:
importScript('User:Alexander Davronov/HistoryHelper.js');
You may also use handy Script Installer to install this one.
Configure
editAs of v2.6.0
the configuration of shortcuts and a default placeholder-wrapper was deprecated. Old configs are going to work in legacy mode. Don't expect them to work in the future.
Highlight words in comments
editBy default HH higlights some uncivil referrings (see full list here at LINE839). You can add your own words or phrases by using the following config below. You have to use Regular Expressions for matching. By default every word is highlighted by using {{highlight}}.
window.HistoryHelper= window.HistoryHelper || {};
window.HistoryHelper.highlights=[
// match liar 2 times, or pants, or "on fire"
/(liar){1,2}|pants|on fire/ig
];
Bugs
editKnown fixed bugs
editMain page's history isn't supported yet.
Special:Log page erroneously lists checkboxes for selections (e.g. link (don't forget to click button))— reported by Qwerfjkl on [21:41, August 7, 2021].- Various issues on international wikis and some history pages. — reported by Jon (WMF) on [Aug 4, 2023, 18:13]
Reporting
editIf copied diffs don't match revisions of the History/Contribution page let me know on my talk page. Don't forget to provide a link to the page.
Summary text
editSome summary text may contain broken wiki markup which may be disruptive (the workaround is to fix mistakes). E.g. (wrong braces):
{{diff2|883393295|878096673|...}} -''«[[WP:BOLD|BOLD]ly] rm "recently" per talk page»''
I18n
editCurrently this plugin doesn’t international wikipedias (i.e. outside of en.wiki.x.io
domain). Date locales may be parsed wrongly or with errors.
Security statement
editThe plugin is open source and provided free of charge. It doesn't gather, store, or send any sensetive information. It never accesses your cookies, neither it tries to obtain any sensetive data via fake dialogs etc. Checkout the source code to make sure there is no suspicious code before using this plugin.
Disclaimer
editThis plugin is provided as is. No warranties or gurantees that it works properly all the time or doesn't disrupt your wikipedia experience whatsoever.
Gallery
edit-
v2.4.3
-
v2.5.5
-
Script main classes and life cycle (activity) diagram (as of v2.6.5).
Changelog
editOnly important changes are mentioned.
See also
edit- Wikipedia:User scripts/List
- Wikipedia:Gadget – gadgets are user scripts or CSS snippets that can be enabled simply by checking an option in your preferences. The gadget's function is provided by the MediaWiki extension Extension:Gadgets.