Como usar os Custom Fields do WordPress

• Tweet
• Sharebar

• Tweet

Há uns tempos atrás escrevi um artigo sobre o campo de excerpt do wordpress e como podes dar outro valor ao teu blog usando esse campo.

Para além do campo Excertp o WordPress permite criar os chamados «custom fields». Estes são campos, que podes definir, que permitem adicionar mais conteúdo no teu blog seja ele texto, imagem, flash, etc…

Criar um custom field no WordPress

Os custom fields são incrivelmente simples de criar. Depois deste tutorial vais saber usa-los mesmo sem saberes nada sobre programação.

1. Vamos começar por abrir o WordPress como se fossemos escrever um post. Podes escrever o post normalmente se quiseres.
2. Navega pela página até encontrares um separador chamado «Custom Fields» e clica nele para abrires essa secção.
3. A primeira coisa com que te deparas é que tens de criar uma chave (key). Podes escolher essa key através de um dropdown menu ou defini-la por ti mesmo. Este será o nome do nosso custom field.
4. Agora tens uma caixa de texto chamada «Value» onde vais inserir o conteúdo da Key que definiste.
5. Assim que tiveres o teu «custom field» como queres basta carregares no botão «Add Custom Field» para o guardares.

Neste caso criei um custom field chamado «mensagem» onde defini um texto como mensagem. Caso quisesses usar uma imagem colocarias o endereço da imagem na caixa de texto chamada «Value».

O teu custom field está pronto no entanto ao guardar ou publicar o post o custom field não vai aparecer. Para isso vais ter de editar o theme e inserir algum código.

Como mostrar Custom Fields

Antes de continuar é preciso alertar que o custom field é um campo associado aos posts o que significa que ele apenas será mostrado nos posts que definires o valor do custom field. Não poderá ser usado como uma forma global de passar uma mensagem.
Se reparares bem nas tags associadas aos custom field todas elas estão relacionadas com posts.

Para mostrares o teu custom field é relativamente simples:

1. O código pode ser inserido a onde desejares no código, contudo para o mostrares num post é preciso procurares a seguinte linha:

   if (have_posts()) : while (have_posts()) : the_post();

2. Depois de encontrares a linha onde é feita a verificação se existem posts basta colocares a seguinte linha onde quiseres.

   <?php echo get_post_meta($post->ID, 'nome do custom field', TRUE); ?>

Este código mostra o VALUE que definiste para a KEY MENSAGEM.

Como mostrar uma imagem com Custom Fields

Caso quisesses usar uma imagem o VALUE seria o endereço da imagem.

<img src=”<?php $img = get_post_meta($post->ID, ‘nome do custom field’, true); ?>” alt="< ? the_title() ?>" title="< ? the_title() ?>" />


Como é sempre bom definir os atributos alt e title das imagens, usei o titulo do post para os criar automáticamente.

Explicação da função

Neste caso usamos a função get_post_meta:

$post->ID – Este código vai buscar o ID do post. O ID é a chave primária que nunca será repetida. Ou seja todos os posts têm um ID única.

nome do custom field – Não é preciso muita explicação, é a Key que definiste. Usando o exemplo em cima onde criei um custom field chamado mensagem. O nome do custom field será mensagem.

Exemplo:
<?php echo get_post_meta($post->ID, 'mensagem', TRUE); ?>

TRUE / FALSE – Neste caso coloquei TRUE. Ao colocares este ultimo parametro como TRUE a função vai-te devolver apenas 1 resultado. Ao colocares em FALSE vai devolver um vector (array) de resultados.

Existem mais algumas funções que permitem trabalhar com custom fields / campos personalizados dos posts como é o caso get_post_custom que permite buscar toda a informação dos custom fields de um post, get_post_custom_keys que vai buscar o nome de todas as keys dos custom fields ou get_post_custom_values que vai buscar todos os valores de uma determinada key no post.

Para ficares a saber um pouco mais sobre os custom fields do WordPress aconselho-te a ler a documentação oficial dos custom fields.

6 Comments + Add Comment

• SEO para WordPress | MUIOMUIO.NET 11 de Fevereiro de 2009 às 10:58

  [...] podes ver existe uma linha que usa um Custom Field que tens de definir no post. Partilha esta [...]

  Responder
• 
  PiqueT 5 de Abril de 2009 às 12:59

  Boa dica!
  Estava mesmo à procura de algo que explicasse as variáveis.
  Cumps

  Responder
• INSIC WP - Free Wordpress Theme | MUIOMUIO.NET 14 de Abril de 2009 às 9:29

  [...] um layout “Magazine Style”. Para apresentar imagens na homepage é necessário criar um custom field chamado “Thumbnail” (é necessário começar com maiúscula visto ser case sensitive) e [...]

  Responder
• 
  Fábio 8 de Novembro de 2009 às 19:34

  Dá pra fazer um while com os valores dos campos personalizados? Por exemplo, possuo um campo de nome “sigla” e preciso listar as siglas…

  Responder
  • 
    Mario Andrade 8 de Novembro de 2009 às 19:45

    Boa pergunta, nunca experimentei mas não vejo razão para não dar. Mas sinceramente não o sei fazer.

    Responder
• 
  Yuriregis 8 de Julho de 2011 às 16:36

  e como ativa-ló no wordpress? atualizei para a versão 3.2 e não tem mas essa opção… quero inserir no meu wordpress qual seria o plugin???

  Responder