Wiki della Community
Advertisement

Gli Accessori offrono personalizzazioni CSS e JS agli utenti che scelgono di usarle. Al contrario del CSS e JS della community, che è caricato per tutti gli utenti, gli accessori CSS e JS sono viste solo dagli utenti che abilitano gli accessori. Gli accessori sono specifici per ciascuna community; gli utenti possono abilitarli o disabilitarli nelle loro preferenze nella scheda "Accessori".

Gli accessori sono un modo per fornire agli utenti un'esperienza personalizzata opzionale. Tuttavia, tieni a mente che gli utenti anonimi non possono attivare o disattivare nessun accessorio impostato come attivo di default.

Richiedere l'estensione[]

Di default, la maggior parte delle community di Fandom non utilizza gli accessori. Gli accessori sono disponibili attraverso un'estensione; qualsiasi community che desidera utilizzare gli accessori deve contattare lo Staff per richiederne l'attivazione sulla propria wiki.

Lista degli accessori[]

Un esempio di Speciale:Accessori

Per vedere la lista degli accessori di una community, recati su Speciale:Accessori. Questa pagina speciale fornisce anche link per modificare la descrizione degli accessori, mostra la lista dei file usati da ciascun accessorio, e mostra qualsiasi permesso utente richiesto da ciascun accessorio. Nota che non puoi attivare o disattivare accessori su questa pagina: devi recarti su Speciale:Preferenze per scegliere quali accessori attivare.

Le wiki che non hanno l'estensione "Accessori" attiva vedranno una pagina di errore al posto di Speciale:Accessori, dato che non esiste.

Creare un accessorio[]

Definizione dell'accessorio[]

Il primo passo nel creare un accessorio è definirlo. Per farlo, modifica MediaWiki:Gadgets-definition sulla tua community. Ciascun accessorio è definito da un'entrata in una lista puntata, quindi ciascuna riga inizia con *. La formattazione della definizione dell'accessorio è la seguente:

* nome_accessorio [opzioni] | file1 | file2 | etc.

  • nome_accessorio deve essere unico ed è sensibile alle maiuscole. Deve iniziare con una lettera latino semplice ([A-Za-z]) e può essere seguito da qualsiasi numero di lettere, numeri ([0-9]), trattini (-), trattini bassi (_), due punti (:) e punti (.).
  • Leggi § Opzioni degli accessori per una spiegazione su opzioni.
  • Leggi § File per gli accessori per una spiegazione su file1, file2, etc.

Se la tua wiki ha molti accessori, può aiutare dividere la lista in sezioni usando ==titolo==. Per esempio, la seguente lista di quattro accessori è divisa in due sezioni: servizi e visuali. Come i nomi degli accessori, i titoli delle sezioni sono anch'essi sensibili alle maiuscole e devono essere unici.

==servizi==
* Servizio1 [ResourceLoader] | NiceUtility.js
* Servizio2 [ResourceLoader|rights=rollback] | RollbackUtil.js | RollbackUtil.css

==visuali==
* Tema1 [type=styles] | CoolTheme.css
* Thema2 [type=styles] | FireTheme.css

Descrizione degli accessori[]

Un esempio di MediaWiki:Gadgets-definition

Di default, gli utenti vedono i tuoi accessori presentati in Speciale:Preferenze come ⧼gadget-nome_accessorio⧽. Questa non è una descrizione molto utile. Puoi modificare questa descrizione andando su MediaWiki:Gadget-gadget_name sulla tua wiki. Puoi anche recarti sulla lista degli accessori a Speciale:Accessori e cliccare il link "Modifica" accanto alla definizione di ciascun accessorio.

Le descrizioni degli accessori devono essere ragionevoli. Una descrizione utile spiega tutto ciò che l'utente vedrà in modo diverso o l'accesso che guadagnerà attivando l'accessorio. Ricorda che gli accessori sono pensati per dare agli utenti la scelta di modificare la propria esperienza sulla wiki. Per poter scegliere, devono avere informazioni accurate.

Anche i titoli delle sezioni possono essere modificati per apparire più chiari agli utenti. Nell'esempio qui sopra, per modificare il titolo servizi, vai semplicemente su MediaWiki:Gadget-section-utilities o clicca il link "Modifica" vicino al titolo della sezione su Speciale:Accessori.

Opzioni degli accessori[]

La definizione di un accessorio può includere opzioni per specificare ulteriormente come caricare l'accessorio o chi può abilitarlo. Ciascuna opzione deve essere separata da un carattere | (pipe). Le opzioni che non richiedono nessun parametro, come ResourceLoader, possono semplicemente essere incluse da sole; le opzioni che richiedono dei parametri devono essere incluse con segni di uguale seguiti da una lista di parametri separati da virgole, come ad esempio rights=rollback,delete.'

La tabella qui sotto elenca le opzioni degli accessori disponibili per le community di Fandom.

Nome Parametri Descrizione
ResourceLoader Nessuno Segnala lo script dell'accessorio come compatibile con ResourceLoader.
Questa opzione è richiesta per ogni accessorio che carica almeno un file JS, altrimenti Speciale:Accessori mostrerà un errore e il JS non verrà caricato.
dependencies Nomi dei moduli di ResourceLoader separati da virgole Nota che questa opzione non ha effetto se l'accessorio non ha risorse compatibili con ResourceLoader (cioè nessuno stile o script segnalato come compatibile).
rights Nome dei permessi utente separati da virgole Disabilita e nasconde l'accessorio nelle preferenze per gli utenti che non hanno questi diritti utente. Nota che i diritti utente non sono i gruppi utenti; la lista completa dei permessi utente è disponibile su Speciale:ElencoPermessiGruppi.
default Nessuno Ciascun accessorio impostato come default DEVE rispettare le Regole sulla personalizzazione.
Attiva l'accessorio di default per tutti, inclusi gli utenti anonimi. Solo gli utenti registrati possono disabilitare questo accessorio.
type styles o general Usa type=styles per gli accessori che caricano solo file CSS. Questo caricherà il CSS attraverso l'HTML della pagina, che è più veloce della modalità di caricamento di default di JavaScript. Nota che type=styles non caricherà alcun file JS nell'accessorio.

File per gli accessori[]

L'elemento fondamentale di un accessorio sono i file che carica quanto è attivato. Ciascuna pagina CSS o JS che viene caricata da un accessorio deve iniziare come MediaWiki:Gadget-. Nell'esempio qui sopra, Servizio2 definisce due file, "RollbackUtil.js" e "RollbackUtil.css", che devono trovarsi quindi a MediaWiki:Gadget-RollbackUtil.js e MediaWiki:Gadget-RollbackUtil.css, rispettivamente. Una buona regola è usare lo stesso nome per l'accessorio e per i file, ma, come mostrato, questo non è un requisito.

Oltre al prefisso Gadget-, i file CSS e JS degli accessori funzionano come ogni altro file CSS o JS. In quanto tali, nota per favore che i file JS per gli accessori devono essere approvati dal Processo di revisione del JavaScript prima che siano disponibili per tutti. In termini di ordine di caricamento, gli accessori sono caricati dopo gli altri codici locali della community, ma prima dei codici personali.

Un accessorio può caricare tante pagine quanto si desidera, ma è raro che carichi più di una pagina JS e una pagina CSS. Ciascun file deve essere preceduto nella definizione dell'accessorio con un carattere pipe |. Ciascuna pagina CSS o JS di un accessorio può anche essere caricata da più accessori. Come altre pagine per tutto il sito, gli accessori possono essere scritti solo usando JS o CSS.

Vedi anche[]

Aiuto aggiuntivo e feedback[]

Advertisement