Com o crescimento continuo da importancia do Wordpress no mundo Blogger um item está cad vez mais em destaque, os plugins para wordpress. Muitos defendem que o Wordpress já não é mais um simples sistema de blog e que pode virar muito mais, como um CMS e diversos outros usos, vejamos por exemplo o Ministério da Cultura, cujo site é feito com base no WP.

O sistema, embora tenha diversas polêmicas sobre seu código, foi desenhado de forma a permitir diversos ganchos e pontos de conexão em sua API para podermos plugar nossos plugins, executando atividades nos mais diversos momentos da execução de um request, ou da exibição de um post. Algum tempo atrás me dediquei a escrever um artigo completo sobre o desenvolvimento destes plugins, que é hoje o segundo post mais acessado no meu blog.

A algum tempo venho recebendo ideias e pedidos de pessoas que querem desenvolver plugins para seus blogs, eles tem um problema, inventam uma solução, mas esbarram no PHP ou no codigo fonte do WP e acabam deixando de lado. Muitas vezes já existe um plugin no repositório do WP que atende ao que é buscado, porém em alguns casos sua ideia tem um twist, uma diferença ou é simplesmente original, e nessas horas você precisa de alguma ajuda.

Venho querendo pegar projetos pontuais e pequenos para fazer, já que projetos grandes acabam de vez com meu tempo livre e me ocupam por muito tempo. Portanto estou abrindo aqui um espaço para ajudar estas pessoas aqui, e estarei disponibilizando uma oportunidade para criar plugins para os outros.

Esta iniciativa possui tres planos:

1. Plano Open Source: Você contribui com a ideia do plugin, eu desenvolvo ele, divulgo aqui no blog e publico no repositório do link. O código fica aberto a todos e o crédito do plugin é dividido entre você e eu.
2. Plano Pago: Você me fornece com o briefing do plugin, eu desenvolvo o plugin e lhe entrego todo o código para você usar ou divulgar como quiser. O plugin carregará apenas o seu nome nos créditos.
3. Plano Combinado: Este plano é uma mistura dos dois acima, novamente a ideia é sua, mas neste caso o código não é aberto (open source), pertencendo apenas a você, porém o crédito é novamente dividido entre você e eu. Neste caso o custo de desenvovimento é reduzido.

O preço dos plugins será feito sobe encomenda de acordo com o nivel de complexidade do mesmo e de outros fatores, e será divulgado após o contato inicial para o orçamento. Somente no caso do Plano Open Source não existe nenhum custo.

Vou desenvolver os plugins dentro do tempo livre que tiver então os prazos serão negociados cuidadosamente para evitar maiores problemas. Para acompanhar todo esse serviço, estarei utilizando o Redmine, um gerenciador de projetos, por isso vejam ele aqui:

DMS Systems – Gerenciador de Tarefas

