Extensão:DynamicPageList3
DynamicPageList3 Estado da versão: estável |
|
---|---|
Implementação | Marcação , Função de análise sintática |
Descrição | Criar listas de outros artigos com base em sua categoria, namespace, título, referências ou uso de predefinição e incluir conteúdo ou argumentos de chamadas de modelo desses artigos em sua página. |
Autor(es) | Universal Omega, Alexia E. Smith, Algorithmix, Dangerville, IlyaHaykinson, Theaitetos, Unendlich~dewiki |
Última versão | 3.5.2 (2023-01-14) |
MediaWiki | 1.39.0+ |
Modifica o banco de dados |
Sim |
Composer | universal-omega/dynamic-page-list3 |
Licença | GNU GPL (Licença Pública Geral) 3.0 ou superior |
Download | |
Exemplo | DynamicPageList3 Manual |
|
|
|
|
Translate the DynamicPageList3 extension | |
A extensão DynamicPageList3 é uma ferramenta de relatório para MediaWiki, listando membros da categoria e interseções com vários formatos e detalhes. Para obter a documentação completa, consulte o [[1]].
Quando chamado com um conjunto básico de parâmetros de seleção, o DPL exibe uma lista de páginas em uma ou mais categorias. As seleções também podem ser baseadas em fatores como autor, namespace, data, padrão de nome, uso de modelos ou referências a outros artigos. A saída assume uma variedade de formas, algumas das quais incorporam elementos de artigos selecionados.
Esta extensão é chamada com a função do analisador {{#dpl: .... }}
ou a tag do analisador <DPL>
.
Uma implementação compatível com a Wikimedia de certos recursos pode ser chamada com <DynamicPageList>
.
Pesquisas complexas podem resultar em consultas de banco de dados caras do ponto de vista computacional. No entanto, por padrão, todas as saídas são armazenadas em cache por um período de uma hora para reduzir a necessidade de executar novamente a consulta a cada carregamento de página. A página de manual [Parâmetros: Outros Parâmetros] contém informações sobre os parâmetros que podem ser usados para desabilitar o cache e permitir atualizações instantâneas.
- Manual and Complete Documentation
- [na Gamepedia Help Wiki]
- Código Fonte
- Source code
- Bugs e Solicitações de Recursos no GitHub
- Issue and request tracker
Instalação
- Baixar e coloque o(s) arquivo(s) num diretório chamado
DynamicPageList3
na sua pastaextensions/
. - Adicione o seguinte código ao final do seu arquivo LocalSettings.php :
wfLoadExtension( 'DynamicPageList3' );
- Se necessário, configure conforme necessário.
- Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.
Configuração
These are DPL3's configuration settings, along with their default values.
To change them, ensure they are defined before including the extension on the wiki.
$dplSettings
to $wgDplSettings
. This was to facilitate compatibility with MediaWiki 1.25's extension registration change.Configuração | Padrão | Descrição |
---|---|---|
$wgDplSettings['allowedNamespaces']
|
null
|
By default, all existing namespaces are used when DPL3 initializes. Customize this setting with an array of namespace constants to restrict DPL3 to work only in those namespaces. |
$wgDplSettings['allowUnlimitedCategories']
|
false
|
Set this to true to ignore 'maxCategoryCount' and allow unlimited categories. Please note that large amounts of categories in a query can slow down or crash servers.
|
$wgDplSettings['allowUnlimitedResults']
|
false
|
Set this to true to ignore 'maxResultCount' and allow unlimited results. Please note that large result sets may result in slow or failed page loads.
|
$wgDplSettings['alwaysCacheResults']
|
false
|
Set this to true to ignore 'allowcachedresults' and always enable the parser cache.
|
$wgDplSettings['categoryStyleListCutoff']
|
6
|
Maximum number of items in a category list before being cut off. |
$wgDplSettings['functionalRichness']
|
3
|
Set the level of parameters available to end users. |
$wgDplSettings['maxCategoryCount']
|
4
|
Maximum number of categories to allow in queries. |
$wgDplSettings['minCategoryCount']
|
0
|
Minimum number of categories to allow in queries. |
$wgDplSettings['maxResultCount']
|
500
|
Maximum number of results to return from a query. |
$wgDplSettings['recursiveTagParse']
|
false
|
Do recursive tag parsing on <dpl> parser tags converting tags and functions such as magic words like {{PAGENAME}} . This is similar to the {{#dpl}} parser function call, but may not work the same in all cases.
|
$wgDplSettings['runFromProtectedPagesOnly']
|
false
|
Set this to true to allow DPL3 to run from protected pages only. This is recommended if wiki administrators are having issues with malicious users creating computationally intensive queries.
|
$wgDplSettings['handleSectionTag']
|
false
|
Set this to true to have DPL3 handle <section> tags outside of DPL parser tags.
|
$wgDplSettings['maxQueryTime']
|
10000
|
Maximum allowed time for database queries in milliseconds. |
$wgDplSettings['queryCacheTime']
|
0
|
Configure query cache time. The query cache cannot be purged. Suggested value between 30 to 600. |
The global variable $wgNonincludableNamespaces is automatically respected by DynamicPageList3.
It will prevent the contents of the listed namespaces from appearing in DynamicPageList3's output.
$wgDplSettings['maxResultCount']
is a LIMIT on the SQL query itself. Some DynamicPageList3 query parameters like includematch
are applied after the SQL query, however, so results here may easily be misleading.
Riqueza Funcional
DynamicPageList3 has many features unlocked based on the maximum functional richness level.
Some can cause high CPU or database load and should be used sparingly.
$wgDplSettings['functionalRichness'] = 0
- equivalent to Wikimedia's DynamicPageList (Intersection)$wgDplSettings['functionalRichness'] = 1
- adds additional formatting parameters$wgDplSettings['functionalRichness'] = 2
- adds performance equivalent features for templates and pagelinks$wgDplSettings['functionalRichness'] = 3
- allows more-expensive page inclusion features and regular expression queries$wgDplSettings['functionalRichness'] = 4
- permits exotic and potentially dangerous batch update and delete operations; not recommended for public websites. Includes debugging parameters for testing and development.
Uso
Funcionalidade DPL Estendida
Extended dynamic page lists are invoked by using the parser function {{#dpl: .... }}
, or the parser extension tag <DPL>...</DPL>
.
Compatibilidade com versões anteriores
Functionality compatible with Wikimedia's DynamicPageList extension can be invoked with <DynamicPageList>...</DynamicPageList>
.
Further information can be found on the Compatibility manual page.
Filosofia de uso e visão geral
With the assumption there are some articles written about countries those articles will typically have three things in common:
- They will belong to a common category
- They will have a similar chapter structure, i.e., they will contain paragraphs named 'Religion' or 'History'
- They will use a template which is used to present highly structured short data items ('Capital', 'Inhabitants', ..) nicely (e.g., as a wikitable)
Generate a report based on countries
If there was a need to assemble a report of what countries practice a certain religion, this could be easily done with the category
and linksto
parameters.
{{#dpl:
category=countries
|linksto=Pastafarianism
}}
With DynamicPageList3, one could:
- Generate a list of all those articles (or a random sample)
- Show metadata of the articles (popularity, date of last update, ..)
- Show one or more chapters of the articles ('transclude' content)
- Show parameter values which are passed to the common template
- Order articles appropriately
- Present the result in a sortable table
- Generate multiple column output
Quais etapas são necessárias?
Find the articles you want to list:
- Select by a logical combination (AND, OR, NOT) of categories
- Specify a range for the number of categories the article must be assigned to
- Select by a logical combination (AND, OR, NOT) of namespaces
- Define a pattern which must match the article's name
- Name a page to which the article must or must not link
- Name a template which the article must or must not use
- Name a text pattern that must occur within external links from a page
- Exclude or include redirections
- Restrict your search to stable pages or quality pages ("flagged revisions")
- Use other criteria for selection like the author, date of last change, etc.
- Define regular expressions to match the contents of pages you want to include
Order the result list of articles according to
- Article name
- Article size
- Date of last change
- Last user to make an edit
Define attributes you want to see
- Article name
- Article namespace
- Article size
- Date of last change
- Date of last access
- Last user to make an edit
Define contents you want to show
- Whole article
- Contents of certain sections (identified by headings)
- Text portions (defined by special marker tags in the article)
- Values of template calls
- Use a custom template to show output
Define the output format
- Specify header and footer for the default output
- Use ordered list, unordered list
- Use tables
- Format table fields individually by applying templates to their content
- Use category style listing
Truncate title or contents to a certain maximum length
- Add a link to the article or one or more of its sections
Considerações
Desempenho
DPL3's code execution and database access are typically fast for category and article lookups.
However, using loose LIKE and REGEXP match parameters and/or requesting large data sets can result in long database access times.
Parser time should also be taken into consideration.
For example, having the query of image results go into a template that displays them will result in a parser media transform for each one.
This can quickly eat up 2MBs of RAM per media transform.
Version 3.4.0 introduces two new configuration options, $wgDplSettings['maxQueryTime']
, which allows configuration of the max execution length for queries, in milliseconds, and $wgDplSettings['queryCacheTime']
, which allows configuration of the query cache. It also supports PoolCounter to limit query concurrency.
Ver também
Leitura adicional
DynamicPageList3 can do much more than we can explain here.
A complete manual is available with full parameter documentation.
- Manual:Managing data in MediaWiki – An overview and comparison.
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. |