Ayuda:DPL

Ayuda

Esta extensión no está habilitada por defecto, pero puede estar disponible mediante solicitud.

Una lista de paginas dinámica, o el DPL (también conocido como la extensión DynamicPageList) es una poderosa extensión para MediaWiki que permite la creación de listas de páginas usando diversos criterios como la pertenencia a una categoría o inclusión de una plantilla específica. Estas listas son consideradas dinámicas porque se actualizan automáticamente mientras los usuarios añadan categorías a las páginas.

Por ejemplo, si deseas saber todos los episodios de The West Wing que fueron escritos por Aaron Sorkin y en los cuales se encuentra el actor Hal Holbrook, el DPL podría ayudarte con esto en un parpadeo. O si necesitas responder la pregunta "¿Hay algún vulcan civil mitad humano en Star Trek?", el DPL podría ayudarte a encontrar a las personas que están en las categorías Categoría:Vulcan y Categoría:Mitad humanos pero no Categoría:Oficiales de flota.

El DPL aumenta la carga del servidor y puede resultar en cargas de página significativamente más lentas para wikis que lo usen. Y debido a que el DPL tiene numerosos parámetros y aplicaciones, no podemos razonablemente esperar explicarlo en una sola página de ayuda. Por lo tanto, Fandom recomienda encarecidamente que prestes especial atención a un par de secciones de este artículo: "Uso efectivo del DPL" y "Más sobre el DPL".

Fandom usa DynamicPageList3. Puedes encontrar el manual completo en su página de ayuda.

Beneficios del DPL[]

El DPL es muy eficaz porque un poco de código puede producir una larga y detallada lista de información que tomaría mucho tiempo construir manualmente.

Crea anuncios dinámicos de páginas basados en varios parámetros, tales como títulos de páginas, espacios de nombres, la pertenencia a una categoría, la inclusión de una plantilla, y más. Por ejemplo, puede crear una página que enumera todas las páginas en dos categorías, pero no en una tercera.
Puede incluir información de la página, como la fecha de la última edición, nombre de usuario del último editor, y más.
Puede visualizar listas en tablas, viñetas o listas numeradas, en el estilo de una página de categoría, o en línea.
Permite la creación de listas con estilos personalizados y formato insertados entre los elementos.

Cómo incluir DPL en una página[]

Las consultas DPL comienzan con la etiqueta <dpl> y terminan con la etiqueta </dpl>.

