Uitbreiding:Paginageschiedenisbalk

MediaWiki uitbreidingshandleiding

RevisionSlider Release status: stabiel
Implementatie	Gebruikersinterface
Beschrijving	Voegt een schuifbalk toe aan het overzicht van de bewerkingsgeschiedenis waardoor navigeren tussen verschillende versies van een pagina eenvoudiger wordt
Auteur(s)	Wikimedia Duitsland (WMDE)
Compatibiliteit beleid	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.25+
Database wijzigingen	Nee
Licentie	GNU General Public Licentie 2.0 of hoger
Download	Extensie downloaden Git [?]: Download Git master blader door de repository (GitHub) commitgeschiedenis repository beheerders (GitHub) code review
Gebruikte hooks DifferenceEngineViewHeader GetPreferences
Vertaal de RevisionSlider extensie indien beschikbaar op translatewiki.net
Bekijk gebruik en versiematrix
Problemen	Open taken · Rapporteer een bug

De Paginageschiedenisbalk uitbreiding voegt een schuifbalk toe aan het overzicht van de bewerkingsgeschiedenis, waardoor navigeren tussen verschillende versies van een pagina eenvoudiger wordt

Installatie

• Download en plaats de bestanden in de map RevisionSlider in de map extensions/.
• Voeg de volgende code onderaan aan LocalSettings.php toe:

  wfLoadExtension( 'RevisionSlider' );
  

•  Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.

Gebruik

	Als je de aanpassingen van een wiki-pagina bekijkt wordt standaard de schuif dichtgeklapt en alleen een smalle balk "Toon verschillen" is bovenin zichtbaar. Klik daarop om de schuif uit te klappen.
	Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.
	Elk balkje vertegenwoordigt een versie van de pagina. Balkjes die naar boven wijzen duiden op een groei in de grootte van de pagina, balkjes die naar beneden wijzen duiden op een vermindering. In de afbeelding vertegenwoordigt versie 1 toegevoegde inhoud, terwijl versie 2 het verwijderen van inhoud weergeeft.
	Gebruik de gele en blauwe knop om versies te selecteren en deze met elkaar te vergelijken. De blauwe knop wijst de nieuwere versie aan, de gele wijst een oudere versie aan. There are several ways to do this: You can drag and drop the knob to the desired position on the slider. You can click on the desired position on the slider line. To select the newer revision, click on the blue line, and for selecting the older revision, click on the yellow line. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow. You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line. If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.
	Gebruik de achterwaartse en voorwaartse pijlen om doorheen de paginageschiedenis te bewegen en oudere en recentere versies weer te geven.

Opt-out

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 RevisionSlider in your preferences under Appearance -> Diffs.

Technical Background

JavaScript Hooks

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.

Voorbeelden

• The Thanks extension https://phabricator.wikimedia.org/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

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.

Achtergrond

The RevisionSlider is a feature to fulfill one of the top wishes of the German Community wishlist 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.