web-dev-qa-db-fra.com

apply_filters () et the_excerpt donnent des résultats inattendus

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:

  1. Pourquoi le filtre ne s'applique-t-il pas comme prévu?
  2. Est-il possible d'extraire l'extrait de la boucle sans créer une nouvelle boucle?
  3. Suis-je fou?

Merci d'avance pour avoir un coup d'oeil. Je suis assez perplexe, ici.

10
jlengstorf

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.

15
jlengstorf

Essayer:

   get_post($post->ID)->post_excerpt
                        ^^^^^^^^^^^^

Voir: get_post Codex   pour tous les membres de retour disponibles.

1
hakre

Vous pouvez utiliser ma fonction personnalisée pour filtrer le contenu (à partir de NARGA Framework )

  • Si le message a un extrait personnalisé, affichez-le à la place du contenu.
  • Générer automatiquement un extrait du contenu si l'article n'a pas de contenu personnalisé
  • 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 &#187;', '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');
    
0
Narga