A forma mais comum de fazer isso, é usando o serviço cron (em ambientes Unix), ou o agendador de tarefas (no Windows). Embora ambos funcionem bem, existe uma alternativa, que é usar o próprio WordPress para isso.

Como fazer

Para agendar uma tarefa, existe uma função chamada wp_schedule_event(). Uma chamada típica dessa função seria da seguinte forma:

<?php
wp_schedule_event(time(), 'hourly', 'hook');
add_action('hook', 'funcao_agendada');
?>

Isso agendaria a função “funcao_agendada()” para ser executada de hora em hora, na hora atual.

O primeiro parâmetro informa a hora de agendamento. Como passamos time(), que se traduz na hora atual, o WordPress usará esse valor como hora. O segundo parâmetro é a frequência, que pode ser hourly, daily ou twicedaily (respectivamente de hora em hora, diariamente, ou duas vezes por dia). E por último, o nome de uma “action”, que indicará a função a ser executada.

Para remover o agendamento, a chamada é feita a wp_clear_schedule_hook(), passando como parâmetro somente o nome do hook utilizado (no caso, “hook”).

Um detalhe é que essa função deve ser chamada uma única vez, por isso, pode ser conveniente colocá-la dentro de um plugin, e executar o agendamento na ativação, e remover o agendamento na desativação.

Uma outra forma de se agendar, sem usar plugins, é usar a função wp_next_scheduled() para checar se o evento já foi agendado, da seguinte forma:

<?php
add_action('meu_evento', 'funcao');
function ativacao() {
    if (!wp_next_scheduled('meu_evento')) {
        wp_schedule_event(time(), 'hourly', 'meu_evento');
    }
}
 
add_action('wp', 'ativacao');
 
function funcao() {
    // isso executará de hora em hora
}
?>

Assim, caso o evento não esteja agendado, o WordPress se encarregará de agendá-lo.

As vantagens

A principal vantagem é que o agendamento fica independente de qualquer coisa externa. Tudo fica gerenciado pelo próprio WordPress, e numa eventual mudança de servidor, não haveria necessidade de se preocupar com as tarefas agendadas.

As desvantagens

Como não temos um daemon pra verificar a hora, e chamar as tarefas, dependemos de um visitante (humano ou não) pra executar as tarefas. Em cada acesso ao site, o WordPress checa se existe alguma tarefa que já deveria ter sido executada. Caso exista, ele executa. Simples assim.

Um problema nisso é que não há garantia de que a tarefa será executada precisamente no horário agendado, mas sim, no primeiro acesso após esse horário (que pode ser segundos, num site muito visitado, ou minutos/horas em um site com quase nenhum acesso).Caso a rotina que se queira agendar seja sensível a hora, é melhor usar os métodos convencionais.

Conclusão

Usar a funcionalidade de agendamento do WordPress pode ser uma boa alternativa, principalmente quando não há preocupação com o “quando” a tarefa será executada, ou quando não se tem acesso aos sistemas de agendamento do servidor, o que pode ser comum em ambientes compartilhados.

Artigos relacionados

• Removendo o “generator” do Wordpress
• Escrevendo plugins para o Wordpress
• Evitando SQL injection em PHP
• Criando CAPTCHAs em PHP
• Pegadinhas no PHP
• Otimização em PHP, parte 1: Minify
• Precedência no PHP
• Imprimindo em formulários contínuos em PHP
• XML no PHP com XML_Serializer, parte 2 de 2
• XML no PHP com XML_Serializer, parte 1 de 2
• Envio de emails em PHP
• Validação de dados em PHP
• Segurança no envio de emails em PHP

<meta name="generator" content="WordPress 2.8.4" />

Muita gente não gosta de anunciar para o mundo a versão usada. Seja por não querer exibir o uso do WordPress, ou por medo de alguem usar essa informação para um possível ataque contra essa versão específica do WordPress, existe uma forma muito simples de retirar isso do cabeçalho, sem precisar editar os arquivos do sistema (que a priori, nunca devem ser editados).
Essa tag é inserida no cabeçalho através de uma action padrão, chamada wp_generator. Para não exibir, basta remover a action, adicionando o seguinte código no functions.php do seu tema:

<?php
remove_action('wp_head', 'wp_generator');
?>

Pronto, com isso o seu site não irá mais exibir esta tag no cabeçalho.

Artigos relacionados

