Como criar um arquivo de tradução para seu tema

Quem já traduziu um tema WordPress que não possui arquivo de tradução sabe como é chato procurar palavra por palavra no código de todos os arquivos e substituí-las pela correspondente em português. O mesmo não acontece com temas “internacionalizados” (que infelizmente são raros) pois estes possuem um arquivo do tipo .po (Portable Object) que contem uma lista com todas as palavras a serem traduzidas. Assim basta abrir o arquivo, utilizando o PoEdit (software desenvolvido exatamente para isso), clicar nas palavras ou expressões, digitar suas traduções e salvar na pasta do tema. É bem mais fácil e rápido, pode ter certeza!

Se você quiser criar este aquivo de tradução para o seu tema (ou plugin, o procedimento é igual), basta seguir o passo-a-passo abaixo. Tenho certeza que isso estimulará usuários de outros países a traduzir seu tema/plugin, o que os tornará mais populares.

Passo 1 – Adicionar código no arquivo functions.php

Crie um arquivo chamado functions.php em seu tema e adicione o código abaixo. Isto fará com que o WordPress saiba que seu tema possui suporte a internacionalização. Se o seu tema já possui o arquivo, basta acrescentar o código.

load_theme_textdomain( 'Nome do Tema', TEMPLATEPATH.'/languages' );
$locale = get_locale();
$locale_file = TEMPLATEPATH."/languages/$locale.php";
if ( is_readable($locale_file) )
require_once($locale_file);

Na linha 1 substitua “Nome do Tema” pelo nome do seu tema. :)

Passo 2 – Substituindo os textos pelo código PHP

Agora vem a parte mais trabalhosa, principalmente se você já possui o tema pronto. Se você ainda vai codificar o layout o trabalho não é tão grande assim. Para que o sistema entenda que aquela palavra ou expressão é “traduzível”, será necessário utilizar a função gettext do PHP utilizando os seguintes padrões:

<?php _e("Escrito por", "Nome do Tema"); ?>

Ou

<?php the_content(__('Leia mais...', "Nome do Tema")); ?>

O primeiro caso com “_e” você utilizará para substituir textos simples e o segundo para substituir textos que estão dentro de tags PHP. Lembrando que o “Nome do Tema” deverá ser o mesmo utilizado no arquivo functions.php. Este procedimento deverá ser feito em todos os arquivos do tema.

Passo 3 – Criando o arquivo .po

Para gerar o arquivo de tradução .po iremos utilizar uma ferramenta online chamada icanlocalize.com. Para isso compacte todos os arquivos do seu tema em formato .zip, clique no campo PHP file to process, selecione o arquivo zipado e clique emSend file. Faça o download do arquivo .po, edite-o utilizando o PoEdit para criar uma versão em inglês, crie uma pasta chamada languages dentro do tema e salve-o com o nome en_US.po. Você verá que o PoEdit também salvará outro arquivo com o mesmo nome mas com a extensão .mo, trata-se de uma versão compilada do mesmo arquivo. Salve-a também na pasta do arquivo.

Desta forma se o usuário definiu o WPLANG do arquivo config.php do WordPress como en_US, o sistema irá automaticamente exibir os textos contidos no arquivo en_US.po. Caso esta variável esteja definida para outra língua que não exista um arquivo .po correspondente, o WordPress irá exibir o texto que foi adicionado dentro do código do tema. Por esse motivo talvez seja melhor adicionar o texto em inglês dentro do tema e criar um arquivo de tradução pt_BR, assim também ajudará outros usuários a traduzir o tema para outras línguas, já que o inglês é uma língua que mais possoas a utilizam, principalmente na internet.

Fonte: Planeta WordPress

Convertendo Layout PSD em Tema WordPress Automaticamente

divine-plugin-photoshop-wordpressO plugin para Photoshop Divine promete converter automaticamente layouts do Photoshop diretamente em tema para WordPress. O processo não é todo automático, você deve informar que elementos do seu layout correspondem aos elementos do WordPress, como “título do post”, “data”, “autor”, etc. Também deverá informar quais são os ID’s, seus nomes e suas propriedades. Apesar de gratuito não pude testá-lo ainda pois é necessário ter o Photoshop CS3 ou CS4 para PC.

No site você poderá ver alguns tutoriais e alguma documentação. Como disse o plugin é gratuito, basta preencher o formulário com seu nome e email e em poucos minutos receberá um email com um link para download.

Apesar de recente, o projeto parece ser promissor, se fizer tudo o que promete será uma mão-na-roda. Quem puder testar e deixar sua opinião será ótimo!

Como configurar um Portfolio usando o WordPress

Algumas semanas atrás escrevi o post Crie um Portfolio usando o WordPress e neste post exibi vários temas criados especificamente para serem utilizados em portfolios. Como a maioria destes temas possuem um certo grau de dificuldade para configurar, criei uma enquete para que vocês mesmos decidissem qual seria o tema preferido para elaboração de um tutorial. O tema vencedor foi o Gallery, que apesar de uma tentativa de manipulação da enquete (percebi através do log de votos), foi o escolhido por 36 leitores do pBlog.

