Extensão:DynamicPageList
DynamicPageList Estado da versão: estável |
|
---|---|
Implementação | Marcação , Função de análise sintática |
Descrição | Exibe uma lista com marcadores dos itens mais recentes que residem em uma categoria ou uma interseção de várias categorias. |
Autor(es) | IlyaHaykinson and Amgine |
Última versão | Continuous updates |
Política de compatibilidade |
Snapshots releases along with MediaWiki. Master is not backward compatible. |
MediaWiki | 1.23+ |
PHP | 5.4+ |
Modifica o banco de dados |
Não |
Licença | GNU GPL (Licença Pública Geral) 2.0 ou superior |
Download | |
Exemplo |
|
|
|
<DynamicPageList> |
|
Quarterly downloads | 0 |
Translate the DynamicPageList extension | |
Problemas | Tarefas em aberto · Relatar um bug |
A extensão DynamicPageList permite que os usuários do wiki criem uma lista de páginas listadas em um conjunto de categorias.
Origem
DynamicPageList é uma extensão do MediaWiki desenvolvido originalmente para o Wikinews. Ele está instalado na maioria das línguas do Wikinews (veja n:Wikinews:DynamicPageList), Meta, MediaWiki.org, e alguns outros projetos menores. It will not be installed on any more Wikimedia wikis due to performance issues.
Esta extensão foi anteriormente conhecida como DynamicPageList/old e mais tarde Intersection. Você também pode estar interessado em DynamicPageList3 , que tem mais recursos.
Instalação
Instalação
- Baixe e coloque o(s) arquivo(s) num diretório chamado
intersection
na sua pastaextensions/
.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/intersection - Adicione o seguinte código ao final do seu arquivo LocalSettings.php :
wfLoadExtension( 'intersection' );
- Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.
Configuração
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:
# Configuration variables. Warning: These use DLP instead of DPL
# for historical reasons (pretend Dynamic list of pages)
$wgDLPmaxCategories = 6; // Maximum number of categories to look for
$wgDLPMaxResultCount = 200; // Maximum number of results to allow
$wgDLPAllowUnlimitedResults = false; // Allow unlimited results
$wgDLPAllowUnlimitedCategories = false; // Allow unlimited categories
// How long to cache pages using DPL's in seconds. Default to 1 day. Set to
// false to use the normal amount of page caching (most efficient), Set to 0 to disable
// cache altogether (inefficient, but results will never be outdated)
$wgDLPMaxCacheTime = 60*60*24; // How long to cache pages in seconds
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.
<DynamicPageList> category = Pages recently transferred from Meta count = 5 order = ascending addfirstcategorydate = true </DynamicPageList>
Um exemplo de um código DynamicPageList realmente complexo:
<DynamicPageList> category=foo count=20 namespace=file addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Galleries! ordermethod=sortkey order=ascending mode=gallery offset=12 </DynamicPageList>
Lista de 12 a 31 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.
Seleção de páginas
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 {{CURRENTMONTHNAME}} no nome da categoria.
A sintaxe é category = nome da categoria
.
<DynamicPageList> category = Demo category = Demo 1 </DynamicPageList>
notcategory
notcategory restringe as listas de páginas que não estão em uma categoria particular. Você pode usar palavras mágicas como {{CURRENTMONTHNAME}} no nome da categoeria.
<DynamicPageList> category = Demo notcategory = Demo 1 </DynamicPageList>
namespace
namespace restringe a lista de páginas especificadas acima, para aqueles que estão em um espaço nominal especificado, que pode ser especificado pelo nome ou número (veja a lista de domínios padrões). Qualquer nome inválido é equivalente ao domínio principal.
<DynamicPageList> category = Demo namespace = Help </DynamicPageList>
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).
<DynamicPageList> category = Demo redirects = only </DynamicPageList>
stablepages
stablepages determina se deve ou não inclui páginas estáveis (sinalizadas) ao usar a Extension:FlaggedRevisions . 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.
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.
<DynamicPageList> category = Demo count = 2 </DynamicPageList>
offset
offset inicia a lista de algum outro lugar além da primeira página da lista. Por exemplo, este pode ser utilizado com count para fazer layouts de várias colunas.
<DynamicPageList> category = Demo offset = 2 </DynamicPageList>
Coluna exemplo
<table> <tr><th colspan="3"> recent articles in [[:category:Demo|:category:Demo]]</th></tr> <tr><td> <DynamicPageList> category = Demo count=5 </DynamicPageList> </td> <td> <DynamicPageList> category = Demo offset = 5 count= 5 </DynamicPageList> </td> <td> <DynamicPageList> category = Demo offset = 10 count=5 </DynamicPageList> </td></tr></table>
Detalhes exibido
shownamespace
shownamespace exibe o espaço nominal no nome da página.
The value can be true
(default, display in name: Help:Contents ) or false
(don't display in name: Contents ).
<DynamicPageList> category = Demo shownamespace = false </DynamicPageList>
addfirstcategorydate
addfirstcategorydate mostra a data em que cada artigo foi adicionado à categoria. O valor pode ser true (mostra a data), false (padrão, não apresenta a data), ou um especificador de data (ymd, md, dm, dmy, mdy, e ISO 8601). Se muitas categorias são especificadas, ele usa a primeira categoria. Os nomes ligados a página são precedidos com a data formatada de acordo com suas preferências de exibição local de data do MediaWiki.
<DynamicPageList> category = Demo addfirstcategorydate = true </DynamicPageList>
mode
mode determina o formato da lista. O valor pode ser:
- unordered — bulleted list
- ordered — numbered list
- none — plain links with line breaks
- gallery — image gallery, like
<gallery>
- inline — comma separated list
unordered: <DynamicPageList> category = Demo mode = unordered </DynamicPageList> ordered: <DynamicPageList> category = Demo mode = ordered </DynamicPageList> Texto simples: <DynamicPageList> category = Demo mode = none </DynamicPageList> inline (nota: isto não está já ativo em wikis wmf): <DynamicPageList> category = Demo mode = inline </DynamicPageList>
mode=gallery
Galeria é um modo especial em que a saída é uma galeria de imagens. Se Extension:PageImages estiver instalado, então a imagem da página, se existir, será usada para páginas que não sejam de arquivo. Caso contrário, as páginas de domínios que não sejam de Arquivo serão apenas um espaço em branco.
<DynamicPageList> category = Demo mode = gallery namespace= file </DynamicPageList>
mode gallery suporta também as opções imagewidth (a largura das imagens da galeria, você pode precisar também definir imageheight se usar isto), imageheight (como deve ser a altura das imagem) galleryshowfilesize (mostra o tamanho das imagens, como nas categorias de páginas), galleryshowfilename (mostra o nome do arquivo como nas categorias de páginas), imagesperrow (número de imagens por linha na galeria), gallerycaption (legenda na galeria).
Se addfirstcategorydate está em uso, a data é acrescentada a legenda da imagem.
Nota: gallerycaption no momento não pode aceitar ligações (mas pode aceitar as coisas como {{CURRENTMONTHNAME}}
).
Um exemplo complexo de gallery pode ser:
<DynamicPageList> count=20 namespace=file addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Look at my pretty gallery. mode=gallery shownamespace=false </DynamicPageList>
suppresserrors
suppresserrors hides errors. The value can be true (hide errors) or false (default, show errors).
true: <DynamicPageList> category = Dem suppresserrors = true </DynamicPageList> false: <DynamicPageList> category = Dem suppresserrors = false </DynamicPageList>
nofollow
nofollow acresenta rel="nofollow"
sobre as ligações.
Isso impede que aranhas de chegarem até a página através do link do DynamicPageList.
Em geral, isso é inútil, aranhas serão capazes de indexar a página de outras ligações, ou fazer nada para robots.txt/$wgDefaultRobotPolicy . Em geral, você não deve usar esta opção a menos que você saiba o que está fazendo, e ter uma boa razão.
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.
<DynamicPageList> category = Demo nofollow = true </DynamicPageList>
googlehack
Este é um hack para o Wikinotícias. Notícias do Google consideram apenas artigos com números que sejam notícias, isto acontece colocando ?dpl_id=<id of article> ao final das URLs na lista. Você não deve usar esta opção a menos que você tenha uma boa razão (no entanto, não vai doer nada). Isto substitui a opção showcurid que já não é suportado.
<DynamicPageList> category = Demo googlehack = true </DynamicPageList>
Order
ordermethod
ordermethod determina a ordem e a data que vai mostrar. O valor pode ser categoryadd (padrão, classificar por data as páginas que foram classificadas para a categoria em primeiro lugar) ou lastedit (classifica as páginas pela data da última edição feita), length (pelo comprimento do artigo), created (data da criação do artigo), categorysortkey (essencialmente alfabética. Ordenar pela chave de classificação da primeira categoria. Sortkey é um apelido), popularity (pelo número de acessos).
- categoryadd — padrão, classifica por data as páginas foram categorizadas por primeiro na categoria
- 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
Nota-se que realmente lastedit classifica pela última vez que a página foi editada. Em alguns casos, isso não é equivalente à última edição (por exemplo, o que inclui alterações de permissão, criação ou supressão de páginas com links, e alteração constante de predefinições). Se você não especificar uma categoria, alguns desses métodos não funcionarão especificadamente, categoryadd e categorysortkey retorna para created se não houver a cláusula category.
<DynamicPageList> category = Demo addfirstcategorydate = true ordermethod = lastedit </DynamicPageList>
Exemplo por ordem alfabética:
<DynamicPageList> category = Demo ordermethod = sortkey </DynamicPageList>
order
order determina a direção da classificação. The value can be descending (default, most recent to oldest) or ascending (oldest to most recent).
<DynamicPageList> category = Demo order = ascending </DynamicPageList>
Predefinições
To use inside a template and pass parameters, use parser functions etc., use the {{#tag:
function:
{{#tag:DynamicPageList| category = {{{1}}} count = {{#if: {{{2|}}} | 10 | 20 }} ordermethod = sortkey order = ascending }}
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 <includeonly>
tags. Example:
Erro: É necessário incluir no mínimo uma categoria ou especificar um espaço nominal!
Extensões derivadas
- Derived extensions: DPLforum outputs in forum style. Extension:GoogleNewsSitemap is like this but outputs an RSS feed. DynamicPageList3 is a modified version with more features, but also more resource-expensive. It is not used on Wikimedia's sites.
- Extension:DynamicPageListEngine - makes dynamic page lists available to Scribunto modules.
Esta extensão está sendo usada(o) por um ou mais projetos da Wikimedia. Isto significa que, provavelmente, a extensão é estável e funciona bem o suficiente para ser utilizada(o) em sites da web de alto tráfego. Procure pelo nome dessa extensão nos arquivos de configuração CommonSettings.php e InitialiseSettings.php da Wikimedia para verificar onde ela foi instalada. Uma lista completa das extensões instaladas numa wiki em particular podem ser visualizadas na página Special:Version da wiki. |
Esta extensão está incluída nas seguintes fazendas/hospedagens (farms/hosts) e/ou pacotes wiki: Esta não é uma lista autoritativa (oficial). Algumas fazendas/hospedagens (farms/hosts) e/ou pacotes wiki podem conter esta extensão mesmo que não estejam listados aqui. Sempre verifique com suas fazendas/hospedagens (farms/hosts) ou pacotes wiki para confirmar. |
- Stable extensions/pt-br
- Tag extensions/pt-br
- Parser function extensions/pt-br
- GPL licensed extensions/pt-br
- Extensions in Wikimedia version control/pt-br
- ParserFirstCallInit extensions/pt-br
- All extensions/pt-br
- Extensions used on Wikimedia/pt-br
- Extensions included in Miraheze/pt-br
- Extensions included in WikiForge/pt-br
- Page content extensions/pt-br
- Category intersection extensions/pt-br