Share
L'API WordPress Shortcode è stata introdotta in WordPress nella versione 2.5. Da allora, è diventato un metodo ampiamente utilizzato per consentire una rapida personalizzazione del layout e l'inserimento di alcuni snippet di formattazione. Ma gli shortcode possono essere ugualmente utili durante la creazione di temi WordPress: ecco come utilizzarli al meglio!
Gli shortcode hanno molti vantaggi se usati correttamente nei file del tema. Se hai familiarità con le macro del preprocessore in C / C ++, allora i codici brevi possono avere una funzione simile in WordPress. Lo scopo principale dell'uso di un shortcode è sostituire il segnaposto con il proprio codice HTML personalizzato quando il server invia la pagina al client. I passaggi coinvolti nella creazione e nell'implementazione di shortcode sono i seguenti.
In questo suggerimento rapido, utilizzeremo gli shortcode per visualizzare i post personalizzati. Ho dato una spiegazione dettagliata su come creare tipi di post personalizzati e utilizzare temi vuoti su Nettuts +, ma per questo esempio, modificheremo il tema TwentyTen predefinito fornito da WordPress.
La funzione che crei per il tuo shortcode definisce in realtà lo scopo dello shortcode. Una funzione di base può essere definita nel modo seguente (puoi aggiungere tutto il codice in fondo al tuo file functions.php):
Accentsconagua
// Definizione della funzione utilizzata per la visualizzazione del post del progetto personalizzato. function project_shortcode ($ atts) // Estrazione degli argomenti per lo shortcode. extract (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * Questo è dove scriveremo il codice per il recupero dei dati * e costruiremo la struttura HTML da restituire nella variabile $ output * / $ output = 'Questo conterrà l'output HTML finale per il tuo ciclo di progetto personalizzato.'; restituire $ output; Basta essere sicuri di non lasciare spazi bianchi alla fine del file functions.php in quanto può causare un problema. Ora aggiungiamo un po 'di codice per recuperare il post personalizzato' progetto 'e costruiamo la struttura HTML che sostituirà il nostro shortcode.
function project_shortcode ($ atts) extract (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); // Creazione di una query personalizzata per recuperare il post personalizzato del tipo di progetto. $ loop = new WP_Query (array ('post_type' => 'progetto', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Looping dei post e costruzione della struttura HTML. if ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ output. = ''.Get_the_title ().'
'; $ output. = ''.Get_the_excerpt ().''; else $ output = 'Spiacente, nessun progetto ancora. Torna presto.'; // Ora restituiamo il codice HTML nel punto da cui è stato chiamato lo shortcode. restituire $ output; I '$ atts' sono gli attributi forniti insieme allo shortcode. Il metodo di estrazione di PHP viene utilizzato per dividere gli elementi dell'array in variabili in modo che possano essere utilizzati direttamente all'interno della funzione.
In questo esempio, stiamo utilizzando gli attributi passati nella funzione per creare una query personalizzata per il recupero dei dati di post personalizzati del "progetto". Quindi eseguiamo il ciclo di tutti i post del progetto restituiti.
All'interno del ciclo, stiamo recuperando e aggiungendo i dati alla variabile di output con i tag HTML appropriati. Una volta completato il ciclo, la variabile di output contiene il codice HTML completo per la nostra lista di progetti. Questo codice HTML viene restituito e lo shortcode utilizzato nel tema viene sostituito da questo quando viene caricata la pagina.
Ora che abbiamo creato la funzione, dobbiamo registrarla nel database insieme allo shortcode che verrà utilizzato per questo. Possiamo farlo con il
metodo register_shortcode fornito da WordPress.
add_shortcode ( 'progetti', 'project_shortcode');
Il primo argomento in questo metodo è il nome dello shortcode che useremo nel tema e il secondo argomento è il nome della funzione (che abbiamo definito sopra) relativa a tale shortcode. In questo modo WordPress saprà cosa fare quando questo shortcode viene analizzato o incontrato.
WordPress fornisce un metodo di parsing di shortcode che pochissimi sviluppatori pensano di usare spesso. Il metodo do_shortcode può essere utilizzato per inserire shortcode all'interno dei file del tema.
La sintassi dello shortcode è simile a ciò che inseriresti nell'editor back-end. In questo caso, stiamo passando gli attributi per il limite del numero di post da visualizzare e come ordinarli. Dato che stiamo visualizzando i post personalizzati di "progetto", creeremo un nuovo modello di pagina dedicato e useremo lo shortcode in questo. Crea un modello chiamato 'page-project.php' e usa il seguente:
Ora per visualizzare il modello che hai appena creato, crea una pagina chiamata 'Progetto'. Ovviamente crea anche alcuni post di "Progetto" demo!
Ecco! Il codice funzione mostra correttamente i post personalizzati.
Come puoi vedere, il metodo sopra descritto per creare uno shortcode per i messaggi personalizzati e utilizzarli nel nostro tema ci aiuta a mantenere i file del tema gestibili e puliti. Questo ha anche un ulteriore vantaggio che chiunque può inserire il ciclo di post personalizzato dall'editor back-end di WordPress.
L'esempio sopra mostra come possiamo usare gli shortcode durante lo sviluppo del tema in modo efficiente. Esistono molti modi innovativi e produttivi per utilizzare gli shortcode nei temi di WordPress: sentiti libero di condividere le tue idee nei commenti!
