Acabei de criar meu primeiro plugin e ele foi aprovado pelo WordPress. Boas notícias para mim, mas e agora? As "instruções" no Codex são tudo menos claras para mim. Eu encontrei um artigo sobre Dig WP e consegui chegar à terceira linha de código. Depois disso, não há alegria.

Alguém aqui tem um conjunto claro de instruções sobre como fazer isso sem a necessidade de ler um livro inteiro? Tenho certeza de que existem pessoas muito experientes aqui que fazem essas coisas o tempo todo ...

Desde já, obrigado!

Etapa 1 - Verifique se as coisas estão formatadas corretamente

O WordPress em si depende dos cabeçalhos na parte superior do arquivo principal do plug-in. Em muitos casos, se o seu plug-in for "My Cool Plugin", esse arquivo estará my-cool-plugin.phpno diretório principal da sua pasta. Verifique se a parte superior do arquivo segue este formato:

<?php
/*
=== [Plugin Name] ===

Plugin Name: [Plugin name]
Plugin URI: [Website where plugin information can be found - your blog, maybe]
Description: [Short description of your plugin]
Author URI: [Your website]
Author: [Your name]
Version: [This version number]
*/

O repositório do WordPress.org depende do seu readme.txtarquivo para criar uma descrição e uma página de download. Portanto, verifique se o readme.txtarquivo se ajusta ao seguinte formato:

=== [Plugin Name] ===
Contributors: [Your WordPress.org username]
Donate link: [A site people can go to to give you money]
Tags: [Search terms related to your plugin]
Requires at least: [Minimum version of WordPress required]
Tested up to: [Newest version of WordPress you've tested with]
Stable tag: [This version number]

[Short, one-sentence description of your plugin]

== Description ==

[Long description of your plugin]

== Installation ==

[Steps required to install the plugin]

== Frequently Asked Questions ==

= [A question] =

[An answer]

= [Another question] =

[Another answer]

== Screenshots ==

== Changelog ==

== Upgrade Notice ==

Há um útil validador de leia-me no WordPress.org que você pode usar para garantir que seu leia-me tenha tudo o que precisa. Basta copiar e colar e ele verificará se todas as seções estão lá e se você está pronto.

Etapa 2 - Confira o repositório SVN

É uma boa ideia manter sua versão de desenvolvimento separada do repositório de plugins do WordPress.org. Sim, o SVN é usado para controle de versão, mas o WordPress o utiliza mais para gerenciamento de versões. Se você começar a confirmar todos os conjuntos de alterações no repositório, poderá ter problemas. Uma coisa que muitos desenvolvedores fazem é desenvolver localmente usando o Git, depois transferir seus arquivos para o repositório Subversion quando você estiver pronto para fazer um lançamento.

Essas instruções pressupõem que você esteja usando um computador Windows. Se você estiver em um Mac, poderá usar o SCPlugin em vez do TortoiseSVN. As etapas que você precisará seguir serão as mesmas, apenas os menus contextuais e as capturas de tela serão ligeiramente diferentes devido à interface do usuário. Eu não tenho um Mac, então não posso criar capturas de tela para orientá-lo em um tutorial ... mas confie em mim, é o mesmo processo.

Instale o TortoiseSVN se ainda não o tiver.

O TortoiseSVN é uma GUI do Subversion de código aberto para Windows. Confie em mim, usar a GUI é infinitamente mais fácil do que tentar fazer coisas na linha de comando. Você também terá menos problemas.

Confira seu repositório SVN hospedado no WordPress

Encontre um local em que deseja armazenar a versão hospedada no WordPress do seu plug-in. Por padrão, eu uso /My Documents/WordPress/em todo o meu trabalho de desenvolvedor hospedado. Clique com o botão direito do mouse dentro da pasta e selecione "SVN Checkout" no menu suspenso.

Na janela de diálogo exibida, digite o URL do repositório do plug-in do WordPress.org (estou usando um dos meus para fins de demonstração) e escolha a subpasta que você deseja criar.

O Tortoise vai pensar um pouco e depois retirará o repositório do WordPress.org. A pasta recém-criada terá todas as pastas necessárias já configuradas para você. Agora basta copiar e colar e confirmar ... um passo de cada vez.

Copie sua versão mais recente para /tags

É aqui que eu faço as coisas de trás para frente na maioria dos tutoriais. Todos os outros dirão para você se comprometer /trunkprimeiro, mas lembre-se de que o WordPress não usa nada, /trunkexceto o arquivo leia-me, ao examinar os plug-ins. Portanto, se você colocar seu plug-in /trunke perder sua conexão de rede (ou algo der errado) antes de confirmar uma tag, você terá problemas.

Na /tagspasta, crie uma pasta com o mesmo nome da versão que você está lançando para o plug-in. Portanto, se você estiver lançando a versão 0.1, crie uma /tags/0.1pasta.

Copie todo o seu plug-in para esta pasta.

Agora clique com o botão direito do mouse dentro da pasta e selecione "SVN Commit" no menu suspenso.

Você verá uma janela que mostra todas as suas alterações (você deve ver todos os seus novos arquivos marcados como "sem versão").

Marque a caixa ao lado de todos os arquivos do seu plug-in (ou clique em "Selecionar tudo" para selecionar todos).

Na caixa na parte superior, digite uma mensagem de confirmação. Como você está enviando uma tag, provavelmente deve usar algo como:

Marcando a versão 0.1 de [My Plugin].

Clique OK.

Novamente, o Tortoise pensará por alguns minutos e, em seguida, solicitará seu nome de usuário e senha do WordPress para se comprometer com o servidor. Forneça-os, espere que as coisas passem e diga "Sucesso", depois passe para o próximo passo.

Copie sua versão mais recente para /trunk

Agora navegue para a /trunkpasta do repositório e mais uma vez copiar e colar o seu plugin para essa pasta. Siga as mesmas etapas acima para selecionar seus arquivos e preparar a confirmação. Mas para uma mensagem, use algo que explique o que a nova versão faz:

Versão 0.1 de [My Plugin] - adiciona suporte para OpenID.

Depois que tudo terminar, basta aguardar um pouco para os servidores do WordPress.org se atualizarem. Eles podem ser mais lentos em alguns dias do que outros, mas dentro de uma hora, você deve ver seu novo lançamento no repositório.

Atualizando um Plug-in para uma Nova Versão

Depois que seu plug-in estiver disponível, preparar uma atualização é relativamente fácil.

Primeiro, use o comando Atualização do SVN para garantir que você tenha a versão mais recente do repositório. Se você é o único desenvolvedor, você já deve, mas é uma boa prática atualizar antes de confirmar mesmo assim.

Em seguida, passar pelo processo acima para criar uma nova sub-pasta na /tagspara sua nova versão. Diga /tags/0.2. Não toque na /0.1pasta antiga . Está lá por um motivo e você nunca mais o tocará.

Confirme sua nova tag e vá para a /trunkpasta Substitua tudo /trunkpor sua nova versão e confirme como acima. Depois que os servidores forem atualizados, eles começarão a falar sobre a nova versão, e não a antiga.