Usem esta página [http://dev.rafaeldohms.com.br/wiki/wp-plugins/Open-Source_Plugin_Ideas] para cadastrar suas ideias de plugins Open Source, ou este email [rafael+plugins@rafaeldohms.com.br] para pedir orçamentos de plugins nos planos Pago e Combinado

Observação! É importante notar que cadastrar sua ideia não tras garantia de que seu plugin será escolhido e desenvolvido, tudo irá depender do meu tempo livre e da quantidade de plugins que apareça por ai.

PHP, plugin, Wordpress

Hoje pela manhã identifiquei um antigo bug do plugin que causava instabilidade no cache e algumas vezes erros de “carregando pra sempre”.

Rapidamente eu corrigi o problema e lancei a versão 0.85 que corrige este bug. Decidi lançar isso logo antes de continuar o desenvolvimento das versões novas que vem por ai, já que o Manoel esta anunciando novidades no BlogBlogs, vou ficar na cola para aproveitar isso no plugin.

Façam o download: http://wordpress.org/extend/plugins/bbuinfo-BlogBlogs-user-info-plugin/
ou usem o novo painel do WordPress para fazer a atualização automática.

Recomendo que TODOS atualizem!

Uma peça chave do sucesso do WordPress é justamente sua capacidade de aceitar plugins e widgets, além , é claro, dos milhares de programadores que desenvolvem os mais diversos plugins que fazem de tudo um pouco.

Algum tempo atrás fui abordado pelo Manoel Lemos do BlogBlogs para discutirmos uma missão, criar um plugin para o WordPress, baseado na API do site. Comecei entao minha saga atrás de como desenvolver um plugin. O material estava lá, espalhado em vários sites, mas estava lá.

Então agora com o sucesso do BBUinfo e na véspera de novos projetos, decidi tentar consolidar este conhecimento adquirido e focar ele no público brasileiro. Vou procurar mostrar o caminho das pedras de como começar e onde buscar os dados necessário para integrar seu código ao do WP.

O WP, como eu disse, foi desenhado com plugins em mente. Sua estrutura possui diversos componentes desenhados para que seu plugin se “encaixe” no ponto certo (attach points ou hooks) e na hora certa. Mas para isso é importante observar alguns passos, para melhor desenhar seu plugin.

Os passos a seguir são a minha recomendação de como desenvolver um plugin, e evitar maiores problemas e dificuldades. Para poder acompanhar melhor o código produzido, vou estar criando com vocês o meuPrimeiroPlugin, que será descrito passo a passo abaixo.

Passo 1: Planejamento

No desenvolvimento de qualquer sistema o primeiro passo deve sempre ser uma análise e planejamento do que será feito, com plugins, embora pequenos, isto se mantém.Como em sistemas é importante identificar neste momento o que se deseja fazer, qual o objetivo do plugin. Levantar entradas e saídas, dados externos e suas fontes, enfim, definir de forma geral o que o plugin faz, com que dados ele faz isso e como obter os dados necessários.Faça perguntas como:

• Preciso de um banco de dados?
• Preciso acessar dados externos por webservice ou uma API?
• Vou mostrar algo visual para o usuário?
• O que pretendo fazer?
• Qual o nome darei ao plugin?(se você consegue definir o nome, sabe o que quer)

Um bom exercício para este momento é utilizar o padrão de arquivo readme do WP e já iniciar a escrita da descrição resumida e detalhada do plugin, pois este será seu guia. (você pode validar o arquivo aqui)

meuPrimeiroPlugin

Este plugin, desenhado para o aprendizado de como desenvolver plugins, executa ações básicas e didáticas, mas sem muito uso. Para mostrar todos os limites, o plugin fará as seguintes ações:

1. Acrescentará ao final de cada comentário o texto: “O conteúdo deste comentário é de responsabilidade de: {AUTOR}”
2. Criará uma tabela nova que irá armazenar uma contagem de visitas a cada post, e mostrará esta contagem logo ao final do POST.
3. Substituir a palavra XXX por um link

Exemplos

• Arquivo readme.txt
• Meu brainstorm (idéias para o plugin):
  
  

Produtos desta etapa
Arquivo readme.txt, arquivo com “brainstorm” (tente um mindmap, como acima)

Passo 2: Projeto

Esta etapa segue os padrões de projetos de sistema, mas com algumas adições específicas do WordPress. Como base sugiro que use a linguagem UML para definir seu projeto e faça um diagrama de MER (base de dados).

Embora não seja obrigatório, a criação do plugin como um objeto, é recomendável e mais fácil de manter do que código estruturado, além claro de ser uma “prática recomendada” para o PHP5. Outra grande vantagem nesta orientação é que como os métodos são chamados de dentro do objeto a preocupação com “nomes coincidentes” é nula, sendo reduzida apenas ao nome do objeto que deve ser único.

Então defina o seu objeto com métodos que se identifiquem com as diversas ações que o plugin vai executar, por exemplo: adicionarAssinatura(), pegarDadosExternos(), salvarDados()…

Agora entra o ponto onde o WordPress traz toda sua mágica com os seus “hooks”, ou ganchos.

Ganchos do WordPress

Para facilitar que se ligue o plugin às ações doWP, são definidos ganchos em sua programação, ou seja, em pontos específicos do funcionamento do plugin, são disponibilizados pontos onde as funções podem se “pendurar”. Desta forma caso deseje criar um plugin, que deve executar determinada função no momento em que um comentário é salvo, você usaria o gancho “comment_post”.

Estes ganchos são divididos em 2, ações e filtros.

• Ações são eventos disparados em momentos exatos durante a execução do WordPress.
• Filtros são lançados no momento de gravação ou apresentação de um texto para que seja possível modificá-lo.

Outros Links: Todos Hooks de todas versões do WP

Para definir os ganchos você pode se perguntar “Em que momento devo fazer isso?” para cada ação e então verificar a lista de ganchos de ações e filtros para achar qual lhe atende.

meuPrimeiroPlugin
Neste caso podemos usar os seguintes pontos para anexar nossas funções:

1. Instalar: ligada ao “register_activation_hook” que é executado na ativação de um plugin no menu
2. Desinstalar: Estas funções foram bastante discutidas, mas ainda não existe um hook fixo.
3. Inicializar: Esta deve ser executada logo no início, para isso temos o filtro “init”
4. Aba de opções: para fazer a aba precisamos de dois pontos, a ação “admin_menu” e o “add_options_page”.
5. Contar Visita: poderia ser melhor,mas o filtro “the_content” garante a contagem na hora mais certa.
6. Inserir texto no comentário: Para isso o filtro “get_comment_text” é perfeito
7. Substituir palavras: este é bem direto também, vamos usar o filtro “the_content”

Juntamente com este raciocínio, fiz o mapeamento da classe e do que seria necessário na base de dados:

Diagrama de classe do plugin

MER do Banco

Produtos desta etapa: diagrama de classe do seu plugin, um MER do banco de dados e uma lista de possíveis pontos de inserção (ganchos).

Passo 3: Desenvolvendo

Com o caminho a sua frente devidamente mapeado, agora podemos nos aprofundar no código, além de conhecer algumas possibilidades que o WP traz embutidas em si mesmo.

O ideal é que seu plugin caiba dentro de um arquivo só, mas caso isso não seja possível, recomenda-se que todos arquivos sejam jogados dentro de uma pasta com o mesmo nome do plugin. O nome do plugin também pode (recomenda-se) ser o nome de seu arquivo principal, isso irá lhe facilitar usar funções “on activation” disparadas na ativação do plugin. Portanto teremos a seguinte estrutura para nosso exemplo:

A primeira coisa que deve aparecer em nosso arquivo meuPrimeiroPlugin.php é o cabeçalho. Este cabeçalho é usado pelo WP para mostrar os dados de seu plugin na página de administração de plugins, então é muito importante manter estes dados corretos, o cabeçalho segue o padrão abaixo:

/*
Plugin Name: Nome do Plugin
Plugin URI: http://Endereço_da_pagina
Description: Descrição simples e curta do plugin
Version: A versão atual do plugin, ex.: 1.0
Author: Nome do Autor do Plugin
Author URI: http://Endereço_do_site_do_autor
*/

Após isso podemos começar a definir a classe. A definição segue o padrão normal de um objeto em PHP (4 ou 5). Aqui vamos seguir uma orientação PHP5 por sua enorme vantagem e pelo “fim” do PHP

O site do WP possui muito material sobre padrões de codificação, e eu recomendo uma leitura, mas são padrões bem estabelecidos que muitos programadores já devem usar normalmente.

Como vimos no passo anterior montamos um diagrama de classe e nesse diagrama já identificamos as funções que precisamos desenvolver em nosso plugin, portanto a seguir vou seguir passo a passo deste arquivos criando e explicando cada uma destas funções, e no final comentarei sobre os ganchos que serão colocados fora do escopo do objeto e porque.

Função Inicializar

Esta função serve para centralizar todas as ações que devem ser sempre tomadas para integrar o plugin com o WP, sejam elas ações de adição/remoção de filtros/ações ou instanciação de objetos, cópias de variáveis globais, enfim, todas ações que serão executadas sempre que o WP carregar.

public static  function inicializar(){
global $wpdb;

//Definir ganchos
add_filter("get_comment_text", array("meuPrimeiroPlugin","exonerarComentarios"));
add_filter("the_content", array("meuPrimeiroPlugin","contarVisita"));
add_filter("the_content", array("meuPrimeiroPlugin","processarSubstituicao"));
add_action('admin_menu', array('meuPrimeiroPlugin','adicionarMenu'));

//Mapear objetos WP
meuPrimeiroPlugin::$wpdb = $wpdb;

//Outros mapeamentos
meuPrimeiroPlugin::$info['plugin_fpath'] = dirname(__FILE__);

}

Como podemos ver, no caso do meuPrimeiroPlugin, estamos cadastrando as outras funções com seus devidos filtros, ou seja, os ganchos que irão executá-las e copiando o objeto $wpdb para dentro do nosso script, podendo agora ser referenciado como: meuPrimeiroPlugin::$wpdb que é melhor que ficar sempre usando “global” no início da função. Além disso aproveita-se para obter a localização do plugin, usando a constante __FILE__ do PHP que define o caminho até o arquivo onde esta.

$wpdb
Este objeto sempre presente no WordPress é responsável pela sua conexão com a base de dados, ele pode executar queries, buscar dados, e realizar diversas funções relacionadas a base de dados. Veja aqui a lista de métodos [aqui]

Função Instalar

Esta função é mapeada para ser executada no momento que o plugin é ativado na aba de plugins do WordPress. Como nosso plugin utiliza dados que serão salvos e lidos de bases de dados é necessário que elas sejam criadas antes de seu uso, o momento de ativação é excelente para isso, porém o plugin pode ser ativado e desativado diversas vezes (quando se faz upgrade do WordPress por exemplo) e não podemos simplesmente criar a tabela sempre, por isso observe o comando para criar apenas caso não exista.

	public static function instalar(){

if ( is_null(meuPrimeiroPlugin::$wpdb) ) meuPrimeiroPlugin::inicializar();

//Criar base de dados
$sqlContador = "CREATE  TABLE IF NOT EXISTS `".meuPrimeiroPlugin::$wpdb->prefix."mpp_post_visitas` (
`id_post` INT NOT NULL ,
`visitas` INT NULL ,
PRIMARY KEY (`id_post`) )";

$sqlPalavras = "CREATE  TABLE IF NOT EXISTS `".meuPrimeiroPlugin::$wpdb->prefix."mpp_substituicao` (
`idmpp_substituicao` INT NOT NULL AUTO_INCREMENT ,
`orig_palavra` VARCHAR(255) NULL ,
`subst_palavra` VARCHAR(255) NULL ,
PRIMARY KEY (`idmpp_substituicao`) )";
meuPrimeiroPlugin::$wpdb->query($sqlContador);
meuPrimeiroPlugin::$wpdb->query($sqlPalavras);

