Como criar tags de modelos personalizados para WordPress

Construir um tema WordPress é tão fácil com tags de modelo. Você pode adicionar o título() para exibir o título da postagem ou da página, e você pode usar o conteúdo() para exibir o conteúdo da postagem ou da página. Existem muitas tags de template no WordPress que podemos usar para exibir outras coisas.

Mas quando se trata de exibindo apenas coisas específicas no seu tema, você pode querer crie sua própria tag de modelo. No tutorial de hoje, vamos orientá-lo nesse processo não muito complicado. Vamos começar com os fundamentos.

Tag básico do modelo

Se você der uma olhada nas fontes do WordPress Core, você verá que uma tag de template é basicamente uma função PHP executando um conjunto de códigos com alguns parâmetros.

Para criar sua própria tag de template, você pode escrever uma função PHP em functions.php dentro do diretório do seu tema, por exemplo.

 function my_template_tag () echo 'Este é o meu modelo';  

Então, nos seus outros arquivos de tema, digamos, single.php ou page.php, você pode adicionar a função, assim.

Isto irá mostrar o 'Este é o meu modelo' que é ecoado dentro do my_template_tag () função.

Criar um template para WordPress é realmente simples. Tudo bem, vamos agora dar uma olhada em um exemplo um pouco mais avançado.

Tag do modelo de contagem de visualizações de página

Neste exemplo, vamos criar um modelo que mostrará contagem de visualizações para cada post e página.

Primeiro, instalar e ativar o WordPress.com Stat no Jetpack. E certifique-se de ter conectado o Jetpack ao WordPress.com. A razão pela qual usamos o WordPress.com Stat é que o Visão os dados serão armazenados no WordPress.com, e não em nosso próprio banco de dados. Isso poderia economizar na carga do nosso servidor.

Crie uma função no seu funções.php nomeado a vista(), igual a:

 function the_view ()  

Colocaremos a função (a tag template) em uma página ou post, então precisamos pegar a página e postar o número da ID. Isso pode ser recuperado usando get_the_ID ();.

 function the_view () $ id = get_the_ID ();  

Podemos então usar uma função para recuperar o número de visualizações do WordPress.com Stats usando stats_get_csv ();. Esta função aceita vários parâmetros (encontre a lista completa aqui).

No nosso caso, precisamos adicionar o dias, que especificam o intervalo de tempo da contagem de visualizações e post_id.

 function the_view () $ id = get_the_ID (); $ page_view = stats_get_csv ('postviews', 'dias = -1 & post_id ='. $ id. "); 

No código acima, desde que definimos o dias parâmetro para -1, Recuperaremos a contagem de visualizações da ID de postagem fornecida desde o início, a partir de quando o plug-in do WordPress.com estiver ativado.

Assim que tivermos o número, precisamos apenas ecoá-lo, como segue.

 function the_view () $ id = get_the_ID (); $ page_view = stats_get_csv ('postviews', 'dias = -1 & post_id ='. $ id. "); echo $ page_view [0] ['vistas']; 

É isso, nossa nova tag de modelo para exibir a contagem de visualizações de página está concluída. Você pode em qualquer lugar em page.php ou single.php. Por exemplo:

Se você tiver alguma dúvida, sinta-se à vontade para colocá-las na seção de comentários abaixo.