Dentro de estas etiquetas, los usuarios pueden poner una amplia variedad de parámetros para personalizar y adaptar la consulta a sus necesidades. También puedes usar la versión de función parser {{#dpl: .... }} si necesitas tener funciones parser expandidas en los parámetros DPL antes de realizar la consulta. Debes usar el "editor de código" para crear consultas DPL; revisa Ayuda:Editor de código#Editor clásico para obtener información sobre cómo acceder al editor de código en tu editor preferido.

Aquí hay un ejemplo muy básico de una consulta DPL:

<dpl>
    category    = Personajes
</dpl>

La consulta anterior generaría una lista de todas las páginas que se encuentran en la categoría Personajes.

Esto se puede personalizar:

<dpl>
    category    = Personajes
    notcategory = Personajes de la temporada 1
    namespace   = Personaje
    mode        = ordered
</dpl>

Esta consulta mostrará todas las páginas que estén en el espacio de nombres Personaje y tienen la categoría Personajes incluso si la página tampoco tiene la categoría "Personajes de la temporada 1". Esta lista también se mostrará como una lista ordenada (<ol>) a diferencia de la lista desordenada predeterminada (<ul>).

Uso efectivo del DPL[]

DPL puede causar cargas pesadas al servidor, ralentizando todo el sitio. Los siguientes son algunos consejos sobre cómo evitar el problema.

Primero, considera si tu uso de DPL es necesario. Si solo deseas una lista de los miembros de una categoría, bastará con un enlace a la página de la categoría. Si solo se usa porque es "genial", es posible que puedas proporcionar algo igualmente interesante a los usuarios en el mismo espacio, como calendarios, videos incrustados, y más.

Segundo, si decides que DPL es la mejor herramienta para el trabajo, ¡mantén resultados DPL en la caché! Sólo tienes que añadir esta línea a tu consulta DPL:

allowcachedresults = true

(Nota: debido a la carga excesiva del servidor, esta opción siempre se establece en true (verdadero), independientemente de la entrada del usuario. Para actualizar la caché para ver resultados nuevos, deberás purgar la caché de la página. )

Usa otras herramientas para usos comunes[]

Crear listas de categoría simples: Para crear listas de categoría simples podrías usar la etiqueta <categorytree> (documentación). Por ejemplo, para obtener una lista de páginas en la categoría "Comunidad", considera lo siguiente:

<nowiki>
<categorytree mode="pages" hideroot=on>Comunidad</categorytree>
</nowiki>

Contenido aleatorio: Usa RandomSelection, la herramienta de selección aleatoria.

Listas de usuarios: Usa Especial:ListaUsuarios para esto.

Foros de estilo wiki: Mira Ayuda:Foro de estilo wiki para la sintaxis <forum>…</forum>. Esto usa DPL detrás de escenas pero con una funcionalidad personalizada para hacer un sistema de foro basado en una página wiki.

Usos avanzados: Para usos más avanzados, comprueba que una extensión más especializada no está disponible antes de utilizar DPL. Por ejemplo, en lugar de crear un calendario con DPL puedes usar una de las extensiones de calendario disponible. Si no estás seguro o no ves la extensión que necesitas, contáctanos y estaremos encantados de ayudarte.

Cosas a evitar[]

No utilices DPL para:

Funciones que utilizan "randomcount"; no se pueden almacenar en caché.
DPL en plantillas que se utilizan en todo el sitio; crea llamadas de DPL ocultas por toda la wiki.
Peticiones largas; no muestres 500 resultados si 20 harán el trabajo.
Más de una o dos consultas por página.

Necesitas purgar la página a veces[]

Si ves una salida extraña de DPL, trata de poner ?action=purge (o &action=purge, si ? ya se usa) al final de la URL y vuelva a cargar la URL. Esto forzará un vaciado de caché del servidor para la página. Puede solucionar problemas donde se actualizó el código DPL de fondo, pero la caché del servidor no fue renovada.

Usos comunes del DPL[]

Galerías[]

El DPL puede ser utilizado para galerías que se automantienen:

<dpl>
    namespace          = Archivo
    category           = NombreDeCategoríaAquí
    format             = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</dpl>

Si estás usando la versión de función parser de DPL, debes usar esta corrección para la salida en galerías.

Trabajo pendiente[]

El DPL puede ser usado para hacer listas de cosas que necesitan ser editadas.

<dpl>
    category           = Esbozos
    format             = ,#%PAGE%\n,,
    allowcachedresults = true
</dpl>

Además, el DPL puede usarse para hacer listas de imágenes que necesitan ser categorizadas:

<dpl>
    namespace   = Archivo
    notcategory = Temporada 1
    notcategory = Temporada 2
    notcategory = Temporada 3
    notcategory = Temporada 4
    format = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</dpl>

Notas[]

Fandom no le da soporte a herramientas basadas en el conteo de vistas de una página.
Tanto la memoria caché DPL como la memoria caché del servidor de la página deben actualizarse para que se reflejen los cambios.

Más sobre el DPL[]

El manual de DPL3 en Fandom (en inglés).
El manual para la versión usada por Fandom antes de la UCP (en inglés).
El manual archivado de DPL (en inglés).
Una página de ayuda completamente original de Memory Alpha (en inglés), que incluye varios ejemplos de uso de DPL relevantes para Fandom.

Ayuda y comentarios[]

Navega y busca otras páginas de ayuda en Ayuda:Contenidos.
Revisa Comunidad Central de Fandom para más fuentes de ayuda y soporte.
Revisa Contactar con Fandom para saber cómo reportar algún error o algún paso que no esté claro en este artículo.