WordPress.org
Más información #Más información
Muestra el extracto de la entrada actual después de aplicarle varios filtros incluyendo el formato auto-p que convierte los saltos de línea dobles en párrafos HTML. Utiliza get_the_excerpt() para generar primero una versión recortada del contenido completo de la entrada si no hay un extracto explícito para la entrada.
La versión recortada contiene una etiqueta ‘more’ al final que por defecto es el símbolo o «hellip». Un extracto suministrado por el usuario NO recibe por defecto dicho símbolo. Para añadirlo, debe modificar el $post->post_excerpt sin procesar manualmente en su plantilla antes de llamar a the_excerpt(), añadir un filtro para ‘get_the_excerpt’ con una prioridad inferior a 10, o añadir un filtro para ‘wp_trim_excerpt’ (comparando el primer y el segundo parámetro, porque un extracto suministrado por el usuario no se altera de ninguna manera por esta función).
Vea get_the_excerpt() para más detalles.
Un extracto autogenerado también tendrá todos los shortcodes y etiquetas eliminados. Se recorta hasta un límite de palabras y la longitud por defecto es de 55 palabras. Para los idiomas en los que las palabras se describen (o pueden describirse) con caracteres individuales (por ejemplo, los idiomas asiáticos), el límite de la palabra es realmente el carácter.
Nota: Si el mensaje actual es un archivo adjunto, como en los bucles de plantilla attachment.php e image.php, entonces se muestra la leyenda del archivo adjunto. Los pies de foto no incluyen el texto «».
Comparación con la etiqueta rápida <!-more-> #Comparación con la etiqueta rápida <!-more->
Los extractos proporcionan una alternativa al uso de la etiqueta rápida <!-more–>. Mientras que esta etiqueta more requiere que el autor de la entrada cree manualmente una ‘división’ en el contenido de la entrada, que luego se utiliza para generar un enlace «leer más» en las páginas de índice, los extractos requieren, pero no necesariamente exigen, que el autor de la entrada suministre un ‘teaser’ del contenido completo de la entrada.
¡El <!–más–> requiere que las plantillas usen the_content() mientras que el uso de extractos requiere, y permite, que los escritores de plantillas elijan explícitamente si mostrar los posts completos (usando the_content()) o extractos (usando the_excerpt()).
La elección de si mostrar un post completo o un extracto puede entonces basarse en factores como la plantilla utilizada, el tipo de página, la categoría del post, etcétera. En otras palabras, con una etiqueta rápida <más–> el autor de la entrada decide lo que sucede, mientras que el escritor de la plantilla tiene el control con los extractos. Además, aunque <!–más–> puede usarse para crear una división real usando el parámetro $stripteaser, sería difícil y complicado diferenciar luego en base a las características, haciendo que esto se convierta en una opción básicamente para todo el sitio.