More Information #More Information

Displays the excerpt of the current post after applying several filters to it including auto-p formatting which makes double line-breaks into HTML paragraphs. Ele usa get_the_excerpt() para primeiro gerar uma versão recortada do conteúdo completo da mensagem caso não haja um trecho explícito para a mensagem.

A versão recortada contém uma tag ‘more’ no final que por padrão é o símbolo ou “hellip”. Um trecho fornecido pelo usuário NÃO é, por padrão, dado tal símbolo. Para adicioná-lo, você deve modificar o $post->post_excerpt bruto manualmente no seu template antes de chamar o_excerpt(), adicionar um filtro para ‘get_the_excerpt’ com prioridade inferior a 10, ou adicionar um filtro para ‘wp_trim_excerpt’ (comparando o primeiro e segundo parâmetro, porque um excerto fornecido pelo usuário não é alterado de forma alguma por esta função).

Veja get_the_excerpt() para mais detalhes.

Um excerpt gerado automaticamente também terá todos os atalhos e tags removidos. Ele é cortado até um limite de palavras e o comprimento padrão é de 55 palavras. Para idiomas em que as palavras são (ou podem ser) descritas com caracteres únicos (isto é, East-Asian) o limite de palavras é na verdade o caractere.

Note: Se o post atual é um anexo, como nos loops do modelo attachment.php e image.php, então a legenda do anexo é exibida. As legendas não incluem o texto “”.

Comparação com a <!-more-> quicktag #Comparação com a <!-more-> quicktag

Excerpts fornecem uma alternativa ao uso da <!–more–> quicktag. Enquanto esta tag mais requer que um autor do post crie manualmente uma ‘divisão’ no conteúdo do post, que é então usada para gerar um link “leia mais” nas páginas de índice, os trechos requerem, mas não necessariamente exigem, um autor do post para fornecer um ‘teaser’ para o conteúdo completo do post.

O <!–more–> quicktag requer templates para usar o_content() enquanto que usar excertos requer, e permite que os autores de templates escolham explicitamente se querem exibir posts completos (usando o_content()) ou excertos (usando o_excerpt()).

A escolha de exibir um post completo ou um excerto pode então ser baseada em factores tais como o template usado, o tipo de página, a categoria do post, etc. Em outras palavras, com um <!–moue–> quicktag o autor do post decide o que acontece, enquanto o autor do template está no controle com trechos. Além disso, embora <!–more–> possa ser usado para criar uma divisão real usando o parâmetro $stripteaser, seria difícil e complicado diferenciar com base em características, fazendo com que isso se torne uma escolha basicamente em todo o site.