Come creare i propri codici brevi WordPress
Nella versione 2.5, WordPress ha introdotto gli shortcode e tutti noi probabilmente li abbiamo usati in una volta o nell'altra. Solitamente vengono forniti in bundle con plug-in, o anche temi, e ciò che fanno è guardare quando si inserisce qualcosa all'interno di parentesi quadre, quindi sostituirlo con altri contenuti; potrebbe essere una semplice frase o potrebbe essere una massiccia funzione PHP, tutto dipende da ciò che hai insegnato a WordPress.
Gli shortcode in bundle sono grandiosi e velocizzano notevolmente le cose, ma non sarebbe bello sapere come creare i tuoi codici brevi?
In questo articolo ti mostrerò come creare alcuni semplici codici brevi di WordPress per aiutarti a creare qualsiasi funzionalità che ti piace.
Un semplice shortcode
L'API shortcode funziona in modo molto semplice: innanzitutto è necessario creare una funzione di callback che verrà eseguita ogni volta che viene utilizzato lo shortcode; quindi è necessario legare quella funzione a uno shortcode specifico rendendolo pronto per l'uso. Il codice viene spesso inserito nel file functions.php, ma se si pensa di avere molti codici brevi, ha senso creare un file separato e includerlo nel file functions.php.
Nel nostro primo esempio vogliamo creare uno shortcode che creerà qualche lorem ipsum ogni volta che digitiamo [lorem] nell'editor. Per prima cosa dobbiamo creare la funzione di callback che restituirà il lorem ipsum (in shortcode non facciamo eco a nulla, tutto viene restituito):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Successivamente dobbiamo aggiungere questo shortcode a WordPress usando la funzione add_shortcode nel nostro file functions.php o in un file che è incluso in esso, questa funzione aggiunge lo shortcode e lo lega anche alla funzione appena creata. add_shortcode accetta solo due argomenti, il primo è il nome che vogliamo che questo shortcode abbia (cosa scriveremo tra parentesi quadre) e il secondo è la funzione che vogliamo collegare a tale shortcode:
add_shortcode('lorem', 'lorem_function');Questo è tutto ciò che serve per creare un semplice shortcode in WordPress.
Aggiungere parametri
Continuando con questa idea di contenuto fittizio, spesso abbiamo bisogno di immagini nei nostri contenuti quando prepariamo i nostri prototipi e queste immagini devono essere di dimensioni diverse, quindi ora creeremo uno shortcode per inserire un'immagine come questa:
[picture width="500" height="500"]Quando WordPress incontra questo vogliamo una funzione che inserirà un'immagine. Ha bisogno di leggere gli attributi width e height, ma nel caso in cui forniremo anche valori predefiniti in modo che possano essere utilizzati senza gli attributi. Perché potremmo non avere un'immagine disponibile, useremo il lorempixel.com servizio per fornirci un'immagine casuale.
Per prima cosa dobbiamo creare la funzione:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Abbiamo chiamato questa funzione random_picture e dato che questo shortcode sarà in grado di prendere argomenti, gli abbiamo dato il parametro $ atts . Per utilizzare gli attributi abbiamo bisogno di due funzioni: lo shortcode_atts che è una funzione di WordPress che combina i nostri attributi con attributi noti e riempie i valori predefiniti quando necessario; e la funzione di estrazione di PHP che, come suggerisce il nome, estrae quegli attributi che abbiamo impostato per il nostro shortcode. Infine la funzione restituisce il valore che vogliamo, in questo caso il codice HTML per la nostra immagine combinato con le variabili width e height.
L'unica cosa che resta da fare è registrare questo shortcode:
add_shortcode('picture', 'random_picture');Il nostro shortcode è completo, quando scriviamo [immagine] ci darà un'immagine casuale 400 per 200, e se usiamo gli attributi possiamo creare un'immagine di qualsiasi dimensione che ci piace.
Conclusione
La creazione di piccoli codici brevi per le cose che utilizziamo frequentemente ci aiuta sicuramente quando scriviamo post di blog perché puoi fare tutto quello che vuoi con gli shortcode, può essere semplice come restituire una frase o complesso come aggiungere un modulo o gli ultimi messaggi ordinati per mese.
Hai creato utili codici di accesso per WordPress? Quali codici brevi desideri esistere? Fateci sapere nei commenti.
Immagine in primo piano / miniatura, immagine del codice via Marjan Krebelj.