//Criar opções
add_option("mpp_texto_exonerar","O conteúdo deste comentário é de responsabilidade de: ");
}

Neste caso, de forma puramente didática, criei uma opção para armazenar o texto que será inserido nos comentários. Esta opção foi criada apenas para mostrar como elas podem ser utilizadas. Estas opções são gravadas na tabela de opções do próprio WordPress e acessadas com estes métodos: add_option, update_option, delete_option, get_option.

Note que no ínicio da função chamo a função de inicialização, isso é importante pois no ato em que a função de instalação é chamada o gancho “init” ainda não foi chamado e por isso não temos nossa conexão com o banco por exemplo. Isto causaria erros na ativação do plugin.

Dica:
Se você receber um aviso “cannot redeclare class” na ativação do plugin, 9 em 10 vezes o erro não esta na declaração do plugin e sim omitido pelo WordPress, em sua função de captura de erros, que infelizmente possui algumas falhas, como essa.

Para ver o erro verdadeiro vá até o arquivo wp-admin/plugin.php e comente as linhas 14 e 15, mostradas abaixo:

wp_redirect(add_query_arg('_error_nonce', wp_create_nonce('plugin-activation-error_' . $plugin), 'plugins.php?error=true&plugin=' . $plugin)); // we'll override this later if the plugin can be included without fatal error
ob_start();

