Recentemente escrevi um artigo aqui no meu blog sobre wordpress, entitulado Como fazer um plugin para o Blog WordPress, mas e após você ter criado o seu plugin, o que fazer?

A resposta dessa pergunta depende muito, porque alguns plugins você pretende ser o único a possuir e utilizar, mas outros, você pode querer compartilhar com o mundo. Esse artigo trata dessa segunda opção, ou seja, como enviar seu plugin para o depósito de plugins do WordPress e deixar ele disponível para milhares de usuários à um clique do mouse.

Quando você prentende disponibilizar seu plugin no repositório de plugins oficial do WordPress você precisa seguir alguns critérios. Vejamos:

1 – Criar um arquivo de ajuda chamado readme.txt
O arquivo de ajuda é dividido em setores, que são divididos com os sinais === setor ===, veja quais são os principais setores possíveis:

=== Nome do Plugin ===
Contributors: Quem contribuiu, caso seja mais de um, separe com vírgula
Donate link: http://url para doação, caso alguém queira colaborar com o projeto
Tags: tags relacionadas com teu plugin separadas por vírgula
Requires at least: versão do wordpress requerida, mínima
Tested up to: a versao mais atual que você testou o sistema
Stable tag: (a versao que está estável, caso queira lançar versoes beta, caso contrario utilize a tag trunk)

Aqui coloque uma breve descrição do que o teu plugin faz

== Description ==

Aqui coloque uma descrição detalhada do que o te plugin faz

== Installation ==

Aqui descreva como o usuário deve proceder para instalar seu plugin de forma correta.

== License ==

This file is part of Nome do teu Plugin.
Nome do teu Plugin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Nome do teu Plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Nome do teu Plugin. If not, see <http://www.gnu.org/licenses/>.

== Frequently Asked Questions ==

= Can I suggest a feature for the plugin? =
Aqui você pode colocar informações para os usuários pedirem implementações, mudanças, etc.
Caso queira, você pode colocar o url do seu plugin, dessa forma:

Of course, visit [Nome do teu Plugin Home Page](http://url-do-plugin#comments)

== Changelog ==

= 1.1 =
* Aqui liste uma mudança que houve na versão 1.1
* Aqui liste outra mudança que houve na versão 1.1, para inserir mais mudanças, basta começar a linha com o sinal * seguido das alterações

= 1.0 =
* Aqui liste o que mudou na versão 1.0, para inserir mais mudanças, basta começar a linha com o sinal * seguido das alterações

== Screenshots ==
1. Caso vá publicar imagem do plugin, coloque descrição aqui, para mais descrição crie o item 2 seguido da nova descrição e assim sucessivamente

No arquivo readme.txt que vimos acima, considere o seguinte:
1- Para criar listas não numeradas, inicie a linha com o sinal *
2- Para destacar uma palavra ou frase coloque ela entre **, *assim*, para dar mais destaque ainda, use **assim**
3- Para criar links utilize essa sintaxe: [Descritivo do link](http://url-do-link)
4- Caso você optar por utilizar Screenshots, coloque as imagens com os nomes screenshot-1.png, screenshot-2.png nas mesma pasta do plugin.

2 – Criar um arquivo de licensa para o plugin chamado license.txt

Nesse arquivo basta colocar a Lisença em questão, A GNU Plublic License, você pode baixar esse arquivo aqui Gnu Public License Download

Agora sim seu plugin está pronto para ser distribuído, mas há algumas “burocracias” ainda, vejamos:

1- Antes de tudo, você deve requisitar uma permissão de acesso ao repositório de plugins, isso pode ser feito nesse url WP Repository Request, caso não tenha uma conta no site wordpress.org você precisa fazer uma conta, mas fique tranquilo, é totalmente free, e além disso ficarão gratos com você por estar contribuindo com o projeto deles. Veja a imagem:

Após preencher os dados clique em Send Post, feito isso é só esperar um email deles, no email eles irão enviar, caso seja aprovado, um url para você acessar e publicar seu plugin. Vamos subentender que você já tenha recebido sua aprovação no repositório e sua url para publicação do plugin, então agora você precisa de um programa SVN para poder interagir com o sistema do wordpress.

Um programa excelente para o sistema Windows é o Tortoise que pode ser baixado aqui Tortoise SVN Download

Após baixar o arquivo msi, execute-o para que o programa seja instalado no seu sistema. Agora vamos entender um pouco desse Tortoise. A primeira coisa a saber é que ele é uma extensão para o Shell do sistema que se integra ao Explorer ao ser instalado. Para utilizar ele você precisa fazer umas coisas antes, isso por motivo de organização, crie uma pasta que irá armazenar todos os seus plugins, utilizar o nome Meus Plugins é uma boa idéia, dentro dessa pasta cria outra pasta com o nome do plugin que você criou e quer publicar, esse processo deverá ser repetido sempre que você for publicar um novo plugin, daí basta criar outra pasta dentra da pasta Meus Plugins com o nome do respectivo plugin.

Bom, feito isso, na pasta do plugin corrente, clique com o botão direito do mouse e vai ver duas opções que o Tortoise criou, clique na primeira que é SVN Checkout, essa opção irá criar os diretórios que existem no repositório do wordpress dentro da pasta do plugin, essa opção também é útil quando você já tiver publicado o plugin e quiser baixar ele para seu pc. Veja na imagem:

Após isso uma nova janela será aberta, no campo Url Of Repository coloque o url que você recebeu via email da equipe do wordpress e clique no botão OK. Uma coisa interessante é que qualquer um pode utilizar esse mesmo programa e baixar seu plugin para o pc dele, já que é público né, mas somente você pode fazer alterações no repositório. Veja:

Quando a checagem for concluída as subpastas já estarão criadas na pasta de seu plugin, as pastas mais importantes agora para nós são: truck e tag. A pasta truck contém a versão que estará disponível para download no repositório e a pasta tag é onde você deve criar as subversões do seu plugin. Por exemplo, caso seja seu primeiro plugin, crie uma pasta chamada 0.1 dentro da pasta tags e dentro dela coloque seu plugin, também coloque seu plugin na pasta truck.

A pasta truck e a pasta tags trabalham juntas, se lembra que foi informado a Stable Version lá no arquivo readme, lá você define para o usuário em qual pasta está a versão estável, se é nessa pasta truck ou em uma versão específica. A melhor conduta é sempre deixar na pasta truck a versão estável do seu plugin, e caso queira disponibilizar também uma versão beta pra teste, crie uma nova pasta dentro da pasta tag com o número da versão e informe essa pasta lá no arquivo readme.txt

Feito o descrito acima, clique novamente com o botão direito do mouse sobre a pasta principal do plugin e note que uma nova opção apareceu, a SVN Commit, essa opção irá enviar os arquivos do teu pc para o repositório do wordpress, é também nessa etapa que seu login e senha do wordpress.org será pedida, informe seu login e senha do wordpress.org e siga com o processo.

Não levará muito tempo e seu plugin estará disponível no repositório. Para ver estatísticas de download de seus plugins basta acessar seu perfil no wordpress http://wordpress.org/extend/plugins/profile/Seu-nome-de-usuario onde Seu-nome-de-usuario deve ser substituído pelo seu nome de login no sistema do wordpress.org.

Pessoal, vimos aqui como publicar seu plugin no repositório de plugins oficial do wordpress, espero que tenham gostado da dica, até mais (: