Comment créer un extrait d'un article sans extrait et le limiter par nombre de caractères • WPShout

Supprimer les codes courts

Il ne nous reste plus de balises HTML, mais nous avons toujours du contenu que nous ne voulons pas afficher dans l'extrait: les codes courts. Étant donné que l'extrait est uniquement destiné à afficher du texte, nous ne les voulons pas dans notre contenu car ils n'ont aucun sens lorsqu'ils ne sont pas analysés. Heureusement, nous n'avons pas besoin d'écrire notre propre analyseur – WordPress a une fonction qui fait exactement cela: strip_shortcodes ().

Supprimer les nouvelles lignes et les espaces

Après avoir supprimé les balises, nous pourrions nous retrouver avec des espaces et des retours à la ligne redondants, ce que nous ne voulons pas car nous voulons que l'extrait soit un paragraphe de texte continu. Par conséquent, nous utiliserons une expression régulière pour rechercher et remplacer tous les onglets, espaces, retours à la ligne, etc. par un seul espace.

str contre mb_str

Il ne nous reste plus que le texte, et il nous reste 2 choses à faire: extraire le nombre de caractères demandé et s'assurer que les mots ne sont pas coupés au milieu.

Compter les lettres, comment cela peut-il être difficile? En utilisant le strpos () et substr () les fonctions devraient faire la tâche comme un morceau de gâteau. Je faisais cela dans un site qui utilisait une langue dont les lettres ne sont pas en code ASCII, et 2 choses se sont produites: je recevais beaucoup moins de lettres que le nombre que j'ai passé à la fonction, et parfois j'obtiens une lettre charabia à la fin de l'extrait. Suite au commentaire d'un collègue, j'ai appris que chaque str La fonction en PHP a un équivalent multi_byte dont le but est d'adresser tous les caractères UTF-8. Je n'avais pas réalisé que les caractères UTF-8 prenaient plus d'un octet, donc quand strpos () comptait des lettres, il comptait en fait des octets, mais dans le cas UTF-8, il y a moins de lettres que d'octets, et c'est la raison pour laquelle je recevais des chaînes plus courtes qui demandaient. C'était aussi la raison du caractère charabia à la fin de l'extrait: substr () compte également les octets, et si le nombre d’octets auquel il parvient arrive à le placer au milieu d’un caractère, ce caractère ne sera pas réel et s’affichera sous forme de charabia.
Par conséquent, la mb_strpos () devrait être utilisé à la place de strpos (), et mb_substr () les problèmes doivent être utilisés au lieu de substr ().

Laisser des mots entiers

L'étape suivante consiste à découper élégamment l'extrait afin qu'aucun mot ne soit coupé au milieu. Cela signifie bien sûr que le nombre de caractères passés en paramètre ne sera pas, selon toute vraisemblance, le nombre exact que nous extrairons, mais nous voulons rester aussi proches que possible de celui-ci et nous allons donc vérifier quels placards : couper avant ou après le dernier mot dans lequel nous sommes en train de se trouver.

Nous utilisons mb_strrpos nous trouvons le dernier espace avant la limite de caractères, et mb_strpos pour trouver l'espace suivant après la limite de caractères. Nous éloignons ensuite ces espaces de la limite de caractères et renvoyons l'extrait jusqu'à l'espace le plus proche.

La fonction entière

/ **
* Obtenez une partie limitée du contenu - sans balises html et shortcodes -
* selon le montant écrit en limite de $. Assurez-vous que les mots ne sont pas coupés au milieu
* @param int $ limit - nombre de caractères
* @return string - le contenu raccourci
* /
function wpshout_the_short_content ($ limit) 
   $ content = get_the_content ();
   / * parfois il y a 
 les balises qui séparent les mots, et lorsque les balises sont supprimées,
   * Les mots des paragraphes adjacents restent ensemble.
   * alors remplacez la fin 
 balises avec espace, pour garantir que les mots ne collent pas * /
   $ content = strip_tags ($ content);
   $ content = strip_shortcodes ($ content);
   $ content = trim (preg_replace ('/  s + /', '', $ content));
   $ ret = $ contenu; / * si la limite est supérieure à la longueur, cela sera retourné * /
   if (mb_strlen ($ content)> = $ limite) 
      $ ret = mb_substr ($ contenu, 0, $ limite);
      // veillez à ne pas couper les mots au milieu:
      // 1. vérifiez d'abord si la sous-chaîne se termine déjà par un espace
      if (mb_substr ($ ret, -1)! == '') 
         // 2. Si ce n'est pas le cas, recherchez le dernier espace avant la fin de la chaîne
         $ space_pos_in_substr = mb_strrpos ($ ret, '');
         // 3. puis recherchez l'espace suivant après la fin de la chaîne (en utilisant la chaîne d'origine)
         $ space_pos_in_content = mb_strpos ($ content, '', $ limit);
         // 4. comparez maintenant la distance de chaque position spatiale à la limite
         if ($ space_pos_in_content! = false && $ space_pos_in_content - $ limit <= $ limit - $ space_pos_in_substr) 
            / * si l'espace le plus proche est dans la chaîne d'origine, prenez la sous-chaîne à partir de là * /
            $ ret = mb_substr ($ content, 0, $ space_pos_in_content);
          autre 
            // sinon prend la sous-chaîne de la chaîne d'origine, mais avec la position précédente (espace)
            $ ret = mb_substr ($ content, 0, $ space_pos_in_substr);
         
      
   
   retourne $ ret. '...';

Mettre à jour le message avec l'extrait généré

Si nous ne voulons pas que le code doive générer l'extrait à chaque fois que nous affichons l'article, nous pourrions mettre à jour l'extrait de l'article dans la base de données afin que la prochaine fois has_excerpt () s'exécute sur ce poste particulier, il retournera un résultat positif et notre fonction récupérera simplement l'extrait sans tous les calculs.

En utilisant le faire avec le wp_update_post () , nous remplirons son champ d’ID de publication et le champ d’extrait, et à la fin du wpshout_the_short_content () fonction que nous appellerons une petite fonction de mise à jour:

function wpshout_update_post_excerpt ($ new_excerpt) 
$ post = tableau (
'ID' => get_the_ID (),
'post_excerpt' => $ new_excerpt,
);
wp_update_post ($ post);

Comment appeler la fonction

La meilleure façon d'appeler cette fonction est de l'accrocher à un filtre. Dans l'article de WPShout Comment personnaliser vos extraits d'articles WordPress, nous apprenons, entre autres, sur le wp_trim_excerpt filtre:
"Le fonction wp_trim_excerpt () est la fonction principale qui génère en fait un extrait du contenu de l'article WordPress (en le raccourcissant à 55 mots et en ajoutant "[…]”). Avant de terminer, il appelle le wp_trim_excerpt filtre pour vous permettre de filtrer les résultats. Nous utilisons le wp_trim_excerpt filtre pour générer et revenir revenir sur notre propre comportement extrait.

function wpshout_excerpt ($ text) 
if (is_admin ()) 
return $ text;

if (! has_excerpt ()) 
$ text = wpshout_the_short_content (200);

wpshout_update_post_excerpt ($ texte);
return $ text;


add_filter ('wp_trim_excerpt', 'wpshout_excerpt');

Conclusion

Cet article nous a appris comment générer et mettre à jour par programme un extrait de message de manière à limiter les caractères de l'extrait et sans couper les mots au milieu.