Função Desinstalar

Esta função não possui um hook para ser executada de forma automática, mas é uma função que recebeu muita atenção nos últimos tempos em diversas discussões pela internet. Nossa aba de opções deve implementar uma chamada a esta função, mas em breve o WordPress deve implementar um hook para ela.

Sua função é bem direta e simples, remover tudo que foi criado pela função de instalação. Por isso não é possível ligar ela ao ato de “desativar” o plugin, pois o usuário perderia suas preferências a cada vez que fizesse upgrade do WordPress (é recomendado que se desative os plugins para tal).

	public static function desinstalar(){

//Remover bases de dados
$sqlContador = "DROP TABLE `".meuPrimeiroPlugin::$wpdb->prefix."mpp_post_visitas`";
$sqlPalavras = "DROP TABLE `".meuPrimeiroPlugin::$wpdb->prefix."mpp_substituicao`";

meuPrimeiroPlugin::$wpdb->query($sqlContador);
meuPrimeiroPlugin::$wpdb->query($sqlPalavras);

//Remover opções
delete_option("mpp_texto_exonerar");
}

Como podemos ver apenas é feito um DROP nas tabelas e a remoção da opção que foi criada na própria tabela do WordPress.

Função adicionarMenu

Esta função indica ao WordPress que ao montar o menu da administração ele deve inserir uma nova aba que aponta para uma função de nosso plugin.

	public static function adicionarMenu(){
add_options_page('meuPrimeiroPlugin - Gerenciamento','meuPrimeiroPlugin',10,__FILE__,array("meuPrimeiroPlugin","abaOpcoes"));
}

A sintaxe deste comando é a seguinte:

add_menu_page(titulo_da_pagina, titulo_do_menu, nivel_de_acesso, arquivo, [função]);

O nível de acesso diz respeito as permissões do usuário, o arquivo é o arquivo de nosso plugin (__FILE__) e a função é a função de nossa classe em formato de call_user_func

Função abaOpcoes

Esta função é a que setamos no exemplo anterior para ser executada quando o usuário clicar na nossa aba do menu. Neste caso fiz uma implementação simplificada, onde uma mesma função mostra o menu e executa as operações de salvar e atualizar as opções.

Para salvar as opções fazemos inserções usando novamente o $wpdb->query(). Esta operação é executada sempre que o array de POST (dados enviados pelo form) possuir algum conteúdo.

