User:Alexander Davronov/HistoryHelper
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
[edit]Plugin 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
[edit]Here 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
[edit]Copies selected entries as {{diff}} template content:
Table button
[edit]Copies 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
[edit]Copies 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
[edit]Insert the following into your common.js:
importScript('User:Alexander Davronov/HistoryHelper.js');
You may also use handy Script Installer to install this one.
Configure
[edit]As 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
[edit]By 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
[edit]Known fixed bugs
[edit]Main 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
[edit]If 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
[edit]Some 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
[edit]Currently this plugin doesn’t international wikipedias (i.e. outside of en.wikipedia.org
domain). Date locales may be parsed wrongly or with errors.
Security statement
[edit]The 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
[edit]This 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
[edit]Only important changes are mentioned.
v2.6.5
- The tag {{re}} with automatically inserted user names of the edits was added.
v2.6.0
- Keyboard shortcuts removed
v2.6.6
- Replace {{diff2}} by {{diff}}
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.