Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress
Code

Tuts + O Guia para Tags de Template: Primeiro Lote

by
Difficulty:BeginnerLength:MediumLanguages:
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: Introduction
The Tuts+ Guide to Template Tags: Second Batch

Portuguese (Português) translation by João Fagner (you can also view the original English article)

Na primeira parte da série, demos uma olhada no que são tags de template, onde eles podem ser encontrados, como eles funcionam e como usá-los.

Nesta segunda parte, vamos passar o primeiro lote de quase 200 tags de template. Durante todo o tutorial, vamos ver as tags de template sobre dados de post: títulos, datas, conteúdos e outros meta-dados.

Pegando & Exibindo o conteúdo do Post: get_the_content()the_content()

Talvez sejam as tags de template mais populares de todos os tempos: essas tags de template dão um echo no conteúdo do post.

Parâmetros

Ambas as tags de template aceitam dois parâmetros:

  • $more_link_text (string—opcional):
    Texto para substituir o texto padrão "(more...)".
    (Padrão: "(more…)")
  • $strip_teaser (boolean—opcional):
    Tira o texto do teaser.
    (Padrão: FALSE)

Uma nota sobre "teaser text": você sabia que existe uma tag,  <!--noteaser--> para tornar o conteúdo antes de um texto <!--more--> de "teaser text" que não mostra essa parte em um post único da página mesmo se $strip_teaser estiver definida como FALSE. Certamente não sabiam! Mas não é completamente desconhecida— aqui tenha um post de 2009.

Uso

Obtendo & Exibindo o Conteúdo do Post para Feeds: get_the_content_feed() & the_content_feed()

Estas tags de template obtém e exibem o conteudo do feed

Parâmetros

Ambas as tags de template aceitam somente um parâmetro:

  • $feed_type (string—opcional):
    Tipo de feed.
    (Padrão: Padrão feed type)

Uso

Obtendo & exibindo o Resumo do Post: get_the_excerpt() & the_excerpt()

Estas tags de template buscam e exibem o resumo do post.

Parâmetros

Estas tags de template não aceitam quaisquer parâmetros.

Uso

Exibindo o Resumo do Post para Feeds: the_excerpt_rss()

Esta tag de template faz com que o resumo do post fique pronto para exibir os feeds.

Parâmetros

Esta tag de template não aceita quaisquer parâmetros.

Uso

Obtendo & Exibindo o Título do Post: get_the_title() & the_title()

Estas tags de template permitem retornar ou da echo no título de seus posts.

Parâmetros

get_the_title() aceita três parâmetros:

  • $post_ID (integer or object—opcional):
    O ID do post.
    (Padrão: Current post (Post atual))

the_title() aceita três parâmetros:

  • $before (string—opcional):
    O texto ou código em HTML para ser exibido antes da saída.
    (Padrão: Empty (Vazio))
  • $after (string—opcional):
    O texto ou código em HTML para ser exibido após a saída.
    (Padrão: Empty (Vazio))
  • $echo (boolean— opcional):
    Echo (TRUE) ou retorna a tag (FALSE).
    (Padrão: TRUE)

Uso

Obtendo & Exibindo o Título do Post "Escaped": the_title_attribute()

Esta tag de template leva seus títulos de post e prepara para ser usado em valores de atributo em HTML. Consulte o exemplo para obter mais explicações.

Parâmetros

Esta tag de template aceita apenas um parâmetro:

  • $args (array—opcional):
    Um array dos seguintes argumentos:
    • 'before' (string): Código em HTML para adicionar antes da saída.
      (Padrão: Empty (Vazio))
    • 'after' (string): Código HTML para adicionar após a saída.
      (Padrão: Empty (Vazio))
    • 'echo' (boolean): Da echo na tag de template ou não.
      (Padrão: TRUE)
    • 'post' (object): Objeto do Post atual para pegar o título de.
      (Padrão: 0)

Uso

Vamos usar este título como exemplo:

Bill e Melinda Gates gastam bilhões na caridade, diga "Nós fizemos"???

O título tem duas citações e um 'é' comercial (&) que irá estragar seu código HTML, se usado dentro de um atributo HTML, porque atributos também são encapsulados com aspas duplas de citações. Isso é onde the_title_attribute() vem a calhar:

Agora o atributo title  (título) do link que é parecido com este:

Bill &amp; Melinda Gates gastam bilhões para caridade, diga &quot;Nós fizemos???&quot;

Dessa maneira isso não vai atrapalhar o HTML com escape cotações e o "&" comercial.

Exibindo o Título do Post para Feeds: the_title_rss()

Esta tag de template obtém seu título, torna pronto para ser exibido no feeds.

Parâmetros

Esta tag de template não aceita quaisquer parâmetros.

Uso

Obtendo & Exibindo a Data do Post: get_the_date() & the_date()

Estas tags de template buscam da um echo na data do post.

Parâmetros

get_the_date() aceita dois parâmetros:

  • $date_format (string—opcional):
    O Formato da Data.
    (Padrão: Formato de Data é definido na página de Opções Gerais na área admin do WordPress)
  • $post_ID (integer or object—opcional):
    O ID do post.
    (Padrão: Current post (Post atual))

