Idiomas: English – 関数リファレンス/get the excerpt 日本語 (Add your language)

Description

Retorna el extracto del post. Se trata de un extracto proporcionado por el usuario, que se devuelve sin cambios, o una versión recortada del contenido completo de la entrada generada automáticamente.

Los extractos generados automáticamente tienen todos los códigos cortos y etiquetas eliminados, lo que significa que es sólo una cadena sin formato que no vería ningún salto de línea en cualquier forma de salida, ya que los saltos de línea reales en el texto crudo también se eliminan.

Cuando se llama a través de the_excerpt() esto implica que los extractos de autogeneración son sólo texto crudo con etiquetas <p></p> envueltas alrededor, básicamente.

Los extractos de autogeneración tienen una etiqueta «more» añadida. Esta etiqueta es » por defecto. Se puede cambiar a través del filtro excerpt_more.

La longitud de las palabras por defecto es de 55 palabras. Puede cambiarse a través del filtro excerpt_length.

Uso

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

Esta función debe usarse dentro de El Bucle cuando no se pasa ningún parámetro $post o ID.

Si esta función se usa fuera de El Bucle y la entrada no tiene un extracto personalizado, esta función usará wp_trim_excerpt() para generar un extracto. Esta función utiliza get_the_content(), que debe utilizarse con el Bucle y causará problemas si get_the_excerpt() se utiliza fuera del Bucle. Para evitar los problemas, utilice setup_postdata() antes de llamar a get_the_excerpt() para configurar el objeto global $post.

Parameters

$post (integer|WP_Post) (opcional) ID del post u objeto WP_Post. Por defecto es global $post. Por defecto: null

Valores de retorno

• Devuelve un extracto existente sin cambios (por defecto) pero le aplica los filtros de get_the_excerpt.
• Devuelve una versión recortada del contenido completo del post como se describe, aplicándole además los filtros de wp_trim_excerpt. ‘wp_trim_excerpt’ está encadenado desde ‘get_the_excerpt’, lo que significa que su propio filtro get_the_excerpt será llamado antes o después del recorte dependiendo de la prioridad de su filtro. Si se llama antes, su parámetro $text será una cadena vacía si no hay un extracto suministrado por el usuario, mientras que será la versión recortada de la publicación completa si se llama después. En este último caso podría ser útil o más significativo utilizar ‘wp_trim_excerpt’ ya que tiene un segundo parámetro que le da la entrada no recortada a la función wp_trim_excerpt, lo que significa que este segundo parámetro es simplemente el crudo $post->post_excerpt.
• Para las páginas protegidas por contraseña devuelve una cadena, que tiene un valor por defecto de «No hay ningún extracto porque este es un post protegido.» Este texto se puede cambiar en la definición de la función.

Ejemplos

get_the_excerpt() se puede utilizar para recuperar y almacenar el valor en una variable, sin emitirlo en la 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?>

Usa get_the_excerpt() para imprimir un extracto especificando un 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;}}?>

Registro de Cambios

Desde: 0.71