• Agendando eventos no WordPress
• Escrevendo plugins para o Wordpress
• Evitando SQL injection em PHP
• Criando CAPTCHAs em PHP
• Pegadinhas no PHP
• Otimização em PHP, parte 1: Minify
• Precedência no PHP
• Imprimindo em formulários contínuos em PHP
• XML no PHP com XML_Serializer, parte 2 de 2
• XML no PHP com XML_Serializer, parte 1 de 2
• Envio de emails em PHP
• Validação de dados em PHP
• Segurança no envio de emails em PHP

Criando um plugin

Neste artigo, vamos mostrar o passo a passo da criação de um plugin simples, que visa guardar em uma tabela o número de visualizações de cada post do blog. Só isso. Não teremos gráficos, tabelas, nada do tipo. Apenas vamos guardar os dados, que podem ser utilizados por uma outra ferramenta qualquer.
O objetivo não é apenas mostrar como se criar um plugin. A partir deste esqueleto, adicionar mais funcionalidades fica mais fácil.

O cabeçalho do plugin

Antes de mais nada, logo no início precisamos ter um cabeçalho no arquivo do plugin que informará ao WordPress algumas informações, como nome do plugin, uma descrição, autor, versão, e outras coisas. É importante ter isso bem definido.
Essas informações entram em um comentário logo no início do arquivo. No nosso caso, teremos o seguinte:

<?php
/*
Plugin Name: View Counter
Description: Increments a counter each time a post is viewed
Version: 1.0
Author: Bruno Lustosa
Author URI: http://www.ataraxia.com.br/
*/

Pronto, já temos aí o nome do plugin (View Counter), uma breve descrição do que ele faz, a versão, o nome do autor e a URL do autor, para referência. O WordPress exibe essas informações na página dos plugins na área administrativa. Coloquei as informações em inglês, pois a interface administrativa deste blog está toda em inglês.

Os hooks

Entenda os hooks como ações onde você pode criar um callback. Ou seja, sempre que determinada ação for executada no WordPress, uma função definida por você será chamada. No nosso caso, vou definir 2 hooks e uma ação (a ação é parecida com o hook, mostrarei a diferença logo abaixo).

// Hooks
register_activation_hook(__FILE__, "viewcounter_activate");
register_deactivation_hook(__FILE__, "viewcounter_deactivate");
add_action('save_post', 'viewcounter_insert');

O primeiro hook determina que a função viewcounter_activate() será executada quando o plugin for ativado. Esta função cuidará da criação da tabela, caso necessário. Da mesma forma, o segundo hook executará viewcounter_deactivate(), que destruirá nossa tabela, para deixar o sistema limpo como estava antes da ativação. É sempre uma boa prática remover o que criamos após a desinstalação.
A ação é bem semelhante ao hook, e no caso, executará a função viewcounter_insert() assim que um post for salvo. Esta função irá inserir uma linha em nossa tabela, definindo o número de leituras como sendo zero.

Nossa tabela

Iremos criar uma tabela bem simples para guardar as nossas informações. Tudo que precisaremos, é de um campo para guardar o ID do post, e outro pra guardar o número de visualizações. Sim, poderíamos alterar a tabela de posts e adicionar um campo com o número de visualizações, porém, prefiro não mexer em tabelas do sistema, para evitar problemas de compatibilidade futura (vai que uma versão futura do WordPress possui um campo com esse mesmo nome?).
O comando para a criação da tabela:

CREATE TABLE viewcounter (
    post_ID INT NOT NULL PRIMARY KEY,
    views INT NOT NULL DEFAULT 0
);

O hook de ativação

Com a definição da nossa tabela em mãos, vamos partir para a função de ativação do plugin. Ela será executada uma única vez, quando o administrador ativar o plugin.
Nossa função, por segurança, irá checar se a tabela que queremos criar já existe, para evitar erros. A checagem usará o comando SQL SHOW TABLES.
A função ficará assim:

function viewcounter_activate() {
 
    global $wpdb, $viewcounter_table;
 
    if ($wpdb->get_var("SHOW TABLES LIKE '{$viewcounter_table}'") != $viewcounter_table):
        $wpdb->query("CREATE TABLE {$viewcounter_table} (post_ID INT NOT NULL PRIMARY KEY, views INT NOT NULL DEFAULT 0)");
    endif;
 
} // viewcounter_activate

Note que temos duas variáveis globais. A primeira, $wpdb, é do próprio WordPress, e é usada para acessar o banco de dados e executar queries. A segunda, foi definida por nós, e contem o nome da tabela que usaremos. Lembra, que durante a instalação do WordPress, ele te pediu um prefixo para as tabelas? Ao invés de deixarmos um nome fixo, é sempre bom definir o nome da tabela usando este prefixo.
Assim, esta segunda variável global foi definida fora da função, da seguinte forma:

