Codex

Plantilla Etiquetas / el extracto

Contenidos

[hide]

Descripción

Muestra el extracto de la entrada actual con [...] al final, que no es una "leer más". Si usted no proporciona un extracto explícita a un puesto (en el editor de entradas de campo de extracto opcional), se mostrará un teaser que se refiere a las primeras 55 palabras del contenido de la entrada. También en este último caso, etiquetas HTML y los gráficos son despojados de los contenidos en el extracto. Esta etiqueta debe estar dentro de The Loop.

Nota: Si el puesto actual es un archivo adjunto, como en el attachment.php y image.php plantilla de bucles, a continuación, el título de archivo adjunto se muestra.Leyendas no incluyen el extracto [...] marcas.

the_excerpt () vs the_content ()

A veces es más significativo para usar sólo the_content ()la función. The_content () decidirá qué mostrar en función de si <- more -> etiqueta se utilizó. El <- more -> tag divide post / página en dos partes: sólo el contenido antes de la etiqueta debe aparecer en el listado. Recuerde que el <- more -> es (por supuesto) ignoró al mostrar solo puesto por página.

Uso

<?php the_excerpt (); ?>

Parámetros

Esta etiqueta no tiene parámetros.

Ejemplos

Por defecto de uso

Muestra el extracto de correos. Utilizado en puestos non-single/non-permalink como un reemplazo para the_content () a la fuerza para mostrar extractos en el Loop.

  <? php the_excerpt ();?> 

Usar con códigos condicionales

Sustituye a the_content () etiqueta con the_excerpt () cuando el archivo (probado por is_archive ()) o categoría (probado por is_category ()) páginas.

Tanto los siguientes ejemplos de trabajo para las versiones 1.5 y superiores.

  <? php if (is_category () | | is_archive ()) ( 
	  the_excerpt (); 
  ) Else ( 
	  the_content (); 
  )?> 

Para la versión de WordPress antes de 1.5, sólo los siguientes trabajos:

  <? php if ($ cat | | $ m) ( 
	  the_excerpt (); 
  ) Else ( 
	  the_content (); 
  )?> 

Extracto de Control Longitud filtros que utilizan

De forma predeterminada, la longitud extracto se establece en 55 palabras. Para cambiar la longitud del fragmento utilizando filtro excerpt_length, agregue el código siguiente al archivo functions.php en el tema:

  función new_excerpt_length ($ length) ( 
	  return 20; 
  ) 
  add_filter ( 'excerpt_length', 'new_excerpt_length'); 

Eliminar el uso de filtros de cadena [...]

Sólo en la versión 2.9 y superiores de WordPress

De forma predeterminada, la cadena fragmento más al final se establece en'[...]'. Para cambiar de cadena más extracto utilizando filtro excerpt_more, agregue el código siguiente al archivo functions.php en el tema:

  new_excerpt_more función ($ más) ( 
	  volver'[.....]'; 
  ) 
  add_filter ( 'excerpt_more', 'new_excerpt_more'); 

Para las versiones 2.8.x y mayores

  new_excerpt_more función ($ extracto) ( 
	  volver str_replace ('[...]','...', $ fragmento); 
  ) 
  add_filter ( 'wp_trim_excerpt', 'new_excerpt_more'); 

Notas

Change Log

Desde: 0,71

Archivo de código fuente

the_excerpt () se encuentra en wp-includes/post-template.php.

Relacionado

the_ID, the_title, the_title_attribute, single_post_title, the_title_rss, the_content, the_content_rss, the_excerpt,the_excerpt_rss, wp_link_pages, next_post_link, next_posts_link, previous_post_link, previous_posts_link,posts_nav_link, sticky_class, the_meta

Véase también el índice de Referencia de funciones y el índice de Códigos de plantilla.