Plus d’informations #Plus d’informations

Affiche l’extrait de l’article en cours après lui avoir appliqué plusieurs filtres dont le formatage auto-p qui transforme les doubles sauts de ligne en paragraphes HTML. Il utilise get_the_excerpt() pour générer d’abord une version rognée du contenu complet du post s’il n’y a pas d’extrait explicite pour le post.

La version rognée contient une balise ‘more’ à la fin qui, par défaut, est le symbole ou « hellip ». Un extrait fourni par l’utilisateur ne reçoit PAS par défaut un tel symbole. Pour l’ajouter, vous devez soit modifier manuellement l’extrait brut $post->post_excerpt dans votre modèle avant d’appeler the_excerpt(), ajouter un filtre pour ‘get_the_excerpt’ avec une priorité inférieure à 10, ou ajouter un filtre pour ‘wp_trim_excerpt’ (en comparant le premier et le deuxième paramètre, car un extrait fourni par l’utilisateur n’est modifié en aucune façon par cette fonction).

Voir get_the_excerpt() pour plus de détails.

Un extrait généré automatiquement aura également tous les shortcodes et balises supprimés. Il est rogné à une limite de mots et la longueur par défaut est de 55 mots. Pour les langues dans lesquelles les mots sont (ou peuvent être) décrits avec des caractères uniques (c’est-à-dire les langues est-asiatiques), la limite du mot est en fait le caractère.

Note : Si le message actuel est une pièce jointe, comme dans les boucles de modèle attachment.php et image.php, alors la légende de la pièce jointe est affichée. Les légendes n’incluent pas le texte «  ».

Comparaison avec le quicktag <!-more-> #Comparaison avec le quicktag <!-more->

Les extraits offrent une alternative à l’utilisation du quicktag <!–more–>. Alors que cette balise more nécessite que l’auteur d’un message crée manuellement une  » scission  » dans le contenu du message, qui est ensuite utilisée pour générer un lien  » read more  » sur les pages d’index, les extraits nécessitent, mais n’exigent pas nécessairement, que l’auteur du message fournisse une  » accroche  » pour le contenu complet du message.

La balise < !–more–> quicktag exige que les modèles utilisent the_content() alors que l’utilisation d’extraits exige, et permet, aux rédacteurs de modèles de choisir explicitement d’afficher des messages complets (en utilisant the_content()) ou des extraits (en utilisant the_excerpt()).

Le choix d’afficher un message complet ou un extrait peut alors être basé sur des facteurs tels que le modèle utilisé, le type de page, la catégorie du message, etcetera. En d’autres termes, avec un <!–more–> quicktag, c’est l’auteur du billet qui décide de ce qui se passe, alors que le rédacteur du modèle est aux commandes avec les extraits. De plus, bien que <!–more–> puisse être utilisé pour créer une véritable division en utilisant le paramètre $stripteaser, il serait difficile et compliqué de différencier ensuite en fonction des caractéristiques, ce qui fait que cela deviendrait un choix essentiellement à l’échelle du site.