Línguas: Português – 関数リファレンス/get the excerpt 日本語 (Adicione o seu idioma)

Descrição

Retorna o excerto do post. Este é um trecho fornecido pelo usuário, que é retornado inalterado, ou uma versão recortada do conteúdo completo do post, automaticamente gerada por palavras.

Os trechos gerados automaticamente têm todos os atalhos e tags removidos, o que significa que é apenas uma string sem formatação que não veria nenhuma quebra de linha em nenhuma forma de saída, uma vez que as quebras de linha reais no texto bruto também são removidas.

Quando chamado através do_excerpt() isto implica que os excertos auto-gen são apenas texto puro com <p></p> tags enroladas em torno dele, basicamente.

Exerpts auto-gen têm uma tag “mais” anexada a eles. Esta tag é ” por padrão. Ela pode ser alterada através do filtro excerpt_more.

O comprimento padrão da palavra é 55 palavras. Ela pode ser alterada através do filtro excerpt_length.

Usage

<?php $excerpt = get_the_excerpt( int|WP_Post $post ) ?>

Esta função deve ser usada dentro do The Loop quando nenhum parâmetro $post ou ID for passado.

Se esta função for usada fora do The Loop e o post não tiver um excerpt personalizado, esta função irá usar wp_trim_excerpt() para gerar um excerpt. Essa função usa get_the_content(), que deve ser usado com o Loop e causará problemas se get_the_excerpt() estiver sendo usado fora do Loop. Para evitar os problemas, use setup_postdata() antes de chamar get_the_excerpt() para configurar o objeto global $post.

Parameters

$post (inteiro|WP_Post) (opcional) Post ID ou objeto WP_Post. O valor padrão é global $post. Padrão: null

Return Values

• Retorna um trecho existente inalterado (por padrão) mas aplica a ele os filtros get_the_excerpt.
• Retorna uma versão aparada do conteúdo completo do post como descrito, adicionalmente aplicando filtros wp_trim_excerpt a ele. O ‘wp_trim_excerpt’ é encadeado de ‘get_the_excerpt’, o que significa que o seu próprio filtro get_the_excerpt será chamado antes ou depois do aparo, dependendo da prioridade do seu filtro. Se chamado antes, o seu parâmetro $text será uma string vazia se não houver um trecho fornecido pelo usuário, enquanto que será a versão aparada do post completo se chamado depois. Neste último caso pode ser útil ou mais significativo usar ‘wp_trim_excerpt’ uma vez que ele tem um segundo parâmetro que lhe dá a entrada não aparada para a função wp_trim_excerpt, significando que este segundo parâmetro é simplesmente o $post_excerpt.>post_excerpt.
• Para páginas protegidas por senha ele retorna uma string, que tem um valor padrão de “Não há excerpt porque este é um post protegido”. Este texto pode ser alterado na definição da função.

Exemplos

get_the_excerpt() pode ser usado para recuperar e armazenar o valor em uma variável, sem sair para a página.

<?php$my_excerpt = get_the_excerpt();if ( '' != $my_excerpt ) {// Some string manipulation performed}echo $my_excerpt; // Outputs the processed value to the page?>

Use get_the_excerpt() para imprimir um trecho especificando um número máximo de caracteres.

<?phpthe_excerpt_max_charlength(140);function the_excerpt_max_charlength($charlength) {$excerpt = get_the_excerpt();$charlength++;if ( mb_strlen( $excerpt ) > $charlength ) {$subex = mb_substr( $excerpt, 0, $charlength - 5 );$exwords = explode( ' ', $subex );$excut = - ( mb_strlen( $exwords ) );if ( $excut < 0 ) {echo mb_substr( $subex, 0, $excut );} else {echo $subex;}echo '';} else {echo $excerpt;}}?>

Mudar Log

Desde: 0.71