Extension:RevisionSlider

Manuale sulle Estensioni MediaWiki

RevisionSlider Stato della release: stabile
Implementazione	Interfaccia utente
Descrizione	Aggiunge un'interfaccia a scorrimento per la visualizzazione delle differenze tra le varie versioni che permette di spostarsi facilmente fra di esse
Autore(i)	Wikimedia Germania (WMDE)
Politica di compatibilità	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.25+
Modifiche al Database	No
Licenza	GNU General Public License 2.0 or later
Scaricare	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Hook usati DifferenceEngineViewHeader GetPreferences
Quarterly downloads	79 (Ranked 73rd)
Public wikis using	957 (Ranked 262nd)
Traduci l'estensione RevisionSlider se è disponibile su translatewiki.net
Problemi	Compiti aperti · Riportare un bug

L'estensione RevisionSlider aggiunge un'interfaccia a scorrimento per la visualizzazione delle differenze tra le varie versioni in modo tale da potersi muovere facilmente fra di esse.

Installazione

• Download and move the extracted RevisionSlider folder to your extensions/ 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
• Aggiungi il seguente codice al tuo $LocalSettings (preferibilmente alla fine):

  wfLoadExtension( 'RevisionSlider' );
  

•  Done – Naviga in Special:Version nella tua wiki per verificare che l'estensione sia stata installata correttamente.

Uso

	Quando ci si trova su una pagina diff lo slider è chiuso di default e nella parte alta della pagina è visibile solo una barra etichettata come "Browse history": cliccaci su per espandere il Revision Slider.
	Una volta espanso il RevisionSlider mostrerà i dati sulle versioni e permetterà di navigare e confrontarle direttamente nella pagina della differenza.
	Ogni barra rappresenta una versione della pagina. La barre in alto indicano una crescita della dimensione della pagina, quelle in basso una riduzione. Nell'immagine, la versione 1 ha aggiunto del testo, mentre la 2 lo ha rimosso.
	Per confrontare specifiche versioni, selezionale usando le manopole gialla e blu. Quella blu controlla la più recente, quella giallo la più vecchia. 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.
	Le frecce avanti e indietro permettono di muoversi lungo la cronologia e mostrare le versioni più e meno recenti.

Nascondere l'estensione

Se non si usa il RevisionSlider e non lo si vuole nemmeno vedere nelle pagine di diff lo si può nascondere spuntando la casella accanto all'opzione "Non mostrare il RevisionSlider" nelle proprie preferenze sotto "Aspetto -> Differenze".

Contesto tecnico

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.

Esempi

• L'estensione Thanks https://phabricator.wikimedia.org/rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• Il gadget wikEdDiff della Wikipedia in lingua inglese 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.

Contesto

Il RevisionSlider è una funzionalità creata per esaudire una delle richieste prioritarie nella lista dei desideri della comunità germanofona ed è sviluppata dal team TCB di WMDE.

É ispirato al gadget di DerHexer's revisionjumper e basato su un prototipo del team Community Tech di WMF.

Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.