Je sens que je dois manquer quelque chose d'assez évident, mais je n'arrive pas à faire en sorte que WordPress coopère.
Je génère des tags Facebook OG avec une fonction. Tout fonctionne bien, sauf pour l'extrait.
Depuis l'abandon de get_the_excerpt($post->ID)
, existe-t-il un autre moyen de créer un extrait sans avoir à créer une toute nouvelle boucle? Cela me semble excessif.
Mon premier instinct a été d'utiliser apply_filters()
:
$description = apply_filters('the_excerpt', get_post($post->ID)->post_content);
Cela me donne le post complet, avec un contenu au format HTML. Ok, faut avoir tort. J'ai donc essayé la prochaine idée logique:
$description = apply_filters('get_the_excerpt', get_post($post->ID)->post_content);
Pas de dé. Maintenant, il n'y a pas de HTML, mais c'est toujours le post complet (ce qui est vraiment déroutant).
OK pas de problème. Sautons tous les trucs fantaisistes et choisissons simplement l'entrée réduite:
$description = wp_trim_excerpt(get_post($post->ID)->post_content);
Pas de changement.
Donc, ma question est la suivante: que diable se passe-t-il? Y a-t-il quelque chose qui me manque, ici?
Je suis entré dans le WP noyau pour trouver comment fonctionne the_excerpt()
et il semble être identique à mon appel:
/**
* Display the post excerpt.
*
* @since 0.71
* @uses apply_filters() Calls 'the_excerpt' hook on post excerpt.
*/
function the_excerpt() {
echo apply_filters('the_excerpt', get_the_excerpt());
}
J'ai quelques questions basées sur mes conclusions:
Merci d'avance pour avoir un coup d'oeil. Je suis assez perplexe, ici.
Il s'avère que la réponse était dans wp_trim_excerpt()
.
C'est défini dans wp-includes/functions.php:1879
:
/**
* Generates an excerpt from the content, if needed.
*
* The excerpt Word amount will be 55 words and if the amount is greater than
* that, then the string ' [...]' will be appended to the excerpt. If the string
* is less than 55 words, then the content will be returned as is.
*
* The 55 Word limit can be modified by plugins/themes using the excerpt_length filter
* The ' [...]' string can be modified by plugins/themes using the excerpt_more filter
*
* @since 1.5.0
*
* @param string $text Optional. The excerpt. If set to empty, an excerpt is generated.
* @return string The excerpt.
*/
function wp_trim_excerpt($text = '') {
$raw_excerpt = $text;
if ( '' == $text ) {
$text = get_the_content('');
$text = strip_shortcodes( $text );
$text = apply_filters('the_content', $text);
$text = str_replace(']]>', ']]>', $text);
$excerpt_length = apply_filters('excerpt_length', 55);
$excerpt_more = apply_filters('excerpt_more', ' ' . '[...]');
$text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
}
return apply_filters('wp_trim_excerpt', $text, $raw_excerpt);
}
Ainsi, tout texte transmis ne sera pas traité; cela ne fonctionne que s'il est appelé avec un paramètre vide.
Pour résoudre ce problème, j'ai ajouté un filtre rapide à mon thème qui résout le problème:
/**
* Allows for excerpt generation outside the loop.
*
* @param string $text The text to be trimmed
* @return string The trimmed text
*/
function rw_trim_excerpt( $text='' )
{
$text = strip_shortcodes( $text );
$text = apply_filters('the_content', $text);
$text = str_replace(']]>', ']]>', $text);
$excerpt_length = apply_filters('excerpt_length', 55);
$excerpt_more = apply_filters('excerpt_more', ' ' . '[...]');
return wp_trim_words( $text, $excerpt_length, $excerpt_more );
}
add_filter('wp_trim_excerpt', 'rw_trim_excerpt');
C'est un peu redondant, mais j'aime mieux que d'ouvrir de nouvelles boucles chaque fois que je veux générer un extrait.
Essayer:
get_post($post->ID)->post_excerpt
^^^^^^^^^^^^
Voir: get_post
Codex pour tous les membres de retour disponibles.
Vous pouvez utiliser ma fonction personnalisée pour filtrer le contenu (à partir de NARGA Framework )
Découper automatiquement le shortcode, le code HTML, supprimer [...], ajouter le texte "Lire la suite"
/**
* Auto generate excerpt from content if the post hasn't custom excerpt
* @from NARGA Framework - http://www.narga.net/narga-core
* @param $excerpt_lenght The maximium words of excerpt generating from content
* @coder: Nguyễn Đình Quân a.k.a Narga - http://www.narga.net
**/
function narga_excerpts($content = false) {
# If is the home page, an archive, or search results
if(is_front_page() || is_archive() || is_search()) :
global $post;
$content = $post->post_excerpt;
$content = strip_shortcodes($content);
$content = str_replace(']]>', ']]>', $content);
$content = strip_tags($content);
# If an excerpt is set in the Optional Excerpt box
if($content) :
$content = apply_filters('the_excerpt', $content);
# If no excerpt is set
else :
$content = $post->post_content;
$excerpt_length = 50;
$words = explode(' ', $content, $excerpt_length + 1);
if(count($words) > $excerpt_length) :
array_pop($words);
array_Push($words, '...<p><a class="more-link" href="' . get_permalink() . '" title="' . the_title_attribute('echo=0') . '"> ' . __( 'Read more »', 'narga' ) . ' </a></p>');
$content = implode(' ', $words);
endif;
$content = '<p>' . $content . '</p>';
endif;
endif;
# Make sure to return the content
return $content;
}
// Add filter to the_content
add_filter('the_content', 'narga_excerpts');