Cimitero:Aiuto:Manuale/DPL

Da DPLpedia, l'enciclopedia interamente controllata minuto per minuto Nella rara eventualità che il vostro lavoro su Nonciclopedia richieda delle liste particolari che il DPLMonitor standard non può visualizzare, ecco una breve guida alla personalizzazione del vostro Monitor.

ATTENZIONE: I Monitor appesantiscono il server di Nonciclopedia, quindi vanno creati solo e unicamente se sono strettamente necessari e non ci sono altre alternative valide.

Il template DPL

Tutti i parametri del vostro DPLMonitor dovranno essere racchiusi nel template DPL in questo modo:

{{#dpl:
|attributo1=valore1
|attributo2=valore2
...
}}

Attenzione: Se il DPL di cui avete bisogno è solo una lista di pagine senza particolari dettagli (vedi attributo mode più sotto), può essere utile disporre la lista su tre colonne in questo modo:

<div class="tri-column" style="font-size: 10px;">{{#dpl:
|attributi vari
}}</div>

Attributo allowcachedresults

Questo è il primo attributo che bisognerebbe sempre inserire nel proprio DPL, e sempre con valore true, così:

{{#dpl:
|allowcachedresults=true
}}

Questo attributo serve ad evitare che la lista venga generata ogni volta che si carica la pagina, risparmiando parecchio lavoro al server. Se avete comunque bisogno di aggiornare di frequente la lista, non mettete il valore false perché non funziona comunque bene, piuttosto date un'occhiata qui.

Attributo titleregexp

Questo attributo esegue una selezione in base a un'espressione regolare. Il suo valore di default è tutte le voci.

Esempio

{{#dpl:
|titleregexp=^[A]
|allowcachedresults=true
}}

Restituisce una lista di tutte le pagine che cominciano con la lettera A. Attenzione però: le pagine che cominciano con la lettera A sono parecchie, e il DPL ha dei limiti, che verranno spiegati nel prossimo paragrafo.

Attributi count e offset

Queste due proprietà determinano quanti e quali pagine mostrare tra quelle trovate.

• L'attributo count determina il numero di pagine da mostrare. Il suo valore di default è il massimo possibile, ovvero 500.
• L'attributo offset determina il punto di partenza nella lista. Il suo valore di default è 0.

È importante impostare sempre count per mostrare il minimo indispensabile, visto che più un DPL è grande, e più consuma risorse al server.

Queste due proprietà sono anche molto usate nel caso di DPL concatenati, in questo modo:

{{#dpl:
|attributi vari
|count=500
|offset=0
}}{{#dpl:
|stessi attributi di prima
|count=500
|offset=500
}}
...

Esempio

{{#dpl:
|titleregexp=^[A]
|count=500
|offset=0
|allowcachedresults=true
}}{{#dpl:
|titleregexp=^[A]
|count=100
|offset=500
|allowcachedresults=true
}}

Produce una lista contenente le prime 600 pagine che cominciano con la lettera A.

Attributi namespace, category e uses

Questi attributi sono molto utili per dei monitoraggi mirati.

• L'attributo namespace visualizza solo le voci di un determinato namespace registrato, come per esempio Aiuto, Nonciclopedia, NonDizionario, Utente, Discussione e altri ancora. Non funziona invece con i namespace non registrati come Test o Manuali. È possibile inserire nel proprio DPL più di un namespace in questa maniera:

|namespace=namespace1
|namespace=namespace2
...

Oppure

|namespace=namespace1{{!}}namespace2{{!}}...

Il suo valore di default è tutti i namespace. Attenzione quindi, se si vuole visualizzare solo il namespace principale bisogna scrivere:

|namespace=

• L'attributo notnamespace svolge la funzione opposta di namespace, ovvero esclude un namespace dalla lista, e si usa la stessa sintassi dell'attributo namespace. Il suo valore di default è nessun namespace.
• L'attributo category si comporta in maniera simile a namespace, e serve a visualizzare una categoria. A differenza di namespace però, la sintassi

|category=categoria1
|caregory=categoria2
...

visualizza tutti gli articoli che appartengono contemporaneamente a tutte le categorie elencate, mentre

|category=categoria1{{!}}categoria2{{!}}...

elenca tutti gli articoli che appartengano ad almeno una delle categorie. Il valore di default di category è tutte le categorie.

• L'attributo notcategory, analogamente a notnamespace, esclude una categoria dalla lista. Si comporta come category e il suo valore di default è nessuna categoria.
• L'attributo uses elenca tutte le pagine che includono altre pagine. Il funzionamento è identico all'attributo category e il suo valore di deafult è tutte le inclusioni
• L'attributo notuses invece elenca tutte le pagine che non includono una determinata pagina. Il suo valore di default è nessuna inclusione

Esempio

{{#dpl:
|namespace=
|uses=Template:Formattazione
|allowcachedresults=true
}}

Produce una lista di tutte le pagine che usano il template Fromattazione nel solo namespace principale.

L'attributo mode

Questo attributo determina come è strutturato l'elenco, e accetta 4 possibili valori:

• unordered: gli articoli sono visualizzati con un elenco puntato. È il valore di default.
• ordered: gli articoli sono visualizzati con un elenco numerato.
• none: gli articoli sono visualizzati senza un elenco.
• userformat: gli articoli sono visualizzati in maniera personalizzata. Questo valore può comportare l'aggiunta di diversi attributi e una sintassi abbastanza articolata, per cui si rimanda alla guida completa linkata a fondo pagina.

Esempio

{{#dpl:
|uses=Template:Accusa
|mode=ordered
}}

Produce una lista numerata degli articoli sotto accusa.

Gli attributi ordermethod e order

Questi due attributi determinano in base a che criterio viene ordinata la lista.

• L'attributo ordermethod determina il tipo di ordinamento (alfabetico, in base alla grandezza della pagina, ...). Per una lista esaustiva dei parametri si rimanda al manuale completo.
• L'attributo order accetta i parametri ascending (default) o descending, e determina se l'ordine dell'elenco è crescente o decrescente.

Esempio

{{#dpl:
|category=Pagine da cancellare
|mode=ordered
|ordermethod=categoryadd
|allowcachedresults=true
}}

Produce una lista numerata delle pagine da cancellare, ordinata in base all'inserimento nella categoria.

L'attributo redirects

Questo attributo indica se i redirect debbano apparire nella lista, e accetta 3 possibili valori:

• exclude: non vengono visualizzati i redirect. È il valore di default.
• include: vengono visualizzati anche i redirect.
• only: vengono visualizzati solo i redirect.

Esempio

{{#dpl:
|namespace=Nonciclopedia
|redirects=only
|allowcachedresults=true
}}

Produce una lista di tutti i redirect nel namespace Nonciclopedia.

Altra roba semi inutile e noiosa

In questa guida sono stati visti gli attributi più utili, però ce ne sono decine di altri. Un buon sito per approfondire è sicuramente questo.