Billy Blay

Continuando a série de como traduzir um plugin chegamos à segunda parte, para quem perdeu o primeiro post leia aqui.

Neste post faremos a configuração do arquivo do plugin.

2 – Categoria Karatê kid

1 –  Para começar a tradução é necessário configurar plugin, adicionando o trecho de código abaixo de preferência nas primeiras linhas do arquivo do plugin.

<?php load_plugin_textdomain('$dominio_do_plugin', "/wp-content/plugins/pasta_do_plugin/"); ?>

• load_plugin_textdomain – Procura no diretório do plugin um arquivo de extensão  *.mo de acordo com a linguagem configurada no Wordpress;
• dominio_do_plugin – Variável utilizada nas linhas que serão traduzidas;
• pasta_do_plugin – renomeie pelo nome da pasta do plugin

Exemplo:
<?php load_plugin_textdomain('wpp', "/wp-content/plugins/wp_portifolio/"); ?>

• wpp – Váriável escolhida com base nas iniciais do plugin, você pode criar do jeito que quiser;
• wp_portifolio – Pasta do plugin.

2 – Chegamos a parte mais trabalhosa, você terá que vasculhar todo arquivo do plugin em busca de frases e palavras a serem traduzidas.

Exemplo:

<h2>WP-portfolio Settings</h2>

<?php
$mode = 'add';
$title = 'Add a New Image';
?>

Existem duas formas de traduzir as linhas, são elas:

1. _e($texto, $dominio_do_plugin)
2. __($texto, $dominio_do_plugin)

• $texto – Texto a ser traduzido
• $dominio_do_plugin – O mesmo declarado no load_plugin_textdomain no início do arquivo do plugin

A primeira forma é usada para imprimir o texto na tela, semelhante ao echo do php e segunda é usada para traduzir variáveis.

Exemplo:

<h2><?php _e('WP-portfolio Settings', 'wpp');</h2>

<?php
$mode = __('add', 'wpp');
$title = __('Add a New Image', 'wpp');
?>


No próximo e último post da série criaremos o arquivo de catálogo, até lá.

Você é desenvolvedor wordpress?
Vira noites caçando plugins para implementar aquele freela?
Encontrou aquele plugin que atende todas suas expectativas, mas o danado está em outra língua e você precisa dele traduzido para colocar no site do cliente.

Seus problemas acabaram!

Conheça agora algumas maneiras de traduzir plugins e colaborar com a comunidade.

1 – Categoria mel-na-chupeta

Se o plugin já vier com o arquivo .pot você já tem meio caminho andado, é só:

1. Baixe e instale o programa poEdit;
2. Vá até a pasta do plugin que contém os arquivos de tradução, e procure pelo arquivo .pot;
3. Abra o arquivo .pot com o poEdit;
4. Vá no menu “Arquivo > Salvar como” e adicione o idioma da tradução no final do nome do arquivo, no caso do português brasileiro escreva “-pt_BR“, ficando NomedoArquivoPot-pt_BR e clique salvar;
   • O arquivo será salvo com a extensão .po, ficando NomedoArquivoPot-pt_BR.po;
5. Abra o NomedoArquivoPot-pt_BR.po com o poEdit;
6. Traduza todas as frases e palavras listadas no arquivo;
   • Não sabe inglês, russo, francês? http://translate.google.com.br/?tab=mT#
7. Salve as alterações;
   • Será criado automaticamente o arquivo NomedoArquivoPot-pt_BR.mo
8. Faça o upload do arquivo .mo para pasta do plugin;

Se seu wordpress já estiver em português a tradução do plugin será instantânea, não é preciso ativar nada.

No próximo post da série mostrarei outras formas de tradução, até lá!

Alow Pessoal!

Acaba de sair do forno a nova versão do WP-licenses, Nesta versão implementei o painel de controle (Configurações -> wp-licenses). Agora você pode escolher entre dois tipos de imagem e desabilitar o script de tooltip.

Nas próximas versões adicionarei novos temas e algumas configurações usadas no creative commons.

Baixe o plugin: http://wordpress.org/extend/plugins/wp-licenses/

Alow Pessoal,

Após alguns meses pesquisando e procrastinando, orgulhosamente apresento a mais nova versão do WP-licenses.

Nesta versão apesar dos conhecimentos básicos de programação, consegui aplicar algumas das boas práticas recomendadas pela equipe do Wordpress, reduzi e padronizei o código (claro, sempre pode melhorar) e criei o arquivo de tradução wp-licenses.pot.

Em breve prepararei um tutorial para cada fase, como fiz no Como publicar um novo plugin no repositório do Wordpress.

Baixe o plugin: http://wordpress.org/extend/plugins/wp-licenses/

Mas neste momento quero agradecer a:

• Joyce Lima (pelo incentivo e por ser “cobaia” de testes)
• Jim Jones (pela tradução para o inglês)
• Juarez PAF (pelos links marotos)
• Rodrigo Muniz (pelos links marotos)

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.