Billy Blay

Oi pessoal,

depois de muita enrolação finalmente consegui publicar o wp-licenses no repositório do wordpress, e depois que consegui botar para funcionar resolvi escrever este post para aquele que como eu não são programadores, não entendem de linux e softwares de versionamento.

pois bem, sem muita demora vamos iniciar:

1 – Faça o seu registro no site http://wordpress.org/extend/plugins/register.php

2 – Faça o login em http://wordpress.org/extend/plugins/bb-login.php

3 – Cadastre o seu plugin em http://wordpress.org/extend/plugins/add/

Neste passo você preencherá as informações do plugin como nome, descrição e URL. Fique atento estas informações depois de submetidas não poderão ser alteradas até que o plugin seja aprovado.

Quando seu plugin for aprovado, você receberá um email com o endereço do servidor de versionamento http://svn.wp-plugins.org/nome-do-plugin e alguns links úteis para ajudar na publicação.
Com estas informações na mão, vamos instalar um programinha para usuários windows que vai ser uma mão na roda.

4 – Vá ao endereço http://tortoisesvn.net/downloads baixe a versão do TortoiseSVN que se adeque ao seu tipo de sistema, no meu caso instalei o TortoiseSVN-1.6.3.16613-win32-svn-1.6.3.msi. Como é comum em máquinas com o sistema Windows, reinicie o computador (eu recomendo).

Depois de instalado vamos para etapa de configuração.

5 – Crie uma pasta (diretório) no seu computador, pode ser em qualquer lugar, no meu caso criei no d:\projetos\plugins\nome-do-plugin.

6 – Com a pasta criada, clique no com o botão direito do mouse sobre a pasta e você verá que apareceram novos itens no menu.

• SVN Checkout
• ToroiseSVN

7 – Clique na opção TortoiseSVN e depois em Create repository here.

Se tudo ocorrer bem você receberá a mensagem.

8 – Clique novamente com o botão direito sobre a pasta e escolha a opção SVN Checkout…, em seguida será exibida a tela para que você informe o endereço do servidor de versionamento (aquele que você recebeu quando seu plugin foi aprovado), digite no campo URL of repository e clique OK.

O campo Checkout Directory já virá preenchido com o endereço local da pasta. O tortoise pedirá o login e senha para completar o processo (o login e senha são os que foram enviados quando você se cadastrou no wordpress).

Quando o Checkout completar a tarefa de adicionar os arquivos clique em OK.

9 – Abra a pasta que foi criada, e você notará que foram criadas várias subpastas (não delete nenhuma), nós trabalharemos com as pastas:

• Trunk - É utilizado para o trabalho normal, ela pode conter uma versão estável do seu código ou o instável.
• Branches - É onde você coloca suas experiências, ou alterações a partir do código original. Você pode usá-lo também para a manutenção depois da liberação de um código estável.
• Tags - São normalmente utilizadas para marcar um determinado número de versão com um significado especial. Por exemplo, uma versão estável, tornada pública e que não está sendo alterada.

Você pode ter vários projetos no mesmo repositório ou de um projeto por repositório.

10 – Copie os arquivos do seu plugin para a pasta trunk.

11 – Suba um nível nas pastas e clique com o botão direito sobre a pasta trunk, e clique na opção commit.

Será exibida a tela a seguir

No campo Message pode ser descrito o que  mudou nesta versão que vai ser enviada (o campo não é obrigatório).
No campo Changes made vão ser listados todos os arquivos que foram alterados nesta versão.

Marque a opção select e clique OK.

Agora vamos trabalhar na pasta tags.

12 – Quando seu plugin estiverpronto para ser liberado para os  usuário, vá até a pasta tags e crie uma pasta com o nome da versão do seu plugin (no meu caso utilisei o nome 0.0.1),  em seguida copie seus arquivos para a pasta criada.

13 - Suba um nível nas pastas e clique com o botão direito sobre a pasta tags, e clique na opção commit (o processo é o mesmo da pasta trunk). Quando o upload de todos os arquivos estiver terminado, o plugin já estará disponível na página do worpress (no meu caso http://wordpress.org/extend/plugins/wp-licenses/) e nas buscas dentro do ADM do wordpress (Fato  interessante é que o google indexou em 5 minutos).

A ultima parte do tutorial é a edição das informações da página do plugin, não existe a opção para editá-las no site, todas informações devem ser descritas no arquivo readme.txt, este arquivo deve ser colocado nas pastas trunk e tags.

O arquivo readme.txt deve serguir este padrão
http://wordpress.org/extend/plugins/about/readme.txt

Nele você descreverá o seu plugin, informações sobre como instalar, imagens e instruções de como é o funcionamento, e sobre alterações de cada versão. Este arquivo não é obrigatório, mas a página fica bem interessante com todas essas informações.

Para facilitar a edição deste arquivo o wordpress disponibilizou este validador
http://wordpress.org/extend/plugins/about/validator/

Lembre-se que a cada alteração no plugin este arquivo deve ser atualizado informando o que foi mudado. Atualize-o  e depois clique sobre o arquivo com o botão direito do mouse e escolha a opção Commit, para enviar para o servidor

Bem pessoal, espero ter ajudado e até a próxima.