Extension:DynamicPageList (Wikimedia)/pt-br


 * This extension is used by Wikimedia, not to be confused with the DynamicPageList (third-party) extension or Extension:DynamicPageList3.

The DynamicPageList extension allows wiki users to create a list of pages that are listed in a set of categories. See m:Help:DPL for general information.

Origin
DynamicPageList é uma extensão do MediaWiki desenvolvido para o Wikinews. Ele está instalado em todas as línguas do Wikinews (veja n:Wikinews:DynamicPageList) do Meta e da Wikiversidade e pode ser instalado em qualquer wiki. Permite que os usuários da wiki criem uma lista de páginas que estão listadas em um conjunto de categorias. Veja m:Help:DPL para obter informações gerais.

Esta extensão foi anteriormente conhecida como DynamicPageList/old e mais tarde Intersection. Você também pode estar interessado em DynamicPageList (third-party), que tem mais recursos.

Configuration
The extension also supports a couple of configuration variables. Normally you wouldn't want to change the default, but if you do you can add them to your "LocalSettings.php" after the require_once line. Here is the supported configuration variables along with their default values:

Uso
DynamicPageList pode ser usado com a sintaxe XML, como no modo de edição wiki. Os parâmetros de controle para as páginas da lista, em ordem e modo de exibição. Consulte as seguintes seções para obter informações sobre cada parâmetro. Por exemplo, os seguintes são os mais velhos de cinco páginas sobre este wiki que mudaram recentemente para MediaWiki.org.

 category            = Páginas transferidas recentementes de Meta count               = 5 order               = ascending addfirstcategorydate = true 

Um exemplo de um código DynamicPageList realmente complexo:  category=exemplo count=20 namespace=ficheiro addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Galleries! ordermethod=sortkey order=ascending mode=gallery offset=12 

Lista de 12 a 34 páginas em espaço de ficheiros que também estão na categoria exemplo, formatá-los em uma galeria de imagens, com a data em que foram adicionados acategoria exemplo na legenda no ano formato de dia, mês e com as imagens que tenham uma largura de 70px.

category
 category lista as categorias para cruzar. DynamicPageList lista as páginas que são encontrados em cada uma das categorias listadas. Um número mínimo e máximo de entradas de lista é definido no código fonte da extensão. Você pode usar palavras mágicas  no nome da categoria.

A sintaxe é.

 category = Demo category = Demo 1 

notcategory
notcategory restringe as listas de páginas que não estão em uma categoria particular. Você pode usar palavras mágicas como  no nome da categoeria.

 category   = Demo notcategory = Demo 1 

namespace
namespace restringe a lista de páginas especificadas acima, para aqueles que estão em um espaço nominal particular, especificado por nome ou número (veja a lista de namespaces padrões). Qualquer nome inválido é equivalente ao namespace artigo principal.

 category = Demo namespace = Help 

redirects
redirects determina se deve ou não incluir páginas de redirecionamento. O valor pode ser exclude (padrão, não lista redirecionamentos), include (lista os redirecionamentos), ou only (não lista as páginas que não são redirecionamentos).

 category = Demo redirects = only 

stablepages
stablepages determina se deve ou não incluir-se páginas estáveis (sinalizadas) ao usar a estensão FlaggedRevs. O valor pode ser exclude (não fazer a lista), include (lista estável e não-estável. Padrão), ou only (lista apenas as páginas estáveis). Requer a instalação da extensão Flaggedrevs para funcionar.

qualitypages
qualitypages determina se deve ou não incluir a qualidade (sinalizado no nível 'prestine') quando usando páginas da estensão FlaggedRevs. O valor pode ser exclude (não fazer a lista), include (lista de qualidade e não qualidade), ou only (somente a lista de páginas de qualidade).

Nota: o comportamento do qualitypages é alterado em versões anteriores. Em versões mais antigas,  automaticamente   é definido. isso não acontece mais.

count
count restringe o número de resultados que são mostrados. Por padrão, as páginas adicionadas à categoria, mais recentemente, são mostradas (veja a ordem). Note que a extensão não está na lista de resultados mais do que o máximo definido no código-fonte de extensão.

 category = Exemplo count   = 2 

offset
offset inicia a lista de algum outro lugar, então a primeira página da lista. Por exemplo, este pode ser utilizado com count para fazer layouts de várias colunas.

 category = Exemplo offset   = 2 

Coluna exemplo

