Wiki della Community
Advertisement
Wiki della Community

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[]

Aiuto aggiuntivo e feedback[]

Advertisement