O the_date() aceita quatro parâmetros:

  • $date_format (string—opcional):
    O formato da data.
    (Padrão: Formato de data é definido na página Opções Gerais na área admin do WordPress)
  • $before (string—opcional):
    O texto ou código em HTML para ser exibido antes da saída.
    (Padrão: Empty (Vazio))
  • $after (string—opcional):
    O texto ou código HTML para ser exibido após a saída.
    (Padrão: Empty (Vazio))
  • $echo (boolean—opcional):
    Echo (TRUE) ou retorna a tag (FALSE).
    (Padrão: TRUE)

Uso

Obtendo & Exibindo a Data do Post no Formato ISO 8601: the_date_xml()

Estas tags de template retornam e exibem a data de um post no formato ISO 8601.

Parâmetros

Esta tag de template não aceita quaisquer parâmetros.

Uso

Obtendo & Exibindo a Hora do Post: get_the_time() & the_time()

Estas tags de template retornam ou exibem a hora do post.

Parâmetros

get_the_time() aceita dois parâmetros:

  • $time_format (string—opcional):
    O formato do tempo.
    (Padrão: formato de tempo é definido na página Opções Gerais na área admin do WordPress)
  • $post_ID (integer ou object—opcional):
    O ID do post.
    (Padrão: Current post (Post atual))

O the_time() aceita somente um parâmetro:

  • $time_format (string—opcional):
    O formato do tempo.
    (Padrão: formato de tempo é definido na página Opções Gerais na área admin do WordPress)

Uso

Obtendo & Exibindo o Nome do Autor: get_the_author() & the_author()

Estas tags de template obtém ou exibem o nome do autor do post.

Parâmetros

Estas tags de template não aceitam quaisquer parâmetros.

Uso

Exibindo Todos os Meta Dados do Post: the_meta()

Esta tag de template lista todos os meta dados do post com uma lista não ordenada.

Parâmetros

Esta tag de template não aceita quaisquer parâmetros.

Uso

Obtendo & Exibindo a Data de Modificação do Post: get_the_modified_date() & the_modified_date()

Essas tags de template pegam e dão um echo na última data de modificação do post.

Parâmetros

get_the_modified_date() aceita somente um parâmetro:

  • $date_format (string—opcional):
    O formato da data.
    (Padrão: Formato de data é definido na página Opções Gerais na área admin do WordPress)

the_modified_date() aceita quatro parâmetros:

  • $date_format (string—opcional):
    O formato da data.
    (Padrão: Formato de data é definido na página Opções Gerais na área admin do WordPress)
  • $before (string—opcional):
    O texto ou código em HTML para exibir antes da saída.
    (Padrão: Empty (Vazio))
  • $after (string—opcional):
    O texto ou código em HTML para exibir após a saída.
    (Padrão: Empty (Vazio))
  • $echo (boolean—opcional):
    Echo (TRUE) ou retorna uma tag (FALSE).
    (Padrão: TRUE)

Uso

Obtendo & Exibindo a Hora de Modificação do Post: get_the_modified_time() & the_modified_time()

Estas tags de template buscam a saída e o tempo de modificação do post.

Parâmetros

Ambas as tags de template aceitam somente um parâmetro:

  • $time_format (string—opcional):
    O formato do tempo.
    (Padrão: Formato de tempo é definido na página Opções Gerais na área admin do WordPress)

Uso

Obtendo & Exibindo o Autor e Quem Editou o Post Atual: get_the_modified_author() & the_modified_author()

Estas tags de template buscam e exibem o autor que modificou o post pela última vez.

Parâmetros

Estas tags de template não aceitam quaisquer parâmetros.

Uso

Obtendo & Exibindo uma Lista de Páginas Paginada por Posts: wp_link_pages()

Você pode dividir suas postagens em páginas usando <!--nextpage--> e esta tag de template ajuda a listar as páginas.

Parâmetros

Esta tag de template aceita apenas um parâmetro:

  • $args (array—opcional):
    Um array dos seguintes argumentos:
    • 'before' (string): código em HTML para adicionar antes da saída.
      (Padrão: '<p>Pages:')
    • 'after' (string): código em HTML para adicionar após a saída.
      (Padrão: '</p>')
    • 'link_before' (string): Código em HTML para adicionar antes de cada link.
      (Padrão: ")
    • 'link_after' (string): Código em HTML para adicionar após cada ligação.
      (Padrão: ")
    • 'next_or_number' (string): Se deseja mostrar números de página ('number') ou "página seguinte (ou anterior)" links ('next').
      (Padrão: 'number')
    • 'sep' (string): Texto do separador.
      (Padrão: ' ')
    • 'nextpagelink' (string): Texto para o link "próxima página".
      (Padrão: 'Próxima página')
    • 'previouspagelink' (string): Link de texto para a "página anterior".
      (Padrão: 'Previous Page' ('Página anterior'))
    • 'pagelink' (string): Formato de textos de âncora dos links, 'next_or_number' se for definida como 'number'. O caractere "%" será substituído pelo número da página, então você pode usar um valor como "Página %" para gerar links como "página 1, página 2, página 3".
      (Padrão: '%')
    • 'echo' (integer): Se associar a saída (1) ou retorna (0).
      (Padrão: 1).

Uso

Conclusão

Espero que tenham gostado deste primeiro lote de Tags de template. Existem mais sete para aprendermos, fique atento para mais tags de template!

Se você tiver qualquer pergunta, comentários ou correções, fique a vontade para compartilhar seus pensamentos com a gente na seção de comentários. E se você gostou do artigo, não se esqueça de compartilhar com seus amigos!

Seja o primeiro a saber sobre novas traduções–siga @tutsplus_pt no Twitter!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.