Ajouter une ic\u00f4ne SVG personnalis\u00e9e \u00e0 l\u2019\u00e9diteur de blocs a longtemps impos\u00e9 JavaScript, une \u00e9tape de build ou une solution de contournement incompl\u00e8te. WordPress\u00a07.1 doit introduire une API publique qui permet de d\u00e9clarer des ic\u00f4nes depuis une extension PHP, puis de les employer dans l\u2019\u00e9diteur, les mod\u00e8les PHP et l\u2019API REST.<\/p>\n\n\n\n
Ce guide cr\u00e9e une extension L\u2019API repose sur trois fonctions et sur les collections. Une collection est un groupe nomm\u00e9 d\u2019ic\u00f4nes\u00a0: chaque ic\u00f4ne doit y appartenir, et son nom pr\u00e9fixe les identifiants pour \u00e9viter les conflits avec le core ou avec une autre extension. Ainsi, Lors de l\u2019enregistrement, fournissez soit D\u00e9clarez toujours la collection avant ses ic\u00f4nes. Si vous tentez d\u2019ajouter une ic\u00f4ne \u00e0 une collection absente, elle n\u2019appara\u00eet pas dans le s\u00e9lecteur sans signaler d\u2019erreur.<\/p>\n\n\n\n Cr\u00e9ez l\u2019arborescence suivante dans myplugin-custom-icons<\/code> qui d\u00e9clare une collection, ajoute une ic\u00f4ne en ligne et deux ic\u00f4nes depuis des fichiers, automatise l\u2019enregistrement d\u2019un dossier entier et expose un shortcode. WordPress\u00a07.1 est annonc\u00e9 pour le 19\u00a0ao\u00fbt\u00a02026\u00a0; le code ci-dessous correspond \u00e0 l\u2019API attendue dans cette version.<\/p>\n\n\n\nCe que l\u2019extension va fournir<\/h2>\n\n\n\n
\n\n
myplugin-custom-icons<\/code> et une collection d\u2019ic\u00f4nes nomm\u00e9e myplugin<\/code>.<\/li>\n\n\n.svg<\/code>.<\/li>\n\n\nPr\u00e9requis<\/h2>\n\n\n\n
\n\n
wp-env<\/code>.<\/li>\n\n\nComprendre l\u2019API des ic\u00f4nes<\/h2>\n\n\n\n
core\/plus<\/code> et myplugin\/plus<\/code> restent deux ic\u00f4nes distinctes.<\/p>\n\n\n\n\n\n
wp_register_icon_collection( $name, $args )<\/code> d\u00e9clare une collection nomm\u00e9e.<\/li>\n\n\nwp_register_icon( $name, $args )<\/code> d\u00e9clare une ic\u00f4ne.<\/li>\n\n\nwp_get_icon( $name, $args )<\/code> g\u00e9n\u00e8re le SVG dans PHP et renvoie une cha\u00eene de caract\u00e8res.<\/li>\n\n<\/ul>\n\n\n\ncontent<\/code>, qui contient le balisage SVG dans une cha\u00eene PHP, soit file_path<\/code>, qui contient le chemin absolu d\u2019un fichier .svg<\/code>. N\u2019employez pas les deux pour une m\u00eame ic\u00f4ne. content<\/code> convient \u00e0 une ou deux ic\u00f4nes\u00a0; file_path<\/code> s\u2019adapte mieux \u00e0 une biblioth\u00e8que stock\u00e9e dans un dossier.<\/p>\n\n\n\n1. Cr\u00e9er l\u2019extension et d\u00e9clarer sa collection<\/h2>\n\n\n\n
wp-content\/plugins\/<\/code>\u00a0:<\/p>\n\n\n\n