View source for Aiuto:Accessori/Popup di navigazione

{{Abbreviazioni|Aiuto:POPUP|WP:POPUP}}
{{ManualeAccessorio|script=Popup}} 
[[Immagine:anteprima-popup.png|thumb|upright=2|Un popup in azione]]
I '''popup di navigazione''' sono delle [[Menu contestuale|finestre di interazione contestuale]] che offrono un accesso facile e immediato a numerose funzioni di Wikipedia: è sufficiente lasciare il puntatore del mouse su un [[aiuto:Wikilink|wikilink]] per far apparire il popup.

Se riscontri dei problemi prova a consultare le [[Aiuto:Accessori/Popup di navigazione/FAQ|FAQ]].

== Funzionalità ==
[[File:popup-immagine-piccola.png|thumb|Anteprima piccola dell'immagine di una voce]]
[[File:popup-immagine-grande.png|thumb|Facendo clic, l'anteprima viene ingrandita]]
[[File:popup-rollback.png|thumb|Un [[Aiuto:Rollback|rollback]] eseguito tramite un popup]]
[[File:Screenshot del popup per disambiguare - itwiki.jpg|thumb|Il popup utilizzato per disambiguare]]
* Anteprima della prima parte del testo di una voce (grazie a [[:en:User:Pilaf|Pilaf]] per il suo script ''Live Preview'' che ha reso possibile tutto questo);
* anteprima delle immagini dai loro collegamenti;
* anteprima della prima immagine di ogni voce;
* anteprima delle differenze negli osservati speciali, nella cronologia e nelle modifiche correlate;
* anteprima dei wikilink selezionati durante la modifica di una pagina (usa il mouse per selezionare un wikilink);
* rollback dei vandalismi con un click dalla cronologia (vedi immagine);
* informazioni su redirect, stub e pagine di disambiguazione;
* informazioni sulla pagina come la dimensione, il numero di link, il numero di immagini, il numero di categorie e l'età della pagina;
* accesso immediato (con un click) a
** modifica della pagina;
** contributi utente;
** [http://tools.wikimedia.de/~interiot/cgi-bin/count_edits tool di Interiot] (edit counter);
** funzione ''scrivi all'utente'';
** cronologia;
** funzione ''segui/non seguire'';
** mostra e permette di modificare le pagine di discussione;
** funzione ''puntano qui'';
** funzione ''modifiche correlate'';
** elenco delle sottopagine delle pagine utente;
** log utente e log dei blocchi;
** ricerca in Wikipedia, [http://vs.aka-online.de/globalwpsearch/ ricerca globale su Wikipedia] e su [[Google]];
** (per gli amministratori) funzioni ''proteggi'', ''sblocca'', ''cancella'' e ''blocca utente''.
* Dovrebbe funzionare su tutti i wiki di Wikimedia
* Scorciatoie da tastiera (opzionali)
* Riparazione automatica dei link per evitare i redirect e le pagine di disambiguazione (opzionale)

== Guida all'utilizzo ==

Questo strumento serve per generare dei "popup di suggerimento" quando lasci il puntatore del mouse sopra a link o immagini.

Molte delle funzionalità considerate più importanti possono essere comodamente usate dalla lista degli osservati speciali.

*lascia il mouse sopra al link ad una differenza per mostrare un riassunto delle modifiche effettuate
*lascia il mouse sopra al link alla revisione di una voce per mostrare un breve estratto della revisione

Dovrebbero esserci anche alcuni "link di navigazione" che offrono l'accesso a diverse funzioni, compreso un rollback immediato, la modifica della pagina e così via. Potrebbero essere incluse direttamente nel template, o nascoste nel menu "azioni", a seconda del tuo browser e delle tue impostazioni.

Nelle voci normali:

*lascia il mouse sopra ad un link per far apparire un breve estratto della voce collegata, poi passa con il mouse sopra al link "azioni" per vedere i comandi aggiuntivi
*tieni premuto il tasto shift per aggiustare la posizione del popup

== Configurazione (opzionale) ==
=== Cambiare l'aspetto dei popup ===

Puoi cambiare l'aspetto dei popup tramite il tuo file [[Cascading Style Sheets|CSS]].
Il tuo file CSS ha esattamente lo stesso nome del file javascript, con "css" invece di "js" alla fine. Quindi, per la maggior parte delle persone, il file da modificare è [[Special:Mypage/common.css|common.css]].

Quello che segue è un esempio che presenta un popup arancione con un bordo e cambia il font in uso. Il popup avrà un aspetto abbastanza stupido, ma è una dimostrazione del tipo di cose che si possono fare con un po' di voglia.

<source lang=css>
.navpopup { 
  background-color: #FFBE20  !important;
  font-family:      serif    !important;
  color:            #404     !important;
  font-size:        medium   !important;
}
</source>

=== Opzioni ===

Ci sono alcune opzioni che puoi personalizzare. Per farlo, modifica il tuo file javascript (ad esempio [[Special:Mypage/common.js|common.js]]) e aggiungi una linea del tipo
:<kbd>''opzione'' = ''valore'';</kbd>

dove <kbd>''opzione''</kbd> e <kbd>''valore''</kbd> sono scelti dalla tabella seguente. Per esempio, per evitare ogni tipo di download e mostrare i link per amministratori, avrai bisogno di una cosa del genere nel tuo file javascript:

<source lang=javascript>
simplePopups = true;
popupAdminLinks = true;
</source>

{| class="wikitable"  cellpadding="4" border="1"
|colspan=3|<div align="center">'''Opzioni di configurazione'''</div>
|-
!Opzioni
!Valori*
!Descrizione
{{Aiuto:Accessori/Popup di navigazione/Opzioni_generali}}
{{Aiuto:Accessori/Popup di navigazione/Opzioni di modifica}}
{{Aiuto:Accessori/Popup di navigazione/Opzioni di anteprima}}
{{Aiuto:Accessori/Popup di navigazione/Opzioni tecniche}}
{{Aiuto:Accessori/Popup di navigazione/Opzioni sperimentali}}
|}

<nowiki>*</nowiki>I valori predefiniti sono elencati in grassetto

Potrebbero essere aggiunte altre opzioni, e le richieste di una maggiore flessibilità di configurazione sono più che benvenute.

=== Personalizzazione avanzata ===
È possibile definire filtri personalizzati per le voci, funzioni javascript che vengono eseguite dopo che le statistiche della pagina sono state generate, e il loro output viene inserito (come HTML) in quella parte del popup. (Nota bene che se simplePopups è true o popupSummaryDaya è false, non verrà mostrato nulla).

Per mettere su una cosa del genere, è necessario scrivere una funzione filtro che accetti una stringa (il wikitesto della voce) come input, e ritorni un frammento di HTML. Ripeti quante volte vuoi, poi crea un array <kbd>extraPopupFilters</kbd> che contenga tutte le funzioni, nell'ordine in cui vuoi che vengano eseguite.

Per esempio, mettiamo che vuoi che ti venga detto ogniqualvolta il wikitesto di una voce contiene una tabella scritta utilizzando tag HTML piuttosto che il linguaggio wiki. Un modo per realizzarlo è aggiungere le seguenti linee al tuo file javascript:

<source lang=javascript>
// inizializza l'array - fallo soltanto una volta
extraPopupFilters=[];

// definisce la funzione
function popupFilterHtmlTable (wikiText) {
  if (/<table/i.test(wikiText)) return '&amp;lt;tabella&amp;gt;';
  else return '';
};

// aggiunge la funzione all'array (puoi ripeterlo per tutte le funzioni che vuoi)
extraPopupFilters.push(popupFilterHtmlTable);
</source>

Dopodiché, quando un popup viene generato per una pagina contenente una tabella HTML, dovresti vedere &lt;tabella&gt; nel popup. (Potrebbe apparire anche per altre pagine, come questa. La correzione di tale difetto è lasciata al lettore come esercizio).

== Crediti di traduzione ==

La traduzione italiana è a cura di:
* [[Utente:Emc2|Emc2]], aiuto alla traduzione delle stringhe, debug del file di stringhe, traduzione della pagina corrente, traduzione delle [[/FAQ|FAQ]], smazzamenti vari
* [[Utente:Valepert|Valepert]], traduzione delle stringhe, creazione degli screenshot illustrativi, manutenzione del file di stringhe, traduzione dei parametri di configurazione, smazzamenti vari

Per ogni tipo di lamentele, complimenti, segnalazioni di bug e quant'altro potete alternativamente contattare [[Utente:Emc2|Emc2]] o [[Utente:Valepert|Valepert]], o (in inglese) [[:en:User:Lupin|Lupin]], lo sviluppatore che ha reso possibile tutto ciò.

== Problemi di browser ==
=== Google Chrome ===
Se sei un utente di [[Google Chrome]] e utilizzi l'estensione deprecata Virtual Keyboard (by Google) i popup potrebbero apparire nella posizione errata. Il problema è stato riscontrato nella versione 0.9.8.8. Si suggerisce di installare l'estensione Google Input Tools.

=== Mozilla Firefox ===
Se sei un utente di [[Mozilla Firefox]] e utilizzi l'estensione AdBlock Plus potresti non visualizzare il popup di navigazione.
Il problema può essere risolto aggiungendo un'eccezione alle regole sui filtri, disabilitando l'estensione su it.wikipedia.org.<!--da parecchie versioni di definizioni non è più visto come ad-->

L'estensione Linky potrebbe entrare in conflitto con l'uso dei popup, provocando l'apertura di centinaia di schede. Si suggerisce di disabilitare i popup nel caso si voglia continuare ad utilizzare l'estensione.

=== Internet Explorer ===
Le pagine che presentano "–" nel titolo potrebbero non essere visualizzate correttamente. Il bug non è presente in [[Internet Explorer]] 9.

=== Safari ===
I menu potrebbero non funzionare nelle vecchie versioni di [[Safari (browser)|Safari]]. È quindi consigliabile aggiornare il browser alla versione 3 o successiva.

=== Opera ===
Le versioni più vecchie di [[Opera (browser)|Opera]] presentano alcuni bug che impediscono ai menu di funzionare correttamente. Alcuni dei problemi segnalati includono popup che non si caricano o che non scompaiono dopo aver spostato il mouse. L'utilizzo della [http://www.opera.com/download/ versione corrente] (11.0 o superiore) dovrebbe fornire menu perfettamente funzionanti.
<!--
== Versione di sviluppo ==
Questo strumento rimane sotto sviluppo. L'ultimissima versione è disponibile a [[:en:User:Lupin/popupsdev.js]], e vedrà le nuove funzionalità prima della versione stabile. Attenzione però, poiché la versione di sviluppo ha la tendenza ad andare in crash ogni tanto.
Se desideri installarla, puoi scrivere
  <nowiki>{{subst:en:User:Lupin/popupsdev.js}}</nowiki>
nel tuo file javascript e cancellare l'installazione dei popup corrente da quel file.
-->

==Crediti e collegamenti esterni==
Questo strumento dipende dal lavoro di altre persone:
*[[:en:User:Pilaf/InstaView]] (née [[:en:User:Pilaf/Live Preview|Live Preview]]) da parte di [[:en:User:Pilaf|Pilaf]]
*una funzione Javascript per gli hash [[MD5]] da parte di Paul Johnston e altri, disponibile [http://pajhome.org.uk/crypt/md5 qui]
*[http://www.youngpup.net/2001/domdrag domdrag] di Aaron Boodman
*Un'[http://ejohn.org/projects/javascript-diff-algorithm/ implementazione] di un algoritmo per le differenze di John Resig
Versioni più vecchie del programma usavano [http://www.bosrup.com/web/overlib overlib] di Erik Bosrup.

===Wikipediani che hanno aiutato===
*[[:en:User:Brian0918|Brian0918]] - un po' di codice e tantissima ispirazione
*[[:en:User:Eddideigel|Eddideigel]] - lavoro di traduzione
*[[:en:User:IceKarma|IceKarma]] - eliminato il codice per il download, sostituito da un uso molto migliore della banda
*[[:en:User:Mike Dillon|Mike Dillon]] - il codice per l'età della pagina
*[[:en:User:Yurik|Yurik]] - con la sua fantastica [[:en:User:Yurik/Query_API|estensione mediawiki BotQuery]]
*[[:en:User:Zocky|Zocky]] - i menu
*[[:en:User:Zyxw|Zyxw]] - miglioramenti all'anteprima
*...e molti altri con utilissimi suggerimenti, commenti e segnalazioni di bug

[[Categoria:Strumenti di manutenzione]]
[[Categoria:Aiuto]]
[[Categoria:Servizi MediaWiki]]