Tema Gallery | Demo | Download
tema-portfolio-gallery

Vamos então por a mão na massa. Os primeiros passos são:

  • Fazer o download do tema Gallery e descompactá-lo;
  • Fazer o download do tema Thematic (framework no qual o Gallery foi baseado) e também descompactá-lo.
  • Através de um programa de FTP fazer o upload das pastas gallery e thematic para a pasta “wp-content/themes/” no servidor do seu WordPress;
  • Na administração do seu blog, acessar o menu “Aparência/Temas” e ativar o tema Gallery;
  • Por último você deverá configurar a quantidade de itens que será exibido na página principal. Ainda na administração acesse o menu “Configurações/Leitura” e altere o valor do campo “As páginas do blog mostram no máximo” para 28 (4 linhas) ou 35 (5 linhas).

Feito isso você agora saberá como adicionar um item à galeria deste tema. O processo é bastante simples, diferenciando-se apenas pela inclusão de alguns campos personalizados. Vamos ao passo-a-passo.

  • Primeiro tenha em mãos duas imagens do item que será adicionado, uma com a dimensão 125×125 pixels, este será o thumbnail exibido na página principal e outra imagem com 500×375 pixels, que será exibida na página do post. Você também poderá configurar o WordPress para que gere automaticamente as imagens com estas dimensões, para isso acesse o menu “Configurações/Mídia” e configure o tamanho das imagens;
  • Clique no menu “Post/Adicionar novo” e adicione o título e o conteúdo sobre o item;
  • Faça o upload de ambas as imagens e salve suas URL’s;
  • Em seguida preencha o formulário exibido logo abaixo do campo de conteúdo chamado “Gallery Post Settings“. No campo “Path to Full-Size Image” insira a URL completa da imagem maior (500x375px) e no campo logo abaixo, “Path to Thumbnail Image”, insira a URL completa da imagem menor (125x125px);
  • Opcionalmente você também poderá preencher os campos “Designed by” e “Website URL”.
Gallery Post Settings

Gallery Post Settings

Fácil não? :) E para ter a certeza de que tudo funcionaria conforme as instruções, instalei um WordPress no subdomínio http://teste.pblog.com.br, copiei o tema para lá e configurei-o por completo. Faça uma visita e veja como ficou. Outra coisa use e abuse dos widgets neste tema, foram configurados em vários locais. Neste teste, por exemplo, eu adicionei três widgets no 1st Subsidiary Aside.

De agora em diante utilizarei o subdomínio http://teste.pblog.com.br para testar novas versões do WP, temas e plugins, por isso se você estiver lendo este post algum tempo depois desta publicação é provável que não verá mais o tema Gallery neste endereço.

Crie um Portfolio usando o WordPress

Uma das muitas possibilidades do WordPress é sua utilização como portfolio, principalmente para designers e fotógrafos. Para isso existem diversos temas gratuitos cujo foco principal é a exibição de imagens. Vamos conhecer alguns deles:

Tema Fotofolio | Demo | Download
Fotofolio

Tema Gallery | Demo | Download
tema-portfolio-gallery

Tema Irresistible | Demo | Download
tema-portfolio-irresistible

Tema Linquist | Demo | Download
tema-portfolio-linquist

Tema Monotone | Demo | Download
tema-portfolio-monotone

Tema Sharpfolio | Demo | Download
tema-portfolio-sharpfoliodemo

Tema Viewport | Demo | Download
tema-portfolio-viewport

Tema WPESP | Demo | Download
tema-portfolio-WPESP

Mas como alguns de vocês devem saber, nem tudo são flores e em geral estes tipos de temas são mais complicados para configurar, exigindo configuração de campos personalizados etc e tal. Acompanhando o fórum percebo que muitos novatos tem dificuldade em configurar este tipo de tema. Por isso pensei em escolher um dos temas acima (a princípio seria o Gallery) e criar um passo-a-passo junto com este post. Mas enquanto pesquisava e escrevia tive a idéia de vocês escolherem o tema com o qual deveria criar o tutorial. Sendo assim votem na enquete abaixo no tema de sua preferência e o mais votado terá sua instalação/configuração detalhada minuciosamente na próxima semana, ok?

Qual tema deverá ser o escolhido para elaboração do tutorial?

  • Gallery (35%, 36 Votes)
  • WPESP (30%, 31 Votes)
  • Fotofolio (9%, 9 Votes)
  • Irresistible (8%, 8 Votes)
  • Viewport (8%, 8 Votes)
  • Monotone (1%, 1 Votes)
  • Sharpfolio (1%, 1 Votes)
  • Linquist (8%, 0 Votes)

Total Voters: 104

Loading ... Loading ...

Personalizando o Prologue

