Introdução ao DynamicPageLists no Fandom

Cuidado! Este é um conselho avançado de codificação, usando muitos termos técnicos que você encontra na codificação. Se você ainda não entendeu coisas como funções parser ou wikitexto em geral, aprenda mais sobre essas funções antes de prosseguir.

DynamicPageLists é uma extensão que pode opcionalmente ser habilitada no Fandom pela Equipe do Fandom. Normalmente, este é um gerador semelhante a como alguém consultaria conjuntos de dados, digamos, SQL. Exceto aqui, você pode consultar artigos wiki e seus dados associados diretamente, para agregá-los de uma maneira diferente ou combiná-los para aprimorar seus artigos de forma dinâmica e automática.

DPL ou Não DPL - Por que & Quando[]

Como mencionado antes, o DPL é ótimo para ajudar a agregar coisas, ou incluir novo conteúdo que está sendo criado após o DPL query ter sido publicado.

Para ter uma ideia básica do que o DPL pode fazer, você pode dar uma olhada no mecanismo que nossa página de solicitação da Central da Comunidade para links interlínguas está usando - a DPL nos permite ver todas as novas solicitações (=artigos mediawiki) que são criadas por usuários com uma determinada categoria anexada a eles em um formato de lista personalizado. Clique aqui para ver o código fonte.

Um bom caso de uso é se você deseja usar DPL para automatizar a manutenção de conteúdo e criar páginas que combinam informações modulares.

Digamos que você esteja em uma wiki de jogos e queira combinar todas as descrições de um determinado conjunto de armaduras em uma única página, mas não deseja copiar e colar de cada artigo para evitar ter que manter ambos atualizados. Ou você está em uma wiki de anime/tv onde tem páginas de episódios com resumos que deseja combinar em uma página de resumo da temporada.

O DPL pode te ajudar a automatizar isso, ao pegar uma seção específica de um artigo diferente e carregá-lo como se tivesse sido escrita na página onde você estiver usando o DPL.

Você pode ver um exemplo customizado aqui: https://myheroacademia.fandom.com/wiki/Episodes?action=edit

Se você fizer isso, considere quais e quantas informações você consulta ou pretende renderizar. À medida que a série continua, isso pode começar a aumentar o tempo de carregamento da página e isso terá um efeito negativo no seu SEO, portanto, considere uma visão geral separada para cada finalidade de coleta. Além disso, certifique-se sempre de que uma nova página inclua algum texto original, por exemplo uma introdução, quando você o faz!

Testando e Considerações de Serverload[]

Ao tentar coisas novas com o DPL, sempre defina um limite abaixo de 2-5, usando o parâmetro count (porque ele irá contar até o limite). Isso permite que você teste as suas alterações com muito mais rapidez porque menos dados precisam ser compilados para renderização, além de impedir que você consulte acidentalmente milhares de páginas de uma só vez.

Especialmente se você aprofundar a inclusão do conteúdo do artigo usando o parâmetro include, é altamente recomendável testar primeiro em uma capacidade limitada.

Não Gere Navboxes Com o DPL[]

Pode ser tentador criar uma navbox com todos os artigos de uma determinada categoria. No entanto, esta é uma má ideia por vários motivos.

Para começar, muitos links em uma página são ruins para o SEO da sua wiki, o que resultará em menos visualizações ao longo do tempo. Dependendo de quantos artigos você tem na categoria, que pode ser um pouco hoje, mas muito amanhã, isso também pode criar problemas de usabilidade e acessibilidade. Lembre-se de que você sempre deseja projetar com acessibilidade em mente.

Em vez disso, certifique-se de incluir apenas os links mais importantes em uma navbox e certifique-se de que as páginas para as quais você aponta sejam um bom lugar para os usuários continuarem explorando. Se você ainda deseja enviá-los para uma lista agregada, considere criar um link para uma categoria diretamente em sua navbox.

Pronto para Tentar? Listas Simples para Entender e Explorar o DPL[]

Duas formas para chamar o DPL: <dpl></dpl>e {{#dpl: }}. Dependendo da complexidade você pode escolher uma sobre a outra, mas nós vamos focar na versão das funções parser.

Primeiramente identifique o que você quer saber, ex: "Eu quero saber quais blogs estão atualmente categorizados como Conselho Pro". Você precisará saber o tipo de artigo que você quer (namespace blog) e como você quer filtrá-lo (categoria).

{{#dpl:
|category=Advice Pro
|namespace={{ns:500}}
}}

se torna

Digamos, você quer mostrar os 2 últimos blogs em sua página principal. Existe a função bloglist para fazer isso (Por favor use ela), mas apenas para demonstração de como o DPL funciona, nós vamos replicar a ideia.

{{#dpl:
|category=Blog posts <!-- this is the default category for blog posts -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=2
}}

se torna

Ele mostra uma lista básica com o conteúdo que você quer.

Mas tipo, você só queria que as notícias fossem exibidas, não uma fanfic do usuário, então como fazer isso? Simples - você adiciona uma segunda categoria à lista para dizer: "Quero que seja categorizado como um blog AND como uma notícia". Ou, no nosso caso, Atualizações de Produtos.

{{#dpl:
|category=Blog posts <!-- this is the default category for blog posts -->
|category=Product Updates <!-- attention: you need to make sure the case is correct! it will not work with "product updates" -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=2
}}

se torna

Engenhoso, não?

Agora que exploramos como dizer AND no DPL, que tal explorarmos como dizer OR? Por exemplo, você deseja exibir notícias OR anúncios ou, no nosso caso, blogs DEI OR outras atualizações de programas.

{{#dpl:
|category=DEI¦Program Updates <!-- either DEI OR Program updates -->
|namespace={{ns:500}} <!-- this is the blog namespace number -->
|count=4
}}

se torna

Mas espere, o que era aquele símbolo estranho ¦ agora? É aí que entram os diferentes métodos de uso da tag ou da função parser. Para dizer OR, você precisa usar uma barra vertical | - mas porque em uma função parser isso é usado para indicar um novo parâmetro, você não pode fazer isso. É por isso que você está usando algo chamado "tubo quebrado" - ¦ - que serve exatamente ao mesmo propósito, mas não está indicando um novo parâmetro para a função parser.

Essa é uma visão geral do DPL - existe muito mais a ser explorado, você pode olhar mais em nossa documentação de ajuda sobre o DPL: Ajuda:DPL3/Parâmetros:_Critérios para seleção de página

Esperamos que este conselho lhe dê uma primeira ideia de como você pode usar o DPL para aprimorar a sua wiki, a ideia geral de como ele funciona e por onde começar!