Códigos abreviados

Exibir código abreviado de posts

O Código abreviado de exibição de posts permite que você adicione uma lista dos posts de blog a páginas diferentes. Usando Argumentos é possível exibir posts específicos com base em suas categorias ou tags.

Códigos abreviados são pequenos trechos de código criados para o WordPress que permitem a você adicionar diferentes funcionalidade a seu site ou blog. Mais informações sobre códigos abreviados podem ser encontradas aqui.

Sumário

Visão geral do código abreviado de exibição de posts
Como adicionar um código abreviado
Exibição de argumentos
Exemplos de personalização
Alinhamento da imagem
(Avançado) Várias consultas de taxonomia
Limites

O código abreviado [display-posts] não funcionará em sites com o plano WordPress.com Negócios ou superior usando plugins. Vários plugins oferecem funcionalidade similar.

Se você adicionar um código abreviado antes de fazer o upgrade para o plano Negócios ou superior, o seu código continuará lá. Após instalar o plugin “Código abreviado de exibição de posts”, os códigos renderizarão o conteúdo novamente.


Visão geral do código abreviado de exibição de posts

Há vários motivos para você usar o código abreviado de exibição de posts.

  • Você quer mostrar uma lista de posts curta em sua página inicial e a opção de posts destacada não faz parte do seu tema ou não exibe posts da maneira que você deseja.
  • Você quer criar uma página de autores, com biografias e alguns dos seus trabalhos mais recentes publicados em seu site.
  • Você quer destacar posts específicos, como anúncios, em uma página.
  • Você quer adicionar uma lista de posts específica a um widget em sua barra lateral ou rodapé.
  • Entre outros.

↑ Tabela de Conteúdo ↑

Como adicionar um código abreviado

As seguintes instruções não funcionarão para a edição de uma página, um post ou um widget de texto. Quando adicionar o seguinte código, você verá somente o espaço reservado dele no editor. Mas quando publicar a sua página, você verá o resultado do código abreviado.

  1. Edite uma página, um post ou um widget de texto.
  2. Adicione o código abreviado [display-posts] em um post ou página.
  3. Publique ou atualize seu post/página.

Se você usa o Editor de blocos do WordPress, é possível também adicionar um Bloco de shortcode para adicionar o código abreviado de exibição de posts.

Novos posts e atualizações em posts existentes podem levar até uma hora para serem exibidos onde você usar este código abreviado.

Código abreviado de exibição de posts ativo
Esta é a aparência do código abreviado de exibição de posts em uma página ativa que usa o tema Twenty Seventeen.

O código abreviado de exibição de posts mostrará os 10 posts mais recentes em uma lista com marcadores por padrão. É possível personalizar o número de posts, assim como o estilo e quais elementos serão exibidos na lista (títulos, imagens destacadas, resumos, etc).


↑ Tabela de Conteúdo ↑

Exibição de argumentos

Argumentos são usados para personalizar como os posts são exibidos. Abaixo há uma lista de argumentos comuns que você pode adicionar ao seu código abreviado de exibição de posts e exemplos da aparência do código abreviado com o argumento adicionado.

author
Especificar o autor do post
Padrão: vazio
Exemplo: [display-posts author="bill"]

category
Especificar o slug de categoria (ou lista separada por vírgula dos slugs de categoria). Veja como este código abreviado funciona neste site de exemplo.
Padrão: vazio
Exemplo: [display-posts category="fishing,hiking"]

date_format
Especificar o formato de data usado quando include_date for true. Consulte Como formatar hora e data no Codex para obter mais informações.
Padrão: ‘(n/j/Y)’
Exemplo: [display-posts include_date="true" date_format="F j, Y"]

id
Especificar uma ID de post (ou diversas IDs de posts) a ser exibida.
Padrão: vazio
Exemplo: [display-posts id="9, 10"]

image_size
Especificar um tamanho de exibição para a imagem destacada, caso o post contenha uma. O image_size pode ser definido como miniatura, médio ou grande. Isso pode ser alterado em Configurações > Mídia.
Padrão: vazio
Exemplo: [display-posts image_size="thumbnail"]

Se você usar um tema compatível com as Opções de conteúdo e configurá-las para não mostrar as imagens destacadas nas páginas, o argumento image_size também não fará efeito em códigos abreviados usados em uma página no site. Ou seja, imagens destacadas não serão mostradas em posts adicionados por meio do código abreviado, mesmo se ele disser que elas deveriam ser mostradas.

include_content
Incluir o conteúdo do post completo depois do título.
Padrão: vazio
Exemplo: [display-posts include_content="true"]

include_date
Incluir a data do post depois do título do post. O formato padrão é (7/30/12), mas isso pode ser customizado usando o parâmetro “date_format”.
Padrão: vazio
Exemplo [display-posts include_date="true"]

include_excerpt
Colocar o resumo do post depois do título (e a data, ser fornecida).
Padrão: vazio
Exemplo: [display-posts include_excerpt="true"]

offset
O número de posts a ignorar
Padrão: 0
Exemplo: [display-posts offset="3"]

order
Especificar se os posts serão organizados de maneira descendente (DESC) ou ascendente (ASC).
Padrão: DESC
Exemplo: [display-posts order="ASC"]

