View source for Manual:Developing extensions/pt-br

<languages/>
{{ExtensionTypes}}
{{mbox| text = Se você planeja ter sua extensão implementada nos sites da Wikimedia, leia {{ll|Writing an extension for deployment}} (em inglês).}}
[[File:MediaWiki-extensions-icon.svg|125px|alt=Extensões do MediaWiki|{{dir|{{pagelang}}|left|right}}]]

A cada [[Special:MyLanguage/Manual:Extensions|extensão]] consta de três partes:

# [[#Setup|Configuração]]
# [[#Execution|Execução]]
# [[#Localisation|Localização]]

<div class="mw-translate-fuzzy">
Uma mera extensão consiste de três arquivos, um para cada parte:
</div>

; ''MyExtension''/extension.json
: Armazena as instruções de [[#Setup|configuração]]. O nome do arquivo deve ser “extension.json” (Nas versões anteriores ao MediaWiki 1.25, as instruções de configuração ficavam num arquivo <code>''MyExtension''/''MyExtension''.php</code>, nomeado de acordo com a extensão. Várias extensões ainda são compatíveis com aquelas versões neste arquivo PHP).
; ''MyExtension''/includes/ (or ''MyExtension''/src/)
: <span class="mw-translate-fuzzy">Armazena o código para a [[#Execution|execução]] da extensão.</span>
; ''MyExtension''/resources/ (or ''MyExtension''/modules/)
: <span lang="en" dir="ltr" class="mw-content-ltr">Stores the client-side resources such as JavaScript, CSS and LESS for the extension.</span>
; ''MyExtension''/i18n/*.json
: Armazena as informações de [[#Localisation|localização]] da extensão.

<span class="mw-translate-fuzzy">Ao desenvolver uma extensão, substitua “MyExtension” (como encontrado acima) pelo nome da sua extensão.</span>
Use nomes em UpperCamelCase no diretório e no(s) arquivo(s) PHP; essa é a convenção geral para [[Special:MyLanguage/Manual:Coding conventions#File naming|nomes de arquivos]]<ref>[[mailarchive:wikitech-l/2011-August/054839.html]]</ref>
(A {{git repo|project=mediawiki/extensions/BoilerPlate|text=BoilerPlate extension}} é um bom ponto de partida para a sua extensão.)

{{Note|1=Enquanto estiver programando, recomendamos que você desative o cache com as configurações <code>{{ll|Manual:$wgMainCacheType|$wgMainCacheType}} = CACHE_NONE</code> e <code class=mw-highlight>{{ll|Manual:$wgCacheDirectory|$wgCacheDirectory}} = {{#tag:span|false|class=k}}</code>, ou você poderá não obter mensagens do sistema ou outras mudanças.}}

__TOC__

<span id="Setup"></span>
== Configuração ==

<div class="mw-translate-fuzzy">
Seu objetivo ao escrever a parte da instalação é tornar a instalação da extensão o mais fácil possível, para que os usuários só precisem adicionar essa linha ao LocalSettings.php:
</div>

<syntaxhighlight lang="php">
wfLoadExtension( 'MyExtension' );
</syntaxhighlight>

Se você deseja fazer com que sua extensão seja configurável pelo usuário, defina e documente alguns parâmetros de configuração. A configuração deve estar desta maneira:

<syntaxhighlight lang="php">
wfLoadExtension( 'MyExtension' );
$wgMyExtensionConfigThis = 1;
$wgMyExtensionConfigThat = false;
</syntaxhighlight>

Para alcançar essa simplicidade, seu arquivo de configuração deve efetuar várias tarefas (descritas detalhadamente nas seguintes seções):

* registrar qualquer [[Special:MyLanguage/Manual:Parser functions|manipulador de mídia]], [[Special:MyLanguage/Manual:Parser functions|função ao analisador sintático]], [[Special:MyLanguage/Manual:Special pages|página especial]], [[Special:MyLanguage/Manual:Tag extensions|marcação personalizada de XML]] e/ou [[Special:MyLanguage/Manual:Variable|viariável]] que sua extensão usar;
* definir e/ou validar quaisquer variáveis de configuração definidos por você para a sua extensão;
* preparar as classes usadas pela sua extensão para carregamento automático;
* determinar quais partes da sua configuração devem ser feitas imediatamente e quais precisam estar em modo de espera até o núcleo do MediaWiki ter sido inicializado e configurado;
* definir [[Special:MyLanguage/Manual:Hooks|''hooks'']] adicionais necessários pela sua extensão;
* criar ou verificar tabelas de banco de dados requeridas pela sua extensão; e
* configurar a localização para a sua extensão.

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">Good practice is to add a README file with basic info about how to install and configure the extension.</span> <span lang="en" dir="ltr" class="mw-content-ltr">You can use either plain text or [https://secure.phabricator.com/book/phabricator/article/remarkup/ Phabricator markup syntax].</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, see the [https://phabricator.wikimedia.org/diffusion/EPFM Phabricator Diffusion page] for the {{ll|Extension:Page Forms}}.</span> <span lang="en" dir="ltr" class="mw-content-ltr">If markdown is used, add the file extension <code>.md</code>.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, see the <code>README.md</code> file for {{ll|Parsoid}} on [https://phabricator.wikimedia.org/diffusion/GPAR Phabricator Diffusion].</span>}}

<span id="Registering_features_with_MediaWiki"></span>
===Registrando recursos com o MediaWiki===
O MediaWiki lista todas as extensões instaladas na página <code>Special:Version</code>.
Por exemplo, é possível ver todas as extensões instaladas nesta wiki na página [[Special:Version]].

{{MW 1.25|and after}}
<span lang="en" dir="ltr" class="mw-content-ltr">To do this, add the extension details to ''{{ll|extension.json|extension.json}}''.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The entry will look something like this:</span>

<syntaxhighlight lang="json">
{
	"name": "Example",
	"author": "John Doe",
	"url": "https://www.mediawiki.org/wiki/Extension:Example",
	"description": "This extension is an example and performs no discernible function",
	"version": "1.5",
	"license-name": "GPL-2.0-or-later",
	"type": "validextensionclass",
	"manifest_version": 1
}
</syntaxhighlight>


Muitos deles são opcionais, mas preenchê-los por completo é uma boa prática.
<code>manifest_version</code> refere-se à versão do esquema usado pelo arquivo {{ll|extension.json|extension.json}}.
A partir de agora (janeiro de 2018) as versões disponíveis são 1 e 2. Ver [[Special:MyLanguage/Manual:Extension.json/Schema#manifest version|aqui para a documentação sobre este recurso]].
<span lang="en" dir="ltr" class="mw-content-ltr">Unless you need to support an older version of MediaWiki, pick the latest version.</span>

Além do registro acima, você também deve fazer um “''hook''” do seu recurso com o MediaWiki.
O texto acima apenas configura a página Special:Version.
A maneira com a qual você fará isso depende do [[#Extension types|tipo da sua extensão]].
Para mais detalhes, veja a documentação para cada tipo de extensão:
{{ExtensionTypes}}

<span id="Making_your_extension_user_configurable"></span>
===Tornando a extensão configurável pelos usuários===
Caso queira que os usuários possam configurar sua extensão, será necessário fornecer uma ou mais variáveis de configuração.
É uma boa ideia dar um nome único para cada variável.
Também devem ser seguidas as [[Special:MyLanguage/Manual:Coding conventions/PHP#Naming|convenções para nomes]] do MediaWiki (ex.: variáveis globais devem começar com $wg).

<span class="mw-translate-fuzzy">Por exemplo, se sua extensão se chamar “Extensãozinha que não faz nada de mais”, tente nomear todas as suas variáveis de configuração para começarem com $Eqnfndm ou $EQNFNDM.</span>
<span class="mw-translate-fuzzy">As suas escolhas não importam desde que '''nenhuma''' extensão do núcleo do MediaWiki comece as variáveis dessa maneira e que você tenha feito um bom trabalho em verificar se nenhuma das extensões publicadas começam as variáveis dessa maneira.</span>
Os usuários não ficarão tão felizes em ter de escolher entre a sua e outras extensões pelo fato de você ter usado os mesmos nomes que as outras.

Uma outra boa ideia é incluir uma documentação completa de quaisquer variáveis de configuração nas suas notas de instalação.

Aqui há um exemplo da extensão BoilerPlate que pode ser usado como ponto de partida:

<syntaxhighlight lang="json">
{
	"name": "BoilerPlate",
	"version": "0.0.0",
	"author": [
		"Your Name"
	],
	"url": "https://www.mediawiki.org/wiki/Extension:BoilerPlate",
	"descriptionmsg": "boilerplate-desc",
	"license-name": "GPL-2.0-or-later",
	"type": "other",
	"AutoloadClasses": {
		"BoilerPlateHooks": "includes/BoilerPlateHooks.php",
		"SpecialHelloWorld": "includes/SpecialHelloWorld.php"
	},
	"config": {
		"BoilerPlateEnableFoo": {
			"value": true,
			"description": "Enables the foo functionality"
		}
	},
	"callback": "BoilerPlateHooks::onExtensionLoad",
	"ExtensionMessagesFiles": {
		"BoilerPlateAlias": "BoilerPlate.i18n.alias.php"
	},
	"Hooks": {
		"NameOfHook": "BoilerPlateHooks::onNameOfHook"
	},
	"MessagesDirs": {
		"BoilerPlate": [
			"i18n"
		]
	},
	"ResourceModules": {
		"ext.boilerPlate.foo": {
			"scripts": [
				"resources/ext.boilerPlate.js",
				"resources/ext.boilerPlate.foo.js"
			],
			"styles": [
				"resources/ext.boilerPlate.foo.css"
			]
		}
	},
	"ResourceFileModulePaths": {
		"localBasePath": "",
		"remoteExtPath": "BoilerPlate"
	},
	"SpecialPages": {
		"HelloWorld": "SpecialHelloWorld"
	},
	"manifest_version": 2
}
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">Note that after calling {{phpi|wfLoadExtension( 'BoilerPlate' );}} the global variable <code>$wgBoilerPlateEnableFoo</code> does not exist.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If you set the variable, e.g. in <code>LocalSettings.php</code> then the default value given in extension.json will not be used.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
For more details on how to use global variable inside custom extensions, please refer to {{ll|Manual:Configuration for developers}}.
</div>

<span id="Preparing_classes_for_autoloading"></span>
===Preparando classes para carregamento automático===
Caso escolha ter de usar classes para implementar sua extensão, o MediaWiki fornece um mecanismo simplificado para auxiliar o PHP em encontrar o arquivo-fonte onde sua classe está localizada.
Na maioria dos casos, isso deverá eliminar a necessidade de escrever seu próprio método <code>__autoload($classname)</code>.

Para usar o mecanismo de carregamento automático do MediaWiki, adicione algo ao campo {{ll|Manual:$wgAutoloadClasses|AutoloadClasses}}.
A chave para cada adição é o nome da classe; o valor é o arquivo armazenador da definição da classe.
<span class="mw-translate-fuzzy">Para uma extensão de uma só classe, a classe tem geralmente o mesmo nome que a extensão. Dessa maneira, sua seção de carregamento automático deve parecer assim (nesse exemplo, a extensão se chama “MyExtension”):</span>

<syntaxhighlight lang="json">
{
	"AutoloadClasses": {
		"MyExtension": "includes/MyExtension.php"
	}
}
</syntaxhighlight>

O nome do arquivo é relativo ao diretório onde se encontra o arquivo extension.json.

<span lang="en" dir="ltr" class="mw-content-ltr">For more complex extensions, [https://php.net/language.namespaces namespaces] should be considered.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">See [[Special:MyLanguage/Manual:Extension.json/Schema#AutoloadNamespaces|Manual:Extension.json/Schema#AutoloadNamespaces]] for details.</span>

<span id="Defining_additional_hooks"></span>
===Definindo ''hooks'' adicionais===

Veja {{ll|Manual:Hooks}} (em inglês).

<span id="Adding_database_tables"></span>
===Adicionando tabelas de bancos de dados===
<span lang="en" dir="ltr" class="mw-content-ltr">Make sure the extension doesn't modify the core database tables.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Instead, extension should create new tables with foreign keys to the relevant MW tables.</span>  
{{Warning|1=Se sua extensão for usada em alguma wiki mantida pela WMF, siga o [https://wikitech.wikimedia.org/wiki/Schema_changes Guia de mudança de esquema] (em inglês).}}

Se sua extensão precisar adicionar suas próprias tabelas de bancos de dados, use o ''hook'' {{ll|Manual:Hooks/LoadExtensionSchemaUpdates|LoadExtensionSchemaUpdates}}.
Veja a página do manual para mais informações de uso.

<span id="Set_up_localisation"></span>
===Configurando a localização===

Veja:
* [[#Localisation|Localização (resumo)]]
* {{ll|Localisation|2=Localização (em detalhe)}}
* {{ll|Manual:Language#Namespaces|2=<span lang="en" dir="ltr" class="mw-content-ltr">Namespaces</span>}}

<span id="Add_logs"></span>
===Adicionando registros===
No MediaWiki, todas as ações dos usuários numa wiki são rastreadas para transparência e colaboração.
Veja {{ll|Manual:Logging to Special:Log}} (em inglês) para adicionar registros.

<div lang="en" dir="ltr" class="mw-content-ltr">
== Handling dependencies ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Assume that an extension requires the presence of another extension, for example because functionalities or database tables are to be used and error messages are to be avoided in case of non-existence.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For example the extension {{ll|Extension:CountingMarker|CountingMarker}} requires the presence of the extension {{ll|Extension:HitCounters|HitCounters}} for certain functions.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
One way to specify this would be by using the <code>[[Special:MyLanguage/Manual:Extension.json/Schema#requires|requires]]</code> key in [[Special:MyLanguage/Manual:Extension.json|extension.json]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Another option is using ExtensionRegistry (available since MW 1.25):
</div>

<syntaxhighlight lang="php">
	if ( ExtensionRegistry::getInstance()->isLoaded( 'HitCounters', '>=1.1' ) {
		/* do some extra stuff, if extension HitCounters is present in version 1.1 and above */
	}
</syntaxhighlight>

Currently (as of February 2024, MediaWiki 1.41.0) the name of the extension-to-be-checked needs to exactly match the name in their extension.json.<ref>https://www.mediawiki.org/wiki/Topic:Xyjw7nhfzaas5r5z</ref><ref>https://phabricator.wikimedia.org/T356596</ref>

Example: if you want to check the load status of extension "OpenIDConnect", you have to use it with a ''space''

<syntaxhighlight lang="php">
	if ( ExtensionRegistry::getInstance()->isLoaded( 'OpenID Connect' ) {
    ...
	}
</syntaxhighlight>

<span id="Localisation"></span>
== Localização ==
{{mbox
| type = notice
| text =  <nowiki/>
* {{ll|Localisation|Localisation}} – discute o motor de localização do MediaWiki. Em particular, há uma lista de recursos que podem ser localizados e também uma análise das classes do código-fonte do MediaWiki envolvidas na localização.
* {{ll|Help:System message#Adding new messages|2=Criando novas mensagens}}
* {{ll|Localization checks}} – discute problemas comuns em mensagens localizadas
}}

{{Note|1=Enquanto estiver desenvolvendo, experimente desativar o cache com as configurações {{phpi|$wgMainCacheType {{=}} CACHE_NONE}} e {{phpi|$wgCacheDirectory {{=}} false}}, caso contrário suas mudanças nas mensagens do sistema poderão não ser exibidas.}}

Se você deseja que sua extensão seja usada em wikis com leitores multilíngues, será necessário adicionar compatibilidade a localizações na sua extensão.

<span id="Store_messages_in_&lt;language-key&gt;.json"></span>
=== Armazenando mensagens em ''<chave-idioma>''.json ===
Armazene as definições de mensagens em arquivos de localização JSON, um para cada chave de idioma em que sua extensão será traduzida.
As mensagens serão salvas com uma chave de mensagem e a mensagem, usando o formato padrão JSON.
Todo id de mensagem deve estar em letras minúsculas e '''sem''' espaços.
<span lang="en" dir="ltr" class="mw-content-ltr">Each key should begin with the lowercased extension name.</span>
<span class="mw-translate-fuzzy">Um exemplo pode ser encontrado na extensão [https://github.com/wikimedia/mediawiki-extensions-MobileFrontend/blob/master/i18n/de.json MobileFrontend].</span>
Aqui está um exemplo de um arquivo JSON mínimo (neste caso, ''en.json''):

''en.json''

<syntaxhighlight lang="json">{
	"myextension-desc": "Adds the MyExtension great functionality.",
	"myextension-action-message": "This is a test message"
}</syntaxhighlight>

<span id="Store_message_documentation_in_qqq.json"></span>
=== Armazenando a documentação das mensagens em ''qqq''.json ===
A documentação das chaves das mensagens pode ser armazenada num arquivo JSON com o código '''qqq'''.
Uma documentação do exemplo acima pode ser:

''qqq.json'':

<syntaxhighlight lang="json">{
	"myextension-desc": "The description of MyExtension used in Extension credits.",
	"myextension-action-message": "Adds 'message' after 'action' triggered by user."
}
</syntaxhighlight>

<span id="Load_the_localisation_file"></span>
=== Carregando o arquivo de localização ===

<div class="mw-translate-fuzzy">
Na sua rotina de configuração, defina a localização dos seus arquivos de mensagem; ex. no diretório '''i18n/''':
</div>

<syntaxhighlight lang="json">
{
	"MessagesDirs": {
		"MyExtension": [
			"i18n"
		]
	}
}
</syntaxhighlight>

<span id="Use_wfMessage_in_PHP"></span>
=== Usando wfMessage no PHP ===
No seu código de configuração e implementação, substitua todo uso da mensagem com uma chamada para <code>wfMessage( $msgID, $param1, $param2, ... )</code>.
Em classes que implementam a {{ll|Manual:RequestContext#IContextSource|IContextSource}} (assim como algumas subclasses das páginas especiais, por exemplo), pode-se usar {{phpi|$this->msg( $msgID, $param1, $param2, ... )}}.
Exemplo:

<syntaxhighlight lang="php">
wfMessage( 'myextension-addition', '1', '2', '3' )->parse()
</syntaxhighlight>

<span id="Use_mw.message_in_JavaScript"></span>
=== Usando mw.message no JavaScript ===
Também é possível usar funções de i18n no JavaScript.
Veja {{ll|Manual:Messages API}} (em inglês) para mais detalhes.

{{anchor|Execution}}
<span id="Extension_types"></span>
=== Tipos de extensões ===

{{ExtensionTypes}}
Extensões podem ser categorizadas baseando-se nas técnicas de programação usadas para torná-las efetivas.
A maioria das extensões mais complexas usam mais de uma das seguintes técnicas:

* '''''Subclassing'':''' O MediaWiki aceita que certos tipos de extensões sejam implementados como subclasses de uma classe-base fornecida pelo MediaWiki:
** '''{{ll|Manual:Special pages|nsp=0}}''' – Subclasses da classe {{ll|Manual:SpecialPage.php|SpecialPage}} são usadas para construir páginas cujo conteúdo é dinamicamente gerado usando uma combinação do estado atual do sistema, parâmetros inseridos pelos usuários e consultas às bases de dados. Relatórios e formulários de inserção de dados podem ser gerados. São usadas tanto para propósitos administrativos quanto de relato.
** '''{{ll|Manual:Skins|nsp=0}}''' – Temas modificam a aparência e a experiência do MediaWiki alterando o código de exibição de páginas ao “subclassear” a classe {{ll|Manual:SkinTemplate.php|SkinTemplate}} do MediaWiki.
* '''{{ll|Manual:Hooks|nsp=0}}''' – Uma técnica de injeção de código em PHP personalizado nos pontos principais do processador do MediaWiki. Eles são amplamente usados pelo analisador sintático, motor de localização e sistema de gerenciamento de extensões e páginas do MediaWiki.
** '''{{ll|Manual:Tag extensions|2=Associações de funções em ''tags''}}''' – ''Tags'' do estilo [[pt:XML|XML]] são associadas com uma função do PHP que retorna códigos em HTML. Não é necessário limitar-se na formatação do texto dentro das ''tags'' nem exibi-lo. Várias extensões do tipo ''tag'' usam o texto como parâmetros que guiam a geração de [[pt:HTML|HTML]] que incorpora objetos do Google, formulários de entrada de dados, ''feeds'' RSS e excertos de artigos wiki selecionados.
* '''{{ll|Manual:Magic words|nsp=0}}''' – Uma técnica para mapear uma variedade de ''strings'' de wikitexto num só id, associado a uma função. [[Special:MyLanguage/Manual:Variable|Variáveis]] e [[Special:MyLanguage/Manual:Parser functions|funções do analisador sintático]] usam dessa técnica. Todo o texto mapeado ao id será substituído com o valor retornado da função. O mapeamento entre as ''strings'' de texto e o id é armazenado no ''array'' $magicWords. A interpretação do id envolve um processo um tanto quanto complicado – veja {{ll|Manual:Magic words}} para mais informações.
** '''{{ll|Manual:Variable|nsp=0}}''' – O termo variável é um equívoco. Elas são porções de wikitexto que se parecem com predefinições, porém não têm parâmetros e têm valores de código complexo atribuídos a elas. Marcações wiki padrão, como <code>{{ll|Help:Variables|<nowiki>{{PAGENAME}}</nowiki>}}</code> e <code>{{ll|Help:Variables|<nowiki>{{SITENAME}}</nowiki>}}</code> são exemplos de variáveis. Elas receberam esse nome da fonte do seu valor: uma variável PHP ou algo que pudesse ser atribuído a uma variável; ex.: uma ''string'', um número, uma expressão ou um valor de retorno de uma função.
** '''{{ll|Manual:Parser functions|nsp=0}}''' – <code><nowiki>{{</nowiki>''functionname'': ''argument 1'' | ''argument 2'' | ''argument 3''...}}</code>.  Semelhantes às extensões do tipo ''tag'', funções do analisador sintático processam argumentos e retornam valores. Ao contrário de extensões do tipo ''tag'', o resultado dessas funções é em [[:pt:Wikitexto|wikitexto]].
* '''{{ll|API:Extensions|2=Módulos da API}}''' – É possível adicionar módulos personalizados à [[Special:MyLanguage/API:Main page|API ''action'']], que pode ser invocada por JavaScript, robôs ou clientes terceiros.
* '''{{ll|Manual:Page content models|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">If you need to store data in formats other than wikitext, JSON, etc. then you can create a new {{ll|Manual:ContentHandler|ContentHandler}}.</span>

<span id="Support_other_core_versions"></span>
==Compatibilidade a outras versões do núcleo==
<!-- keep this in sync with [[Compatibility#MediaWiki_extensions]] -->

Existem duas convenções comuns para suportar versões antigas do núcleo do MediaWiki:

* Mestre: o ramo mestre da extensão é compatível com tantas versões antigas do núcleo quanto possível. Isso resulta em um fardo de manutenção (os hacks de compatibilidade com versões anteriores precisam ser mantidos por muito tempo e as mudanças na extensão precisam ser testadas com várias versões do MediaWiki), mas os sites que usam versões antigas do MediaWiki se beneficiam das funcionalidades recentemente adicionadas ao extensão.
<div class="mw-translate-fuzzy">
* Ramos de liberação: os ramos de liberação da extensão são compatíveis com ramos de núcleo correspondentes, p. Ex. Os sites que usam o MediaWiki 1.27 precisam usar o ramo REL1_27 da extensão. (Para extensões hospedadas em [[gerrit]], esses ramos são criados automaticamente quando as novas versões do MediaWiki são lançadas.) Isso resulta em um código mais limpo e um desenvolvimento mais rápido, mas os usuários em versões do núcleo antigo não se beneficiam das correções de erros e dos novos recursos, a menos que sejam recados manualmente.
</div> <span lang="en" dir="ltr" class="mw-content-ltr">(For extensions hosted on [[Special:MyLanguage/gerrit|gerrit]], these branches are automatically created when new versions of MediaWiki are released.)</span> <span lang="en" dir="ltr" class="mw-content-ltr">This results in cleaner code and faster development but users on old core versions do not benefit from bugfixes and new features unless they are [[Backporting fixes|backported]] manually.</span>

Os mantenedores de extensão devem declarar com a <code>[[Special:MyLanguage/Template:Extension#compatibility policy|compatibility policy]]</code> parâmetro da predefinição {{tl|Extension}} que convenção eles seguem.

{{anchor|Licensing}}
<span id="License"></span>
== Licença (em inglês) ==

{{Extension/License}}

<span id="Publishing"></span>
== Publicando ==
Para categorizar e padronizar a documentação da sua extensão, veja {{ll|Template:Extension}}.
Para adicionar sua extensão nesta wiki:
{{Extension/CreateExtensionInputBox}}

<span id="Deploying_and_registering"></span>
=== Implementando e registrando ===
Se você pretende que sua extensão seja implantada em sites Wikimedia (incluindo, possivelmente, a Wikipédia), um escrutínio adicional é garantido em termos de desempenho e segurança.
Consulte {{ll|Writing an extension for deployment}} (em inglês).

<div class="mw-translate-fuzzy">
Se sua extensão adicionar espaços nominais, você pode tentar registrar seus [[Special:MyLanguage/Extension default namespaces|espaços nominais padrões]]; da mesma forma, se ela adicionar tabelas ou campos aos bancos de dados, experimente registrá-los em {{ll|database field prefixes}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please be aware that review and deployment of new extensions on Wikimedia sites can be extremely slow, and in some cases has taken more than two years.<ref>[[phabricator:T148848]]</ref>
</div>

<span id="Help_documentation"></span>
== Documentação de ajuda ==
Forneça uma [[Special:MyLanguage/Project:PD help|documentação de ajuda de domínio público]] para os recursos providos por sua extensão.
{{ll|Help:CirrusSearch}} é um bom exemplo disso.
Forneça aos usuários uma ligação à documentação pela função {{ll|Manual:Special pages#Help page|addHelpLink()}}.

<span id="Providing_support_/_collaboration"></span>
== Fornecendo suporte ou colaboração ==
Desenvolvedores de extensões devem abrir uma conta no {{ll|Phabricator}} da Wikimedia e [[Special:MyLanguage/Phabricator/Creating and renaming projects|solicitar um novo projeto para a extensão]].
Isso fornece um canal público, onde os usuários podem relatar problemas e enviar extensões. Colabore também com os usuários e outros desenvolvedores para fazer triagem de ''bugs'' e para planejar mais recursos à sua extensão.

<span id="See_also"></span>
== Ver também ==

* {{ll|Manual:Extension registration}} - provides further developer documentation on how to register extensions and skins.
* {{ll|API:Extensions}} &ndash; explica como sua extensão pode fornecer uma API para os clientes.
* {{ll|Manual:Extending wiki markup}}
* {{ll|Manual:Coding conventions}}
* [[Best practices for extensions|Melhores práticas para extensões]]
* {{ll|ResourceLoader}}

===Learn by example===
* {{ll|Extension:Examples}} &ndash; implementa alguns recursos de exemplo com extensas documentações.
** {{git repo |project=mediawiki/extensions/examples |text=Repositório Git com códigos de exemplo.}}
* {{ll|Extension:BoilerPlate}} &ndash; uma extensão clichê funcionando, útil como um ponto de partida para a sua extensão. ({{Git repo |project=mediawiki/extensions/BoilerPlate |text=repositório Git}})
** ''Leia'' a extensão Example, ''baseie seu código'' na extensão BoilerPlate.
* [https://github.com/JonasGroeger/cookiecutter-mediawiki-extension cookiecutter-mediawiki-extension] – <span class="mw-translate-fuzzy">uma predefinição para a ferramenta em Python Cookiecutter, que gera uma extensão BoilerPlate (com variáveis, etc.).</span>
** Permite que você avance rapidamente com a sua extensão.
**Pode também gerar a extensão BoilerPlate.
* {{ll|List of simple extensions}} - copie alguns códigos delas.


<span id="References"></span>
== Referências ==
<references />

[[Category:Extension creation{{#translation:}}|{{PAGENAME}}]]