global $viewcounter_table;
$viewcounter_table = "{$wpdb->prefix}viewcounter";

Resumindo, se você definiu o prefixo para as tabelas do WordPress como wp_, então nossa tabela se chamará wp_viewcounter. Isso é especialmente importante caso seu plugin seja usado em um sistema multi-usuário, como o WordPress MU.

A desativação

Bem semelhante à nossa função de ativação, temos a função que será executada quando o plugin for desativado. A idéia aqui é limpar tudo que fizemos, deixando o sistema como estava antes. Para tanto, basta destruir a nossa tabela.

function viewcounter_deactivate() {
 
    global $wpdb, $viewcounter_table;
 
    $wpdb->query("DROP TABLE {$viewcounter_table}");
 
} // viewcounter_deactivate

Simples assim. Desativou o plugin, destruiu a tabela.

Quando salvamos o post

Assim que um post é salvo, temos a função viewcounter_insert() que será chamada, tendo como parâmetro o ID do novo post. Esta função deve inserir uma linha em nossa tabela, indicando que esse novo post teve 0 visualizações até o momento, o que é lógico, pois ele acabou de ser criado.
A função também fica bem simples:

function viewcounter_insert($post_ID) {
 
    global $wpdb, $viewcounter_table;
 
    $wpdb->query("INSERT INTO {$viewcounter_table} (post_ID, views) VALUES ({$post_ID}, 0)");
 
} // viewcounter_insert

A contagem propriamente dita

E por último, temos a contagem das visualizações. Para tanto, teremos uma função chamada viewcounter_update(), que receberá como parâmetro o ID do post a ser atualizado. Para conveniência, essa função também irá retornar o número atualizado de visualizações que o post teve, que poderá ser usado no template em algum lugar.
Esta função tem algumas checagens extras que são feitas por segurança. Por exemplo, caso um post antigo seja visualizado, precisaremos rodar a função que cria a linha para o post, pois como ele foi criado antes da ativação do plugin, o hook anterior não foi chamado.
A função pode ficar assim:

function viewcounter_update($post_ID) {
 
    global $wpdb, $viewcounter_table;
 
    if (is_null($wpdb->get_var("SELECT views FROM {$viewcounter_table} WHERE post_ID = {$post_ID}"))):
        viewcounter_insert($post_ID);
    endif;
    $wpdb->query("UPDATE {$viewcounter_table} SET views = views + 1 WHERE post_ID = {$post_ID}");
 
    return $wpdb->get_var("SELECT views FROM {$viewcounter_table} WHERE post_ID = {$post_ID}");
 
} // viewcounter_update

A primeira query checa se o retorno é vazio, e caso seja, chama a função viewcounter_insert() para inserir uma linha com 0 visualizações. Em seguida, executa um update incrementando em 1 o número de visualizações. E por último, retorna o número atual de visualizações do post.

Atualizando

Tudo que faltou agora, é indicar o ponto onde viewcounter_update() deve ser chamada. Na hierarquia dos templates, o ponto ideal para colocarmos nossa chamada é no arquivo single.php.
Bastaria uma simples chamada como:

<?php
$num = viewcounter_update($post->ID);
?>

E já teríamos o banco atualizado (claro, supondo que temos em $post o objeto com o post). Caso queiramos exibir o número atual de visualizações, podemos utilizar a variável $num em qualquer ponto do template para mostrar ao usuário quantas vezes aquele post foi visto.

Conclusão

Este foi apenas um exemplo, bem tosco, de como criar um template para o WordPress. É claro que ele pode ser melhorado, e muito. Inclusive, aceito sugestões nos comentários.
Estou disponibilizando um arquivo com este plugin, para quem quiser baixar e experimentar.

Artigos relacionados

• Agendando eventos no WordPress
• Removendo o “generator” do Wordpress
• Evitando SQL injection em PHP
• Criando CAPTCHAs em PHP
• Pegadinhas no PHP
• Otimização em PHP, parte 1: Minify
• Precedência no PHP
• Imprimindo em formulários contínuos em PHP
• XML no PHP com XML_Serializer, parte 2 de 2
• XML no PHP com XML_Serializer, parte 1 de 2
• Envio de emails em PHP
• Validação de dados em PHP
• Segurança no envio de emails em PHP