DPL, conosciuta anche come estensione Dynamic Page List, è una potente estensione MediaWiki che permette la creazione di liste di pagine usando diversi criteri, come l'appartenza ad una Aiuto:Categorie o l'inclusione di un template specifico. Questa liste sono considerate dinamiche perché si aggiornano automaticamente come gli utenti aggiungono categorie alle pagine.
Per esempio, se volessi trovare tutti gli episodi di The West Wing che sono stati scritti da Aaron Sorkin e che hanno avuto come guest star Hal Holbrook, DPL potrebbe dirtelo in un attimo. O se avessi bisogno della risposta alla domanda, "Ci sono civili Vulcaniani mezzi-umani in Star Trek?" DPL potrebbe aiutarti a trovare queste persone che sono nella Categoria:Vulcaniani e nella Categoria:Mezzi-umani ma non in Categoria:Ufficiali della Flotta Stellare.
A causa della sua potenza, DPL incrementa il carico sul server e può rallentare significativamente il caricamento delle pagine per le wiki che la usano. E poichè DPl ha numerosi parametri e applicazioni, non possiamo sperare ragionevolemente di spiegare tutto in una singola pagina di aiuto. Peranto, Fandom ti incoraggia a prestare particolare attenzione ad un paio di sezioni di questo articolo: "Usare DPL efficacemente" e "Di più su DPL".
Fandom utilizza DynamicPageList3. Puoi trovare il manuale completo qui.
Benefici di DPL
DPL è molto efficace perché poco codice può produrre lunghe e dettagliate liste di informazioni che impiegherebbero molto tempo ad essere costruite manualmente.
- Crea liste dinamiche di pagine basate su diversi parametri, come i titoli delle pagine, i namespace, l'appartenenza ad una categoria, l'inclusione di template, e altro. Per esempio, puoi creare una pagina che elenca tutte le pagine in due categoria ma non nella terza.
- Può includere informazioni della pagina, come la data dell'ultima modifica, il nome utente dell'ultimo constributore e altro.
- Può mostrare i dati in tabelle, elenchi puntati o numerati, nello stile delle pagine di categoria o inline.
- Permette la creazione di elenchi con stili e formattazione personalizzati tra gli elementi dell'elenco.
Come includere DPL in una pagina
Le chiamate DPL iniziano con il tag <dpl> e sono chiuse con il tag </dpl>. All'interno di questi tag, gli utenti possono inserire un'ampia varietà di parametri per personalizzare e raffinare la chiamata a ciò di cui hanno bisogno. Si può usare anche la versione a funzione parser {{#dpl: .... }} se hai bisogno di avere una funzione parser nei parametri di DPL prima che sia fatta la richiesta. Devi usare l'editor "sorgente" per creare la chiamata DPL, vedi Aiuto:Editor sorgente per informazioni su come accedere alla modalità sorgente nella tua modalità preferita.
Ecco un esempio molto basilare di chiamata DPL:
<dpl>
category = Personaggi
</dpl>
Questa richiesta qui sopra genera una lista di tutte le pagine che sono nella categora Personaggi. This can be further customized:
<dpl>
category = Personaggi
notcategory = Stagione 1 Personaggi
namespace = Personaggio
mode = ordered
</dpl>
Questa richiesta mostrerà tutte le pagine che sono nel namespace Personaggio e hanno la categoria Personaggi, sempre se non appartengono all categoria Stagione 1 Personaggi- Questa lista sarà anche stampata come un elenco numerato (<ol>) rispetto all'elenco di default con bagagli non ordinati (<ul>).
Usare DPL efficacemente
DPL può causare pesanti sovraccarichi del server, rallentando l'intero sito. I seguenti sono consigli su come aggirare il problema.
Per prima cosa, considera se il tuo utilizzo di DPL sia necessario. Se vuoi soltanto una lista dei membri di una categoria, allora un link alla pagina di categoria o un CategoryTree può bastare. Se è soltanto usato perché è "figo", potresti essere in grado di fornire qualcos'altro di bello per gli utenti nello stesso spazio, come un calendario, video incorporati, e altro.
Secondo, se decidi che DPL è lo strumento migliore per te, lascia che DPL usi la cache per i risultati! Aggiungi semplicemente questa linea al tuo codice DPL:
allowcachedresults = true
(Nota: a causa dell'eccessivo carico al server, questa opzione è sempre impostata su vero, a prescindere dall'input dell'utente. Per aggiornare la cache e vedere risultati recenti, dovrai purgare la cache della pagina.)
Usare agli strumenti per usi comuni di DPL
- Creare semplici liste di categorie
- Per creare semplici liste di categorie potresti usare il tag <categorytree> (documentazione). Per esempio, per ottenere la lista di pagine nella categoria 'Community' utilizza questo codice:
<categorytree mode="pages" hideroot="on">Community</categorytree>
- Contenuti casuali
- Usa RandomSelection.
- Liste di utenti
- Usa Speciale:Utenti per questo.
- Forum in stile wiki
- Vedi Aiuto:Forum in stile wiki per la sintassi del forum
<forum>…</forum>. Questo utilizza DPL dietro le quinte ma con funzionalità personalizzate per generare una struttura a forum in una pagina della wiki.
- Usi avanzati
- Per usi più avanzati, controlla per favore che non sia disponibile un'estensione più specializzata prima di usare DPL. Per esempio, invece di creare un calendario con DPL usa una delle estensioni calendario disponibili. Se non sei sicuro o non vedi l'estensione di cui hai bisogno, contattaci e saremo felici di aiutarti.
Cose da evitare
Per favore evita di utilizzare troppo:
- Funzioni che usano "randomcount"; non possono essere salvate in cache
- Template che sono usate per tutto il sito; crea chiamate DPL nascoste per tutta la wiki
- Ampie chiamate; non mostrare 500 risultati quando 20 basterebbero
- Più di una o due chiamate per pagina
A volte devi pulire la cache
Se vedi risultati dal DPL strani o non aggiornati, prova ad aggiungere ?action=purge (o &action=purge, se ? è già utilizzato) alla fine del tuo URL e ricarica l'URL. Questo forzerà una pulizia della cache della pagina sul server.
Usi comuni per DPL
Gallerie
DPL può essere usato per creare gallerie che si mantengono da sole:
<dpl>
namespace = File
category = NomeCategoriaVaQui
format = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
allowcachedresults = true
</dpl>
Se stai usando la versione funzione parser di DPL, devi usare questa correzione per avere in uscita delle gallerie.
Lavoro in corso
DPL può essere usato per creare liste di cose che devono essere modificate:
<dpl>
category = Abbozzo
format = ,#%PAGE%\n,,
allowcachedresults = true
</dpl>
DPL può essere usato per creare liste di immagini che devono essere categorizzate:
<dpl>
namespace = File
notcategory = Stagione 1
notcategory = Stagione 2
notcategory = Stagione 3
notcategory = Stagione 4
format = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
allowcachedresults = true
</dpl>
Note
- Fandom non supporta l'utilizzo di funzioni basate sul conteggio delle visite di una pagina.
- Sia la cache DPL sia la cache della pagina sul server devono essere aggiornate affinché le modifiche siano visibile.
Di più su DPL
- Il manuale di DPL 3 su Fandom
- FAQ sulla conversione delle funzioni alla UCP
- Manuale per la versione usata da Fandom prima della UCP
- Il manuale DPL archiviato
- La pagina di aiuto interamente originale di Memory Alpha, che include esempi di utilizzo di DPL rilevanti per Fandom.
Aiuto aggiuntivo e feedback
- Naviga e cerca altre pagine di aiuto su Contenuti.
- Esplora la Wiki della Community per ulteriori fonti di aiuto o supporto.
- Leggi come contattare Fandom per problemi o segnalare errori.