orderby
Especificar a forma de ordenação dos posts. Consulte os parâmetros disponíveis aqui.
Padrão: date
Exemplo: [display-posts orderby="title"]

portfolio_type
Se você usar o tipo de post Portfólio, aproveite para obter itens de um tipo de portfólio específico.

post_parent
Exibir as páginas secundárias de uma página específica. Você pode especificar uma ID ou ‘current’, que exibe a página secundária da página atual.
Padrão: vazio
Exemplo: [display-posts post_type="page" post_parent="8"]

post_status
Exibir posts associados a determinado status do post
Padrão: publish
Exemplo: [display-posts post_status="publish, future"]

post_type
Especificar o tipo de post a ser usado. Você pode usar um tipo padrão (post ou página). Para Portfólios, utilize “jetpack-portfolio”.  Da mesma forma, para Depoimentos, utilize “jetpack-testimonial”.
Padrão: post
Exemplo: [display-posts post_type="page"]

posts_per_page
A quantidade de posts que serão exibidos.
Padrão: 10
Exemplo: [display-posts posts_per_page="5"]

tag
Especificar o slug de tag (ou a lista separada por vírgula dos slugs de tag)
Padrão: vazio
Exemplo: [display-posts tag="tag1, tag2"]

taxonomy, tax_term e tax_operator
Use esses parâmetros para fazer consultas avançadas de taxonomia. Use ‘taxonomy’ para a taxonomia que você gostaria de consultar, ‘tax_term’ para (os termos ou) o slug de termo que você gostaria de incluir e ‘tax_operator’ para mudar como a consulta usa esses termos (esse campo provavelmente não será necessário).
Padrão: ‘taxonomy’ = empty, ‘tax_term’ = empty, ‘tax_operator’ = ‘IN’
Exemplo: [display-posts taxonomy="color" tax_term="blue, green"]

wrapper
Qual tipo de HTML deve ser usada para exibir as listas. Pode ser uma lista fora de ordem (ul), lista ordenada (ol) ou divs (div) que você pode customizar.
Padrão: ul
Exemplo: [display-posts wrapper="ol"]


↑ Tabela de Conteúdo ↑

Exemplos de personalização

Veja alguns exemplos de códigos abreviados que combinam diversos argumentos para exibir uma lista específica de posts.

[display-posts tag="advanced" posts_per_page="20"]

Isso listará os 20 posts mais recentes com a tag ‘avançado’.

[display-posts tag="advanced" image_size="thumbnail"]

Esta ação listará os 10 posts mais recentes dentro da tag “Avançado” e exibirá uma imagem do post em tamanho “miniatura”.

[display-posts category="must-read" posts_per_page="-1" include_date="true" order="ASC" orderby="title"]

Esta ação listará todos os posts na categoria Necessário ler, em ordem alfabética, com a data anexada ao fim.

[display-posts wrapper="ol"]

Esta ação exibe posts em uma lista ordenada. As opções são “ul” para listas fora de ordem (padrão), “ol” para listas ordenadas, ou div para divs.

[display-posts id="14,3"]

Esta ação exibirá apenas os posts com ID contendo 14 e 3.


↑ Tabela de Conteúdo ↑

Alinhamento da imagem

Uma solicitação comum é exibir uma lista de posts com título, resumo e miniatura alinhados à direita. Aqui está o código abreviado que você pode usar:

[display-posts include_excerpt="true" image_size="thumbnail" wrapper="div"]

Isso inclui o resumo, adiciona uma imagem do tamanho da “miniatura” (você pode personalizar os tamanhos das imagens em Gerenciar → Configurações → Mídia) e define que a lista seja apresentada sem marcadores.

A fim de conseguir que a imagem fique flutuante à direita, acrescente isto ao seu arquivo CSS personalizado (requer a atualização WordPress.com Premium ou WordPress.com Negócios):

.display-posts-listing .alignleft {
    float: right;
    margin: 0 0 5px 5px;
}


↑ Tabela de Conteúdo ↑

(Avançado) Várias consultas de taxonomia

Ao passo que a maioria jamais precisará realizar uma consulta de taxonomia, este código abreviado suporta uma quantidade infinita de consultas de taxonomia. Digamos que você queira colocar todos os posts na categoria “destacado” e que eles sejam marcados como “página inicial”. Usaremos, então, um código abreviado que se parecerá com isto:

[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="homepage"]

Você poderá criar strings incluindo muitos códigos deste tipo: basta começar a contagem em 2. No campo de listagem abaixo, substitua (count) com um número real.

Estes são os campos disponíveis:

taxonomy_(count)
Qual taxonomia consultar
Padrão: vazio

tax_(count)_term
Quais termos incluir (em caso de mais de um, separe-os com vírgulas)
Padrão: vazio

tax_(count)_operator
Como consultar os termos (IN, NOT IN ou AND)
Padrão: em

tax_relation
Descreva a relação entre várias consultas de taxonomia (se os resultados correspondem a todas as consultas ou a somente uma delas). Opções disponíveis: AND e OR
Padrão: E


↑ Tabela de Conteúdo ↑

Limites

O código abreviado de exibição de posts tem o limite de 100 posts a serem exibidos.