Back-End

6 out, 2009

O mecanismo de opções do WordPress

Publicidade

Alguns plugins WordPress permitem serem customizados. Essas customizações devem ser persistentes e a melhor forma de se fazer isso é armazenar as opções definidas pelos usuários no banco de dados do WordPress.

O WordPress tem um mecanismo para salvar, atualizar, excluir e resgatar dados nomeados como opções. Os valores dessas opções podem ser strings, arrays ou objetos PHP. Esses dados serão serializados ou convertidos para string antes de serem armazenados e deserializados quando resgatados.
 

As opções devem ter nomes únicos para evitar conflitos com o WordPress e outros plugins. A sugestão é adotar prefixo nos nomes de suas opções. Por exemplo, prefixo_nome_opção.

Funções para trabalhar com o mecanismo de opções do WordPress

Há quatro funções básicas para se trabalhar com o mecanismo de opções no WordPress. Vejamos

  • add_option()

  • add_option( $nome, $valor, $desuso, $autocarregamento );
  •  get_option()get_option( $nome ); 
  • update_option() update_option( $nome, $novo_valor );
  • delete_option()
  • delete_option( $nome );

A função add_option() cria uma nova opção com o nome informado em $nome. Se alguma opção
com o mesmo nome existir, nada será feito. Em $valor é informado o que
será armazenado. O terceiro parâmetro não é utilizado. O quarto
parâmetro, $autocarregamento, é opcional; se usado, deverá ser informado
“yes” ou “no”. Quando informado “yes”, a opção será carregada pela função
get_alloptions() e guardada em cache. Atente-se que, para informar o
quarto parâmetro, é necessário um valor vazio para o terceiro. Observe:

add_option( ‘prefixo_nome_opcao’, ‘algum valor’, ”, ‘no’ );

O valor
padrão do quarto parâmetro da função add_option() é “yes”.

Uma vez criada a função, você pode resgatá-la
através da função get_option(). Informando como parâmetro o nome da opção que criara.

A função update_option() é especial. Uma vez
que, além de atualizar a opção desejada, ele a cria, caso ela não exista.
O que significa dizer que você pode usar a função update_option() no
lugar de add_option(), caso não precise usar o terceiro e quarto
parâmetro dessa última.

Para atualizar uma opção basta
informar o nome da opção e seu no valor utilizando para isso o primeiro
e segundo parâmetro respectivamente da função update_option().

Se
uma opção não faz mais sentido, exclua. A função delete_option() tem
esse propósito. Utilize-a informando o nome da opção desejada como
parâmetro.

Página de opções na administração do WordPress

Podemos criar páginas de opções na administração do WordPress seguindo seu padrão ou criando algo totalmente personalizado. Ao seguir o padrão do WordPress, temos duas possibilidades: um padrão utilizado até a versão 2.7 e outro posterior a ela. Nos próximos artigos conheceremos ambas opções, a forma de uso e questões de segurança relacionadas a elas.

Até lá e um forte abraço.