O tema Prologue é totalmente baseado no modelo do Twitter. Desenvolvido pela Automattic, traz o look and feel do mais famoso serviço de microblogging da atualidade para o WordPress de maneira exemplar.

Recentemente, precisei utilizar o Prologue num projeto pessoal, e ao por a mão na massa, senti falta de alguns detalhes. Com um pouco de pesquisa, e alguns plugins e códigos, consegui deixá-lo do jeito que eu queria. E como WordPress é compartilhamento de informações, este post explicará, em detalhes, como turbinar o Prologue.

Minha primeira necessidade era restringir o acesso a pouquíssimas pessoas, todas com poder de publicação. Num primeiro momento, pensei em tascar uma senha no diretório em que o WordPress foi instalado, via servidor. Mas depois, pesquisando um pouco, descobri o plugin Login Configurator. Além de permitir personalizar o formulário de login do sistema, ele consegue restringir a leitura do blog inteiro (ou de partes dele) a membros, ou seja, pessoas cadastradas no WordPress. Exatamente o que eu precisava. O Juarez gravou uma vídeoaula sobre esse plugin; vale a pena assisti-la.

Diretório protegido, chegou a hora de instalar o Prologue. Nesse ponto, nenhuma novidade: a instalação é exatamente idêntica à de qualquer outro tema, e graças à forma como esse tema foi escrito, ele é ready to use, dispensa quaisquer configurações/edições posteriores. Só que, novamente, faltam alguns detalhes relacionados às categorias. Dois, para ser mais exato:

  • Seletor de categorias de posts no formulário da home;
  • Indicação das categorias às quais os posts pertencem, nos mesmos.

O primeiro ponto demanda algum trabalho, pois é preciso editar dois arquivos do tema: index.php. post-form.php e style.css. Felizmente, uma alma caridosa fez o “serviço sujo” de fazer essas modificações e compartilhar o caminho das pedras com o mundo (“WordPress é compartilhamento de informações”, lembrem-se sempre). Para quem manja inglês, a receita de bolo está aqui. Para quem prefere o bom e velho novo português, siga os passos abaixo:

Abra o arquivo post-form.php, e acrescente o código abaixo no local onde deseja inserir o menu dropdown das categorias:


Agora, abra o index.php, vamos trabalhar nele. Identifique a seguinte linha:

$tags = $_POST['tags'];

Imediatamente abaixo dessa, copie a seguinte linha:

$category = $_POST['post_category'];

Ainda no mesmo arquivo, encontre essa linha:

'post_content' => $post_content,

E imediatamente após ela, copie essa:

'post_category' => $category,

Por fim, abra o style.css. No final do arquivo, copie isso:

#postbox select {
font-size: 1.2em;
padding: 2px;
border: 1px solid #c6d9e9;
margin-left: 70px;
}

Pronto, agora temos categorias no formulário da home page. Aproveite que está com o style.css aberto, e aumente um pouquinho a altura da textarea do post. Para tal, basta editar o valor height: 50px; do ID #postbox textarea#posttext. Particularmente, uso 150px nessa área. O resultado final é esse:

Prologue (com categoria).

Prologue (com categoria).

Falta ainda a questão da indicação das categorias nos posts. Por padrão, o Prologue só trabalha com tags, mas não é nada que possa ser mudado.

As alterações abaixo devem ser feitas nos arquivos index.php e single.php. Localize essa parte em ambos:

Substitua-a por essa linha:

Categoria: .

Muito bem! Agora temos categorias e tags indicadas em cada post.

Para finalizar, dois plugins que considero muito úteis nesse tipo de blog/microblog: um que mostra usuários ativos no momento, e outro que lista os últimos comentários.

O plugin que mostra os usuários online no momento é o WP-UserOnline, do Lester Chan. Após ativá-lo e traduzi-lo na área administrativa, o código invocatório que utilizo é o seguinte:

:

Ele retorna a quantidade de membros online, e dá os nomes de cada um.

O outro plugin é o Simple Recent Comments, que mostra os últimos comentários de maneira bem simples, numa lista. Após a ativação, o código invocatório é o seguinte:

Ultimos Comentarios

','

'); } ?>

Traduzindo-o: o número 7 é a quantidade de comentários que aparecerá; o 120, o limite de caracteres de cada comentário; o trecho longo que inclui o título (“Últimos Comentários”), é o que vem antes da lista de comentários, que por sua vez é gerada automaticamente, e depois disso, vem o fechamento do bloco.

Essas dicas deixam o Prologue mais esperto e completo, mas não é nada que chegue perto do P2, nova versão do Prologue em desenvolvimento (veja a demo em ação). Em poucas palavras? Está ficando fenomenal. Dê uma olhada no vídeo demonstrativo liberado pela Automattic:

O anúncio foi feito no início de março, mas até agora o novo tema não foi lançado. Caso queira aguardá-lo, é uma boa pedida. Se a utilização do Prologue é urgente, as modificações mostradas neste post ajudarão bastante.

Novidades do Mundo WordPress