WordPress ha introdotto l’API shortcode sei anni fa con il rilascio di WordPress 2.5. I codici brevi sono ora utilizzati da un gran numero di plugin WordPress per consentire agli utenti di aggiungere contenuti ai loro post e pagine.
L’API shortcode consente di creare i propri codici brevi con l’aggiunta di funzioni per le funzioni del tema.template php (questo si trova a www.yourwebsite.com/wp-content/themes/yourtheme/).
Oltre a creare i propri codici brevi, WordPress include anche cinque codici brevi predefiniti con il core WordPress:
- audio-Consente di incorporare file audio.
- caption-Consente di avvolgere didascalie intorno contenuto. È comunemente usato con le immagini.
- embed-Consente di incorporare una vasta gamma di contenuti come video, audio e tweet.
- galleria-Consente di inserire gallerie di immagini.
- video-Consente di incorporare file video.
Anche se i codici brevi di WordPress predefiniti sono comunemente usati, pochissimi utenti di WordPress sfruttano l’API shortcode e progettano codici brevi unici per il loro sito web. In questo tutorial, vorrei mostrarvi come dritto in avanti è quello di migliorare il vostro sito web con codici brevi personalizzati.
Prima di iniziare, assicurati di fare un backup delle funzioni.php e qualsiasi altro file che modifichi prima di apportare modifiche al tuo sito web dal vivo.
Creazione di un Shortcode – Un esempio di base
Per darvi una buona comprensione di come funziona l’API Shortcode WordPress, cominciamo con una funzione shortcode di base.
Si ricorda che i codici brevi devono essere creati per i contenuti e le funzionalità che si utilizzano di frequente. L’intero punto di utilizzare codici brevi è quello di risparmiare tempo a qualcuno. Se hai intenzione di usare qualcosa solo una volta, non ha molto senso creare uno shortcode per questo.
Scrivo circa una dozzina di articoli a settimana. Una cosa che faccio spesso è incoraggiare coloro che hanno apprezzato i miei articoli per iscriversi al mio blog (o il blog che sto scrivendo per). Attualmente scrivo questo fuori ogni volta, tuttavia ho potuto risparmiare un sacco di tempo con la creazione di un shortcode per il testo.
Per fare ciò, potrei aggiungere una funzione come questa alle funzioni del mio tema.modello php:
Quelli di voi che non hanno esperienza di codifica possono trovare il codice sopra un po ‘ scoraggiante, tuttavia è facile da capire una volta che si interrompe il codice riga per riga.
La prima cosa che facciamo è aggiungere un commento sopra la nostra funzione. Questo ci aiuterà a vedere rapidamente a cosa serve la nostra funzione quando visualizzeremo il codice in un secondo momento.
// Function to add subscribe text to posts and pages
Definiamo quindi la nostra funzione. Mi piace usare nomi che si spiegano da soli, quindi ho chiamato la mia funzione “subscribe_link_shortcode”.
function subscribe_link_shortcode() {
Successivamente, definiamo il nostro messaggio. La dichiarazione di ritorno visualizzerà il nostro messaggio quando viene chiamato. Memorizza anche i messaggi (al contrario di echo, che lo stamperà ma non lo memorizzerà).
La funzione viene quindi chiusa.
}
Definiamo quindi lo shortcode stesso usando la funzione add_shortcode. La prima variabile specificata definisce lo shortcode da utilizzare e la seconda variabile chiama la nostra funzione (cioè quella che abbiamo definito sopra).
add_shortcode('subscribe', 'subscribe_link_shortcode');
Dopo aver salvato le funzioni.template php, ora possiamo chiamare il nostro messaggio ogni volta che vogliamo utilizzando il shortcode iscriviti.
Utilizzando il shortcode iscriviti in un post o una pagina produrrà il seguente messaggio:
Se ti è piaciuto questo articolo, vi incoraggio a iscriversi al blog Elegant Themes via RSS.
Ho usato un semplice messaggio nel mio esempio, tuttavia è possibile modificarlo per visualizzare molte altre cose. Ad esempio, è possibile creare un shortcode per la visualizzazione di annunci pubblicitari adsense o un modulo di iscrizione per la newsletter; e poi inserirli ovunque si desidera nei tuoi articoli.
Creazione di un Shortcode con attributi
Attributi possono espandere la funzionalità di codici brevi, consentendo di passare i dati attraverso i codici brevi.
Nell’esempio seguente, ti mostrerò come gli attributi possono essere utilizzati per espandere la funzione che abbiamo creato in precedenza. Come puoi vedere, gran parte del codice rimane lo stesso.
at atts è il nome del nostro array di attributi. Usiamo quindi la funzione extract per importare variabili dal nostro array (tramite la funzione shortcode_atts WordPress).
Vengono quindi definiti due attributi: subtype and e subtypeurl. Questi rappresentano il tipo di abbonamento e l’URL di abbonamento. Questi attributi vengono quindi chiamati nel nostro messaggio.
Il nostro tipo di abbonamento predefinito è RSS e il nostro URL di abbonamento predefinito è http://feeds.feedburner.com/ElegantThemes. Queste informazioni verranno visualizzate quando non vengono definiti attributi.
Pertanto, quando aggiungi quanto segue a un post:
Otterremo il seguente output:
Assicurati di iscriverti ai futuri aggiornamenti di Elegant Themes tramite RSS.
Se definiamo gli attributi, il risultato è diverso. Il seguente codice:
Produrrebbe:
Assicurati di iscriverti ai futuri aggiornamenti di Elegant Themes tramite RSS.
Assicurati di iscriverti ai futuri aggiornamenti di Elegant Themes di Twitter.
Assicurati di iscriverti ai futuri aggiornamenti di Elegant Themes di Facebook.
Assicurati di iscriverti ai futuri aggiornamenti di Elegant Themes di Google.
Sebbene questo fosse un esempio di base di come funzionano gli attributi, è facile vedere come gli sviluppatori di plugin possono utilizzare l’API shortcode per rendere le funzioni complicate più user-friendly per gli utenti.
Panoramica
Se si seguono i passaggi indicati in questo tutorial, ora si dovrebbe avere una conoscenza di base di come è possibile creare i propri codici brevi personalizzati per il tuo sito web. I codici brevi sono un ottimo modo per semplificare le attività complicate, quindi ti incoraggio a tenere a mente l’API shortcode di WordPress in futuro.
Non preoccuparti se questo tutorial è stato un po ‘ difficile per te. Tutti i temi eleganti disegni sono confezionati con codici brevi che rendono la pubblicazione di contenuti bella facile. I codici brevi possono essere utilizzati per creare presentazioni, colonne e tabelle. Ti permette anche di proteggere con password i tuoi contenuti.
Spero che ti sia piaciuto questo tutorial sulla creazione di un codice sms unico per il tuo sito web WordPress. Se è così, ti incoraggio a iscriverti a Temi eleganti poiché abbiamo alcuni ottimi contenuti in cantiere
Inoltre, ancora una volta, ti ricordo di eseguire il backup di qualsiasi file prima di modificarli.