{"id":1725,"date":"2013-02-28T06:30:34","date_gmt":"2013-02-28T05:30:34","guid":{"rendered":"http:\/\/www.manuelmarangoni.it\/sir-bit\/?p=1725"},"modified":"2013-05-26T14:06:06","modified_gmt":"2013-05-26T13:06:06","slug":"wordpress-gestire-gli-shortcode-nel-content-degli-articoli","status":"publish","type":"post","link":"https:\/\/www.manuelmarangoni.it\/sir-bit\/1725\/wordpress-gestire-gli-shortcode-nel-content-degli-articoli\/","title":{"rendered":"WordPress – Gestire gli shortcode per creare codici personalizzati nel content degli articoli"},"content":{"rendered":"
\"Wordpress<\/a>

Le funzioni per lo shortcode di WordPress ci permettono di inserire codice personalizzato all’interno del content di un articolo (1)<\/p><\/div>\n

Se fate spesso uso di WordPress e dei suoi plugin, prima o poi vi siete senz’altro imbattuti in uno shortcode API<\/a>.
\nDi cosa si tratta? Come spiega la documentazione, sono \u00abun insieme di funzioni per creare un macro codice all’interno del contenuto<\/strong> di un post\u00bb. Nella pratica, gli shortcode possono essere visti come alias<\/em> da sostituire: quando nel testo di un articolo compare una determinata stringa, questa viene sostituita da un codice specifico.<\/p>\n

Per esempio, nel content di un post potreste trovare uno shortcode come questo, che permette di aggiungere una photo gallery nella pagina:<\/p>\n

\n\n\n\n
\n
1<\/pre>\n<\/td>\n
\n
[myshortcode-gallery id=1]<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Un sistema comodo per aggiungere codice all’interno di un articolo<\/strong>: basta scrivere lo shortcode nel punto voluto del testo e, alla stampa del content, WordPress si occuper\u00e0 di convertirlo.<\/p>\n
Creare uno shortcode personalizzato<\/h3>\n
Esiste naturalmente la possibilit\u00e0 di creare uno shortcode personalizzato, che stampi un macro codice creato da noi.<\/p>\n
WordPress ci mette a disposizione delle funzioni per la gestione degli shortcode<\/strong>. Andiamo a vederle sommariamente:<\/p>\n
\n\n\n\n
\n
1\r\n2\r\n3\r\n4\r\n5\r\n6\r\n7\r\n8\r\n9\r\n10\r\n11\r\n12<\/pre>\n<\/td>\n
\n
\/\/registra un nuovo shortcode<\/span>\r\n\/\/$tag \u00e8 lo shortcode scritto da noi, $func \u00e8 la funzione di conversione<\/span>\r\nfunction<\/span> add_shortcode(<\/span>$tag<\/span>,<\/span> $func<\/span>)<\/span>\r\n\r\n\/\/rimuove un determinato shortcode ($tag)<\/span>\r\nfunction<\/span> remove_shortcode(<\/span>$tag<\/span>)<\/span>\r\n\r\n\/\/rimuove tutti gli shortcode<\/span>\r\nfunction<\/span> remove_all_shortcodes(<\/span>)<\/span>\r\n\r\n\/\/esegue tutti gli shortcode che trova nel testo passato ($content)<\/span>\r\nfunction<\/span> do_shortcode(<\/span>$content<\/span>)<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
<\/p>\n
Prima di vedere un esempio concreto, consideriamo che l’uso degli shortcode ha anche qualche limitazione<\/strong>:
\n– gli shortcode devono essere univoci: se incontra due shortcode con lo stesso nome, il codice sovrascriver\u00e0 il primo e terr\u00e0 solo il secondo.
\n– gli shortcode non accettano l’uso di parentesi quadre nei suoi parametri (es: [tag attributo=”[valore]”] )
\n– uno shortcode pu\u00f2 internare un altro shortcode; ma uno shortcode non pu\u00f2 contenere se stesso (quindi non pu\u00f2 iterare se stesso).<\/p>\n
Un esempio<\/h3>\n
Riprendiamo l’esempio della documentazione, che \u00e8 minimale e chiaro da capire, e vediamo come possiamo costruire uno shortcode personalizzato<\/strong>.
\nQuello che vogliamo realizzare \u00e8 uno shortcode di questo tipo:<\/p>\n