Para mostrar o formulário utilizei uma implementação simplificada de templates, onde tenho um arquivo .tpl externo com o layout do menu e chaves especiais ({PALAVRAS},{STATS}…) que são substituídas pelo conteúdo que quero gerar. Você pode usar outra técnica e até usar código espageti com HTML no meio de seu plugin, depende da sua facilidade e organização. Para gerar o conteúdo dinâmico, faço diversas queries no banco buscando os dados que são necessários.

    public static function abaOpcoes(){

//Predefinidos
$templateVars['{UPDATED}'] = "";
$templateVars['{ERROS}'] = "";

//Executar operações definidas
if (count($_POST) > 0){
$ins = meuPrimeiroPlugin::$wpdb->query("INSERT INTO ".meuPrimeiroPlugin::$wpdb->prefix."mpp_substituicao
(idmpp_substituicao,orig_palavra,subst_palavra)
VALUES
(NULL,'".$_POST['orig']."','".$_POST['subst']."')
");
$templateVars['{UPDATED}'] = '<div id="message" class="updated fade"><p><strong>';
if ($ins){
$templateVars['{UPDATED}'] .= "Dados atualizados!";
}else{
$templateVars['{UPDATED}'] .= "Erro ao atualizar dados!";
}
$templateVars['{UPDATED}'] .= "</strong></p></div>";
}

//Ler arquivo de template usando funções do WP
$admTplObj = new FileReader(meuPrimeiroPlugin::$info['plugin_fpath']."/admin_tpl.htm");
$admTpl = $admTplObj->read($admTplObj->_length);

//pegar palavras
$resultados = meuPrimeiroPlugin::$wpdb->get_results( "SELECT orig_palavra,subst_palavra FROM ".meuPrimeiroPlugin::$wpdb->prefix."mpp_substituicao" );
foreach($resultados as $res){
$palavras .= "<li><b>".$res->orig_palavra." -></b> ".$res->subst_palavra."</li>";
}
$templateVars['{PALAVRAS}'] = $palavras;

//pegar estatisticas
$resultados = meuPrimeiroPlugin::$wpdb->get_results( "SELECT post_title,visitas FROM ".meuPrimeiroPlugin::$wpdb->prefix."mpp_post_visitas
LEFT JOIN ".meuPrimeiroPlugin::$wpdb->prefix."posts AS posts ON mpp_post_visitas.id_post = posts.ID" );
foreach ($resultados as $res){
$stats .= "<dt>".$res->post_title."</dt>";
$stats .= "<dd>".$res->visitas." Visitas</dd>";
}
$templateVars['{STATS}'] = $stats;

//Substituir variáveis no template
$admTpl = strtr($admTpl,$templateVars);

echo $admTpl;

}

Observe o uso da classe FileReader para leitura do arquivo .tpl. Esta classe é nativa do WordPress portanto a preferência de se utilizar ela ao invés de utilizar funções como fopen ou similares. É importante lembrar que o WordPress possui diversas classes disponíveis em suas pastas, e é uma boa idéia ver se existe alguma para executar a operação que você procura.

Função contarVisita

Como foi dito esta função é convocada pelo gancho “the_content” sempre que o conteúdo de um post for resgatado do banco para exibição. Então para fazer uma simples contagem de visualizações de um post, sem entrar em muitos detalhes, filtros por IP nem nada do tipo, apenas fazemos uma inserção no banco, em nossa tabela de contagem.

public static function contarVisita($post_texto){
global $post;

$sql = "INSERT INTO ".meuPrimeiroPlugin::$wpdb->prefix."mpp_post_visitas (id_post,visitas) VALUES ('".$post->ID."',1)
ON DUPLICATE KEY UPDATE visitas=visitas+1";
meuPrimeiroPlugin::$wpdb->query($sql);

return $post_texto;
}

Note neste caso que a função recebe um parâmetro que chamei de $post_texto. Sempre que uma função usa o gancho “the_content” ela receberá o conteúdo do post como parâmetro. Ao final da função este conteúdo, alterado ou não, deve ser retornado com uma chamada return, caso contrário o blog não exibirá o conteúdo do post.

Para o comando de SQL caso interesse usei o ON DUPLICATE KEY UPDATE, que verifica se já existe um registro para o post e faz a atualização do mesmo, caso contrário cria o novo registro. Ela é bem útil para não ser necessário fazer um select para decidir se devemos usar um INSERT ou UPDATE.

Função processarSubstituicao

Esta função, também ligada ao “the_content” efetua a troca das palavras que cadastrarmos, por outras que forem escolhidas. É interessante notar que podemos ter várias funções ligadas a um mesmo gancho e elas serão executadas na ordem que os ganchos são designados, por isso a importância ressaltada na função anterior, onde o parâmetro deve ser retornado no final.

Para fazer a substituição usei um método simples também, busquei no banco os pares (palavra original => nova palavra) e montei um array de “tradução”. Usando a função strtr do PHP eu passo este array e o texto do post e a função se encarrega de fazer a troca e me devolver o texto alterado.

public static function processarSubstituicao($post_texto){

//Montar array de palavras para substituirmos
$resultados = meuPrimeiroPlugin::$wpdb->get_results("SELECT orig_palavra,subst_palavra FROM ".meuPrimeiroPlugin::$wpdb->prefix."mpp_substituicao");

foreach($resultados as $res){
$aTraducao[$res->orig_palavra] = $res->subst_palavra;
}

$post_text = strtr($post_texto,$aTraducao);

return $post_texto;
} 

Função exonerarComentarios

Finalmente esta função será a responsável por incluir um texto ao final do comentário para nos exonerar das palavras do seu autor. Para isto usamos o gancho get_comment_text que é similar ao get_content acima, mas se refere ao comentário.

    public static function exonerarComentarios($cmt_texto){
global $comment;

$anexo = "<br><br><b><i>".get_option('mpp_texto_exonerar').$comment->comment_author."</i></b>";

$cmt_texto .= $anexo;

return $cmt_texto;
}

Como antes, recebemos o texto como parâmetro e devemos retornar ele ao final para evitar quebrar outros plugins ou ocultar comentários .

Nota: Quando desenvolvi meu primeiro plugin de WordPress, usei o gancho get_comment_ID e não fiz o retorno do meu parâmetro ao final. Resultado, todos plugins executados após este quebravam, pois não recebiam um ID e sim uma string vazia.

Usando o contexto global, a variável $comment é um objeto que representa todos os dados do comentário atual, por isso como pode ser visto acima, posso acessar o nome do autor, para agregá-lo à mensagem, que foi buscada da tabela de opções pela chamada get_option. Ao final tudo isso é concatenado ao texto no comentário que segue em frente para outros plugins, ou é simplesmente mostrado.

Código remanescente

Para inicializar nosso plugin o código abaixo é inserido solto em nosso arquivo, para que seja executado diretamente quando o arquivo for incluso, já que tudo que esta no escopo da classe não é executado sem sua instanciação.

$mppPluginFile = substr(strrchr(dirname(__FILE__),DIRECTORY_SEPARATOR),1).DIRECTORY_SEPARATOR.basename(__FILE__);
/** Funcao de instalacao */
register_activation_hook($mppPluginFile,array('meuPrimeiroPlugin','instalar'));
/** Funcao de inicializacao */
add_filter('init', array('meuPrimeiroPlugin','inicializar'));

Nestes ganchos determinamos a execução da função instalar na ativação do plugin e da init na inicialização do WordPress. Para o gancho de ativação definimos a variável $mppPluginFile que determina a pasta onde o plugin esta, e para isso o plugin deve estar em uma sub-pasta de plugin e não na raiz. Com esta combinação de funções e as constantes DIRECTORY_SEPARATOR (barra invertida ou não), e o __FILE__, saimos com algo como “mpp/meuprimeiroplugin.php” ou seja, pasta e arquivo necessários para a detecção de ativação.

Divulgando seu plugin

Para divulgar seu plugin o primeiro e mais importante passo é adicionar ele no repositório do WordPress. Isso é uma excelente ferramenta, pois além de fornecer um repositório SVN que pode lehe ajudar a melhor controlar seu desenvolvimento ele permite que o usuário de seu plugin possa ser notificado de novas versões diretamente na página de plugins.

Divulgue o seu plugin no repositório oficial do WordPress: http://wordpress.org/extend/plugins/ usando o link http://wordpress.org/extend/plugins/add/. A única exigência é que o plugin deve ser licenciado como GPL (detalhes)

Conclusão

Espero que com este artigo (que atrasou mais do que devia) muitos usuários de WordPress e desenvolvedores da comunidade possam embarcar no desenvolvimento de novos plugins e que todos tenham uma noção do poder que o blog oferece permitindo tamanha integração de forma tão simplificada e acessível.

O plugin criado neste exemplo esta 100% funcional e pode até ser usado, mas use-o para aprender e vá muito mais longe. Abaixo deixo os links para download caso lhes interesse.

Com o atraso do artigo estamos na beira do WordPress 2.5, mas tudo indica que além da carinha nova da administração, não haverá impactos no processo descrito acima, e inclusive este exemplo já funciona na nova versão e foi testado aqui com ela.

Download o meuPrimeiroPlugin

não esqueçam: se quiserem agradecer, contribuam com uma graninha ou um presente da lista ao lado….

desenvolvimento, PHP, tutorial, Wordpress

Após muito ponderar sobre a compatibilidade do plugin, tomei uma decisão não radical, mas bem objetiva. Seguindo a filosofia do goPHP5 o BBUInfo não mais suportará a versão 4 do PHP, e trará todas as novidades e melhorias do PHP5 para seu rol de features.

Porque você se pergunta? Durante o atual ciclo de desenvolvimento do plugin fiz algumas mudanças e comecei a observar pontos onde o trabalho de gerar código comptativel com as duas versões estava me custando tempo e performance. Primeiramente o novo foco orientado a objetos do plugin sofreu por não poder utilizar variáveis privadas e publicas, e logo após quando procurava melhorar a verificação por erros no retorno do BB, as funções XML do PHP5 deixaram para trás o PHP4, que me gerava simplesmente muito código extra para realizar as mesmas funções.

Com a introdução da conversão para JSON no retorno do código do BB as funções de codificação do PHP5 simplesmente não se comparam aos “gatilhos” usados no PHP4, então por estes motivos e pensando em futuras melhorias, adeus PHP4.

“eu não tenho PHP5 em meu servidor” tudo bem, o rompimento irá ocorrer de forma menos traumática possível. O que irá acontecer é que o plugin irá sofrer um “branch”, ou seja, seguirá duas linhas. A linha 1.x seguirá com suporte apenas para o PHP5 e com muitas novidades e melhorias, já a família 0.9 seguirá com suporte PHP4, porém receberá apenas a correção de bugs críticos, sem novas funcionalidades, desta forma todos poderão continuar utilizando o plugin, mas quem tiver acesso ao PHP5, terá mais vantagens.

Espero que tenha justificado a alteração sem prejudicar muito os usuários do plugin, e deixo minha recomendação para que migrem de versão o quanto antes, sugira ao seu servidor de hospedagem que migre para o PHP5.

bbuinfo, desenvolvimento, PHP, plugin, Wordpress

O plugin BBUInfo entrou em ciclo de desenvolvimento novamente. Isso significa que retomei o projeto para dar continuidade às alterações planejadas pra a versão 1.0.

Logo após o lançamento o plugin teve um retorno muito positivo com muitos downloads e bastante feedback dos usuários. A avaliação junto ao BlogBlogs foi positiva e logo surgiram ideias novas e possibilidades a serem aproveitadas. Recentemente o plugin foi também aceito no repositório oficial do WordPress, e isso motivou o reinicio das atividades, utilizando o novo servidor de controle de versão e possibilitando um controle melhor do plugin e suas versões. O projeto também foi adicionado ao meu perfil do Ohloh.net como uma forma de dar mais exposição e poder acompanhar alguns dados estatísticos.

Queremos você!

Isso mesmo agora que o plugin entrou no novo ciclo de programação, cujo objetivo final é a versão 1.0 Knuckles, queremos a sua participação, queremos saber o que você quer ver no plugin, que funções, que melhorias, enfim, você dará o rumo. Participe!

Para enviar suas sugestões use um destas formas:

• Deixe um comentário aqui
• Crie uma tarefa no Gerente de Projetos
• Use o formulário de contato

Então visite agora mesmo o sistema de gerenciamento para ver o que já esta sendo planejado e participe ativamente desta nova etapa.

bbuinfo, blogblogs, desenvolvimento, DMS, PHP

Hoje foi escolhido como aniversário oficial do BlogBlogs, após uma breve discussão do Manoel Lemos, dono do site, com si mesmo.

O aniversário conta a partir da data do primeiro post no weblog oficial, mas o Blog blogs tem mais alguns meses encima disso tendo aparecido na internet por volta de Abril. No começo o site apareceu na blogosfera de forma tímida, procurando seu espaço, e conquistando um ou outro blogger que procurava mais uma forma de divulgar seu trabalho, e não cair na imensidão global do ranking do Technorati, o BlogBlogs americano (notem a inversão de papéis).

Pouco tempo depois, o que era apenas um experimento para o Manoel, virou um ponto de refêrencia, várias pessoas fivulgavam o site e participavam, lembro como ontem o dia que fui convidado para ajudar o site, momento no qual desenvolvi um simples plugin, o BBFavs que apresentava os favoritos do BB na lateral de seu blog, um widget na verdade. (abandonado, mas na lista de “to do’s”)

Em plena expansão o site lançou sua versão atualizada e com ela a nova API. Mais uma vez me senti honrado pelo convite que recebi em minha caixa postal, “venha fazer parte da equipe do BB API”. Sem relutar entrei no time, agora organizado com basecamp e metas a cumprir, e comecei o trabalho no que hoje é um grande orgulho.

O Plugin BBUserInfo, lançado dia 3 de julho teve uma enorme aceitação por parte da blogosfera e um retorno muito positivo. Após alguns relatos de bugs, que corrigi rapidamente, o plugin começou a se espalhar pela rede, e volta e meia tenho a agradável surpresa de ver ele instalado em blogs que visito, ou de receber o ocasional trackback com análises do mesmo.

Recentemente o crescimento do BB esta mais uma vez disparado, com o anúncio oficial da montagem de uma equipe concretizada do site as possibilidades são intermináveis. Rápido no gatilho, logo após dizer “eu aceito” no altar, nosso amigo Manoel já recrutou sua esposa como mais nova colaboradora do site, boa sorte a ambos, com o site e com o casamento!

Você ainda não conhece o BlogBlogs? Então visite, conheça e usufrua de seu incrível serviço.

Párabens BlogBlogs!

está é uma resenha NÃO PAGA (não resisti, efeitos da onda de pay-per-post)

bbfavs, bbuinfo, blogblogs, blogosfera

Algum tempo atrás fui procurado por Manuel Lemos, criador do BlogBlogs para participar do projeto BlogBlogs API. O objetivo deste grupo de “figurinhas carimbadas” da blogosfera era grandioso, desenvolver a nova API do BlogBlogs e botar na “rede” novas ferramentas, widgets e diversos recursos para aproximar o BlogBlogs de seus usuários.

Isso foi por torno de 16 de Março, e logo pensei em fazer um plugin que utilizasse os dados de cada usuário e agregasse valor aos comentários dos blogs. Comecei o trabalho mas tive que parar em alguns momentos devido a falta de tempo, mas recentemente retomei o trabalho e hoje apresento os frutos.

Como funciona?

Bem, a ídeia original do plugin era alfo como o gravatar, plugin que através do e-mail da pessoa busca uma imagem de avatar que ele apenas precisa cadastrar uma vez, e o acompanhará sempre. Mas além de um simples avatar decidi aproveitar o potencial do BlogBlogs e acrescentar mais dados que estão lá disponíveis. Com isso abaixo de cada comentário em seu blog, você verá os dados daquele usuário de acordo com o cadastro dele no BlogBlogs, como mostra a imagem:

O que preciso?

Nada além do WordPress e do arquivo zip do plugin. O plugin é compatível com todas versões do PHP e não possui pré-requisitos para conexão como o BlogBlogs, pois usa a mesma biblioteca que o Wordpress para fazé-lo. Além disso é possivel escolher entre duas formas de carregamento, PHP e AJAX.

Utilizando a opção PHP os dados são carregados antes da exibição da página, com isso os dados já estarão carregados junto com a página, porém isso pode atrasar o carregamento da página caso haja alguma demora na comunicação com o BlogBlogs.

A opção AJAX realiza o carregamento após apresentar a página, tirando este peso de processamento, e apresentando efeitos agradáveis de “carregamento” enquanto os dados são carregados, esta é a opção recomendada.

Este plugin não é uma conquista solitária, e contou com o auxilio de algumas pessoas, onde resalto o Manoel Lemos que adaptou a API do BlogBlogs para possibilitar este plugin, Matheus Zeuch que fez a primeira versão da API JavaScript utilizada pelo plugin, e Lourenço Rizzotto que me ajudou com o layout.

Pegue o seu agora!

Bem então, da mesma forma que a apple fez com o iPhone, vou fazer minha jogada de marketing, e agora, com todos vocês em fila aguardando pelo plugin, vou abrir as portas da loja e ver 500 mil downloads em dois dias!… tá, tá bom, mas é permitido sonhar não é?

Para verem mais informações sobre o plugin, como seu processo de instalação e para relatar problemas e pedir ajuda, acessem o Gerenciador de Projetos da DMS Systems

Para ir direto ao download do arquivo cliquem aqui: Download

Gostou deste plugin? Então retribua, escreva um post e deixe seu trackback, obrigado!

bbuinfo, DMS, PHP, plug-in, Wordpress

Como já era de se esperar a estréia do Google Code Search trouxe inúmeras novas oportunidades de crackers buscarem obter informações como senhas de sites alheios.

Em forma de pesquisa algumas pessoas buscaram obter acesso a senhas alheias utilizando expressões regulares no code search. No exemplo foi utilizada uma busca que retorna senhas de banco de dados de blogs do tipo wordpress.

Não! o Google não cometeu uma falha e esta indexando de alguma forma arquivos de configuração, como já demostrei arquivos .php não mostram seu código fonte na web. O problema esta um pouco mais além e na verdade é culpa de más práticas de desenvolvedores.

Como fugir destes problemas?

1. Não user arquivos .inc para configurações – ok esta é velha mas vale ainda, se você utilizar um arquivo desta extesão ele é indexado e visto como um arquivo de texto, use sempre .inc.php ou .inc.asp

2. Não armazene cópias em arquivos ZIP – Não só zip como qualquer outra forma de arquivo compactado, por um motivo simples, são estes arquivos que o Google Code Search esta indexando e disponibilizando em sua busca, ou seja, se vc tiver um backup do seu site em zip guardada lá e o google achar… sua configuração esta exposta.

Esta são duas dicas básicas que na verdade já deviam valer antes do Code Search, mas fica ai a recomendação para que não tenham problemas. Alguns comentpários já estao por aqi com string para busca de senhas em ASP e outras linguagens.

google, Segurança, Tecnologia/Web, Wordpress

Com a publicação da API pública do BlogBlogs se tornou possível desenvolver plugins para utilizar os dados de lá em seus blogs, com este widget você poderá listar em sua página uma lista dos seus favoritos (do site BlogBlogs.com.br), sincronizada com qualquer atualização que for feita.

O que é um widget?
Um widget é um componente desenhado para funcionar com o plug-in do Wordpress chamado: Sidebar Widgets. O plug-in é simples, ele possibilita, nos temas compatíveis, que você facilmente adicione/remova elementos da barra lateral de seu blog, como RSS, Posts e etc…

Como instalar
1. Confira a instalação e ativação do Sidebar Widgets
2. Faça o Download do BB-Favs
3. Copie o arquivo bb-favs.php para a pasta /wp-content/plugins/widgets/ e faça upload para seu servidor
4. Vá até a opção “Plugins” no Wordpress e ative o plugin: BlogBlogs – Favoritos
5. Entre em “Presentation” e escolha a opção “SideBar Widgets”
6. Arraste a caixa “BlogBlogs Favs” para a lista de widgets na posição que deseja posicionar
7. Clique na imagem da caixa e abra a tela de configuração
8. Digite um título
9. Digite seu nome de usuário no BlogBlogs
10. Insira sua API key do BlogBlogs (veja como obter sua key)

Pronto, salve as alterações e confira seu Blog, agora os seus favoritos do BlogBlogs são listados na lateral.

Download
Demo: Confira na minha barra lateral BB Favs

bbfavs, blogblogs, PHP, plug-in, Tecnologia/Web, Wordpress