{"id":229315,"date":"2022-11-01T14:03:00","date_gmt":"2022-11-01T11:03:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229315"},"modified":"2022-11-09T06:26:58","modified_gmt":"2022-11-09T03:26:58","slug":"filtrer-correctement-le-contenu-des-publications-et-comprendre-apply_filters","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/filtrer-correctement-le-contenu-des-publications-et-comprendre-apply_filters\/","title":{"rendered":"Filtrer correctement le contenu des publications (et comprendre apply_filters)"},"content":{"rendered":"\n

De temps en temps, chaque fois que je travaille avec du code source pr\u00e9existant ou que j’effectue un audit de code, je vois d’autres personnes modifier le contenu de la publication d’un objet de publication comme celui<\/a> -ci\u00a0:<\/p>\n

<?php\n\n$post->post_content = $my_content;\n<\/code><\/pre>\n
\u00c0 ce stade, certains viendront et diront imm\u00e9diatement que vous vous trompez. Je d\u00e9teste cette phrase (et elle est m\u00eame jonch\u00e9e dans la base de code WordPress, mais je m’\u00e9loigne du sujet).<\/p>\n
Il existe des moyens d’utiliser d’autres fonctions API WordPress existantes pour nettoyer les donn\u00e9es avant de les d\u00e9finir \u00e9gales \u00e0 la valeur de l’ attribut post_content<\/a>, l’utilisation de ces fonctions n’est pas la meilleure fa\u00e7on de proc\u00e9der.<\/p>\n
Au lieu de cela, nous devrions tous utiliser apply_filters. Le probl\u00e8me? Certains ne savent pas, certains ne savent pas comment cela fonctionne, et certains ne savent pas comment l’utiliser. C’est-\u00e0-dire qu’il n’est pas clair comment filtrer correctement le contenu des publications.<\/p>\n
Contenu brut filtr\u00e9 par WordPress puis \u00e9crit dans la base de donn\u00e9es.<\/p>\n
Mais pour ceux qui peuvent appartenir \u00e0 l’une des cat\u00e9gories ci-dessus, cela peut peut-\u00eatre aider.<\/p>\n
Filtrer correctement le contenu des publications<\/h2>\n
\u00c0 ce stade, je suppose que vous connaissez WP_Post<\/a>, ses propri\u00e9t\u00e9s et comment les modifier via diverses fonctions API.<\/p>\n
Le principal probl\u00e8me dont je parle est de s’assurer que le contenu qui sera \u00e9crit dans la base de donn\u00e9es est format\u00e9 de la m\u00eame mani\u00e8re que WordPress le ferait si vous deviez \u00e9crire ou mettre \u00e0 jour un article.<\/p>\n
Et la fa\u00e7on dont cela se passe est la suivante<\/a> (et nous verrons bient\u00f4t les d\u00e9tails \u00e0 ce sujet):<\/p>\n
<?php\n\n\/**\n * Assume $contents is an array of information we want to convert into content for a post.\n *\/\n\n$new_content = '';\nforeach ($contents as $line) {\n\n    if (false === strpos( $line, $name)) {\n        $new_content .= $line;\n    }\n}\n\n$post->post_content = apply_filters( 'the_content', $new_content );\n<\/code><\/pre>\n
Mais les questions de savoir ce que fait cette fonction, comment elle fonctionne et quand l’utiliser demeurent.<\/p>\n
Qu’est-ce que apply_filters\u00a0?<\/h3>\n
Bien s\u00fbr, vous pouvez tout lire \u00e0 ce sujet dans les ressources pour d\u00e9veloppeurs, et cela donne cette d\u00e9finition<\/a> :<\/p>\n
\n
Appelez les fonctions ajout\u00e9es \u00e0 un hook de filtre.<\/p>\n<\/blockquote>\n
Mais cela n’aide pas toujours. Je veux dire que nous pouvons lire la documentation et repartir confus, n’est-ce pas\u00a0?<\/p>\n
Pensez-y de cette fa\u00e7on:<\/p>\n
    \n
  1. Un filtre est une fonction qui accepte les entr\u00e9es \u00e0 traiter.<\/li>\n
  2. L’entr\u00e9e est trait\u00e9e en fonction de la d\u00e9finition de la fonction.<\/li>\n
  3. La fonction renvoie alors la valeur trait\u00e9e.<\/li>\n<\/ol>\n
    Ce que vous faites avec la valeur renvoy\u00e9e d\u00e9pend de vous, mais lorsque vous appliquez un filtre ou appelez apply_filters<\/a> \u00e0 une information, vous dites \u00e0 WordPress: \u00abJ’ai cette information, veuillez appliquer le filtre identifi\u00e9 par cette cl\u00e9 et remettre le le r\u00e9sultat me revient."<\/p>\n
    Pas mal, non ?<\/p>\n
    Comment \u00e7a marche?<\/h3>\n
    Mais il y a une partie de ce qui pr\u00e9c\u00e8de qui m\u00e8ne \u00e0 une question. Concr\u00e8tement, je pr\u00e9cise que \u00ab\u2026veuillez appliquer le filtre identifi\u00e9 par cette cl\u00e9\u2026\u00bb et l’id\u00e9e de cl\u00e9 peut pr\u00eater \u00e0 confusion d’autant plus qu’un filtre ou une action ou plus g\u00e9n\u00e9ralement un hook peut \u00eatre identifi\u00e9 par ce qu’on appelle un tag ou un cl\u00e9.<\/p>\n
    Ce sont des synonymes. Ainsi, lorsque vous voyez une balise<\/strong> ou une cl\u00e9<\/strong> dans le contexte d’un crochet, traitez-les comme telles.<\/p>\n
    Cela dit, voici comment cela fonctionne\u00a0:<\/p>\n
      \n
    1. La fonction apply_filters accepte deux arguments. La premi\u00e8re est la balise ou la cl\u00e9 (selon comment vous voulez l’appeler) associ\u00e9e au filtre (lire: fonction) que vous souhaitez utiliser pour traiter le travail, la seconde est la valeur que vous souhaitez traiter au sein de ladite fonction.<\/li>\n
    2. Le filtre se d\u00e9clenchera et renverra un r\u00e9sultat (ou, rappelez-vous, la fonction que nous avons d\u00e9finie).<\/li>\n
    3. Nous prenons ensuite la valeur renvoy\u00e9e et l’appliquons \u00e0 la propri\u00e9t\u00e9 de notre choix.<\/li>\n<\/ol>\n
      Ainsi, par exemple, vous \u00eates susceptible de voir quelque chose comme \u00e7a<\/a> dans la base de code de quelqu’un d’autre (ou peut-\u00eatre m\u00eame la v\u00f4tre)\u00a0:<\/p>\n
      <?php\n\n$post->post_content = apply_filters( 'the_content', $my_content );\n<\/code><\/pre>\n
      Et maintenant que vous avez un peu de contexte sur la fa\u00e7on dont cela fonctionne, vous avez l’id\u00e9e, n’est-ce pas\u00a0?<\/p>\n
      Comment l’utilisons-nous ?<\/h3>\n
      Cela ram\u00e8ne la boucle de la publication \u00e0 la question initiale de savoir comment nous pouvons utiliser apply_filters pour post_content chaque fois que nous devons ins\u00e9rer ou mettre \u00e0 jour une publication.<\/p>\n
      Disons donc que vous avez le contenu que vous souhaitez appliquer (ou ajouter) \u00e0 la valeur du contenu d’un article. Vous pourriez faire quelque chose comme \u00e7a<\/a> :<\/p>\n
      <?php\n\n\/**\n * Assume $contents is an array of information we want to convert into content for a post.\n *\/\n\n$new_content = '';\nforeach ($contents as $line) {\n\n    if (false === strpos( $line, $name)) {\n        $new_content .= $line;\n    }\n}\n\n$post->post_content = $new_content;\n<\/code><\/pre>\n
      Mais c’est une mauvaise forme. Au lieu de cela, vous faites ceci<\/a> :<\/p>\n
      <?php\n\n\/**\n * Assume $contents is an array of information we want to convert into content for a post.\n *\/\n\n$new_content = '';\nforeach ($contents as $line) {\n\n    if (false === strpos( $line, $name)) {\n        $new_content .= $line;\n    }\n}\n\n$post->post_content = apply_filters( 'the_content', $new_content );\n<\/code><\/pre>\n
      Et c’est comme \u00e7a que WordPress le fait.<\/p>\n
      Conclusion<\/h2>\n
      Donc, compte tenu de toutes les informations et du code ci-dessus, vous devez \u00eatre bien arm\u00e9 non seulement pour vous assurer que vous filtrez correctement les donn\u00e9es qui seront ins\u00e9r\u00e9es dans la base de donn\u00e9es, vous avez les connaissances n\u00e9cessaires pour d\u00e9finir vos filtres et les appliquer \u00e0 toutes les donn\u00e9es que vous jugez appropri\u00e9es.<\/p>\n
      Mais des exemples pour cela sont le contenu d’un autre article.<\/p>\n
      En attendant, si vous travaillez avec du contenu de publication, assurez-vous de filtrer correctement les donn\u00e9es avant de les d\u00e9poser dans la base de donn\u00e9es.<\/p>\n
      Source d’enregistrement:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
      Si vous ins\u00e9rez ou mettez \u00e0 jour des publications par programmation, il est important de vous assurer que vous filtrez correctement le contenu des publications.<\/p>\n","protected":false},"author":1,"featured_media":221177,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[893,717,801,811,862],"tags":[1167],"class_list":["post-229315","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-code-2","category-developpeur","category-php-3","category-plugins-2","category-wordpress-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/229315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=229315"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/229315\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/221177"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=229315"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=229315"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=229315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}