Extension:RevisionSlider
![]() Release status: stable |
|
---|---|
![]() |
|
Implementation | User interface |
Description | Adds a slider interface to the diff view allowing to easily move between revisions |
Author(s) | Wikimedia Germany (WMDE) |
Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
MediaWiki | 1.25+ |
Database changes | No |
License | GNU General Public License 2.0 or later |
Download | |
Quarterly downloads | 100 (Ranked 51st) |
Public wikis using | 957 (Ranked 262nd) |
Translate the RevisionSlider extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The RevisionSlider extension adds a slider interface to the diff view, so that you can easily move between revisions.
Installation
[edit]- Download and move the extracted
RevisionSlider
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'RevisionSlider' );
Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Usage
[edit]Opt-out
[edit]If you are not using the RevisionSlider at all and also don't want to see the collapsed RevisionSlider bar at the top of the diff page, you can opt-out by checking "Don't show the revision slider" in your preferences under "Appearance" → "Diffs".
Technical Background
[edit]JavaScript Hooks
[edit]The RevisionSlider uses AJAX to reload the diff page when new revisions are selected. Once the page has been reloaded both the wikipage.content
and wikipage.diff
hooks are fired. If user JavaScript or extension JavaScript acts on the diff page you may need to listen to these hooks.
Examples
- The Thanks extension: phab:rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
- The English Wikipedia wikEdDiff gadget: https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js
API calls & fetching data
[edit]Unless expanded, the tool is not doing any API calls. Only when the user expands the slider, it fetches data about revisions (revision-id, timestamp, user, comment, size and flags). The tool only fetches data for revisions that are currently visible on the screen (maximum 500 revisions) and data about additional revisions is only loaded when the user navigates back or forth on the timeline using the arrows.
Background
[edit]The RevisionSlider[1] is a feature to fulfill one of the top wishes of the German Community wishlist[2] and is developed by WMDE's TCB team. It is inspired by DerHexer's revisionjumper gadget and based on a prototype by the WMF Community Tech team.
Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.
References
[edit]![]() | This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
![]() | This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |
- Stable extensions
- User interface extensions
- GPL licensed extensions
- Extensions in Wikimedia version control
- DifferenceEngineViewHeader extensions
- GetPreferences extensions
- All extensions
- Extensions used on Wikimedia
- Extensions included in BlueSpice
- Extensions included in Canasta
- Extensions included in Miraheze
- Extensions included in MyWikis
- Extensions included in ProWiki
- Extensions included in WikiForge