{"id":264,"date":"2026-08-14T14:01:26","date_gmt":"2026-08-14T12:01:26","guid":{"rendered":"https:\/\/helloblog.io\/it\/icone-svg-personalizzate-wordpress-7-1\/"},"modified":"2026-08-14T14:01:26","modified_gmt":"2026-08-14T12:01:26","slug":"icone-svg-personalizzate-wordpress-7-1","status":"publish","type":"post","link":"https:\/\/helloblog.io\/it\/icone-svg-personalizzate-wordpress-7-1\/","title":{"rendered":"Come registrare icone SVG personalizzate in WordPress 7.1"},"content":{"rendered":"\n

Con WordPress 7.1 puoi registrare icone SVG personalizzate in PHP, senza JavaScript n\u00e9 build step. Una volta registrate, il selettore del blocco core\/icon<\/code>, i template PHP e la REST API leggono la stessa libreria.<\/p>\n\n\n\n

La versione 7.1 \u00e8 prevista per il 19 agosto 2026. Puoi gi\u00e0 sviluppare con la release candidate, purch\u00e9 lavori in un ambiente locale e conosca le basi di PHP.<\/p>\n\n\n\n

Cosa creerai<\/h2>\n\n\n\n

Costruirai un plugin chiamato myplugin-custom-icons<\/code> che registra una collezione di icone chiamata myplugin<\/code>. La libreria includer\u00e0 un cuore definito direttamente nel codice PHP, una stella e un segnalibro caricati da file .svg<\/code>.<\/p>\n\n\n\n

Vedrai anche come registrare automaticamente tutti gli SVG di una cartella, inserire un’icona nel contenuto con uno shortcode e usare un’icona registrata come icona di un blocco, incluso un blocco registrato solo in PHP.<\/p>\n\n\n\n

Prerequisiti<\/h2>\n\n\n\n

Prima di iniziare, prepara questi elementi:<\/p>\n\n\n\n

    \n\n
  • WordPress 7.1 o successivo; per lo sviluppo va bene anche WordPress 7.1 RC.<\/li>\n\n\n
  • Alcuni file di icone SVG, oppure i file di esempio inclusi nei passaggi successivi.<\/li>\n\n\n
  • Un ambiente locale, come LocalWP, WordPress Studio o wp-env.<\/li>\n\n\n
  • Conoscenze di base di PHP.<\/li>\n\n<\/ul>\n\n\n\n

    Le tre funzioni dell’API<\/h2>\n\n\n\n

    L’API delle icone personalizzate di WordPress 7.1 ruota attorno a tre funzioni e alle collezioni. Una collezione \u00e8 un gruppo nominato di icone: ogni icona deve appartenerne a una.<\/p>\n\n\n\n

      \n\n
    • wp_register_icon_collection( $name, $args )<\/code>: registra una collezione con un nome.<\/li>\n\n\n
    • wp_register_icon( $name, $args )<\/code>: registra una singola icona.<\/li>\n\n\n
    • wp_get_icon( $name, $args )<\/code>: genera l’SVG in PHP e restituisce una stringa SVG.<\/li>\n\n<\/ul>\n\n\n\n

      Il nome della collezione diventa il prefisso dell’icona. Per esempio, core\/plus<\/code> e myplugin\/plus<\/code> sono nomi distinti: questo namespace evita conflitti con le icone del core e con quelle di altri plugin.<\/p>\n\n\n\n

      Quando registri un’icona, passa il markup SVG nella propriet\u00e0 content<\/code> oppure il percorso assoluto di un file nella propriet\u00e0 file_path<\/code>, mai entrambe. content<\/code> \u00e8 pratico per una o due icone; file_path<\/code> \u00e8 pi\u00f9 adatto a una libreria in una cartella.<\/p>\n\n\n\n

      1. Crea il plugin e registra la collezione<\/h2>\n\n\n\n

      Registra prima la collezione e poi le icone. Se tenti di registrare un’icona in una collezione inesistente, non comparir\u00e0 nel selettore senza mostrare errori.<\/p>\n\n\n\n

      Crea questa struttura in wp-content\/plugins\/<\/code>:<\/p>\n\n\n\n

      <\/circle><\/circle><\/circle><\/g><\/svg><\/span>