shownamespace
shownamespace displays the namespace in the page names. The value can be true (default, display in name: Help:Contents) or false (don't display in name: Contents).

 category     = Demo shownamespace = false </DynamicPageList>

addfirstcategorydate
addfirstcategorydate shows the date each article was added to category. The value can be true (display date), false (default, don't display date), or a date specifier (ymd, md, dm, dmy, mdy, and ISO 8601). If many categories are specified, it uses the first category. The linked page names are prepended with the date formatted according to your local MediaWiki date display preferences.

 category            = Demo addfirstcategorydate = true </DynamicPageList>

mode
mode determines the format of the list. The value can be:
 * unordered — bulleted list
 * ordered — numbered list
 * none — plain links with line breaks
 * gallery — image gallery, like &lt;gallery&gt;
 * inline — comma separated list

unordered:  category = Demo mode    = unordered </DynamicPageList>

ordered:  category = Demo mode    = ordered </DynamicPageList>

plain links:  category = Demo mode    = none </DynamicPageList>

inline:  category = Demo mode    = inline </DynamicPageList>

mode=gallery
Gallery is a special mode where the output is an image gallery. When using this mode, you would usually want to restrict the namespace to file.  category = Demo mode    = gallery namespace= file </DynamicPageList> Gallery mode also supports the options imagewidth (how wide the images should be in gallery, you may need to also set imageheight if using this), imageheight (how high the image should be) galleryshowfilesize (show the image size, like on category pages), galleryshowfilename (show filename like on category pages), imagesperrow (number of images per row in gallery), gallerycaption (caption for gallery).

If addfirstcategorydate is in use, the date is appended to the caption of the image.

Note, gallerycaption at the moment cannot accept links. (but it can accept things like August )

A complex gallery example might be:  count=20 namespace=file addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Look at my pretty gallery. mode=gallery </DynamicPageList>

suppresserrors
suppresserrors hides errors. The value can be true (hide errors) or false (default, show errors).

true:  category      = Dem suppresserrors = true </DynamicPageList>

false:  category      = Dem suppresserrors = false </DynamicPageList>

nofollow
nofollow sets  on the links. This prevents spiders from getting to the page through the link from the DynamicPageList. In general this is useless, as spiders will either be able to index the page from other links, or not at all due to robots.txt/$wgDefaultRobotPolicy. In general you should not use this option unless you know what you are doing, and have a good reason. The primary usecase is that on the English Wikinews, Google News considers anything linked from the main page to be an article.

 category      = Demo nofollow      = true </DynamicPageList>

googlehack
This is a hack for wikinews. Previously, Google News only considered articles with numbers in them to be news articles, so this appends ?dpl_id= to the end of the urls on the list. You shouldn't use this option unless you have a good reason to (however it won't hurt anything). This replaces the showcurid option that is no longer supported.

 category      = Demo googlehack      = true </DynamicPageList>

ordermethod
ordermethod determines the order and date to display. The value can be:
 * categoryadd — default, sort by date pages were categorised for first category
 * lastedit — sort by date pages were last edited
 * length — by article length
 * created — by article creation date
 * categorysortkey — essentially alphabetical order by the sort key of the first category
 * sortkey — alias of categorysortkey
 * popularity — by number of hits

It should be noted, that lastedit really sorts by the last time the page was touched. In some cases this is not equivalent to the last edit (for example, this includes permission changes, creation or deletion of linked pages, and alteration of contained templates). popularity is only enabled on wikis that have $wgDisableCounters set to. As such it will not work on Wikimedia wikis. If you do not specify a category, some of these order methods will not work&mdash;specifically, categoryadd and categorysortkey fallback to created if there is no  clause.

 category            = Demo addfirstcategorydate = true ordermethod         = lastedit </DynamicPageList>

alphabetical example:

 category            = Demo ordermethod         = sortkey </DynamicPageList>

order
order decides the sort direction. The value can be descending (default, most recent to oldest) or ascending (oldest to most recent).

 category = Demo order    = ascending </DynamicPageList>

Templates
To use inside a template and pass parameters, use parser functions etc., use the  function:

The template page itself will display an error message because the category value is empty on the template page unless you put the template inside  tags. Example:

Derived extensions

 * Derived extensions: DPLforum outputs in forum style. Extension:GoogleNewsSitemap is like this but outputs an RSS feed. Extension:DynamicPageList (third-party) is a modified version with more features, but also more resource-expensive. Neither of the latter is used on Wikimedia's sites.
 * Version 1.8.4 of DynamicPageList (third-party) is fully downward compatible with the extension described here. So the way is open for a re-unification of the different development paths. This is not true any more for the current versions since version 2.01 of DynamicPageList (third-party) does not support.
 * Extension:DynamicPageListEngine makes dynamic page lists available to Scribunto modules.
 * Extension:Multi-Category Search provides similar functions.