Perché gli shortcode di WordPress possono essere così utili

WordPress è uno dei sistemi di gestione dei contenuti più utilizzati al mondo. Innumerevoli plugin hanno aiutato l'ex software di blogging a sviluppare un'enorme gamma di funzioni che possono essere utilizzate per realizzare un'ampia varietà di progetti web. Tuttavia, WordPress è rimasto fedele a una cosa nel corso degli anni: È un sistema che può essere utilizzato da blogger, redattori e altri copywriter senza alcuna conoscenza di HTML e CSS, il che lo rende una soluzione rapida e semplice per distribuire contenuti sul World Wide Web.

Quindi, se vuole muovere i primi passi come autore web, WordPress è la scelta perfetta. Nel 2008, gli sviluppatori di WordPress hanno anche introdotto una funzione chiamata shortcodes, che le permette di aggiungere facilmente elementi dinamici ai suoi post editoriali.

Che cos'è uno shortcode?

I cosiddetti shortcode, introdotti con la versione 2.5 di WordPress, sono scorciatoie che possono essere inserite nei testi e sono collegate ad un codice PHP. Questo viene memorizzato nel file functions.php o in un file .php separato che viene integrato nel file functions.php. Se viene richiamata una pagina con uno shortcode, WordPress fa in modo che lo script corrispondente venga eseguito e interpretato. Il visitatore vede quindi il contenuto generato dalla funzione PHP, anziché il codice. In senso stretto, lo shortcode funge da segnaposto, ad esempio per elementi semplici come un estratto di testo o per tipi di contenuto dinamico come i pop-up o una galleria di immagini.

Implementare uno shortcode in WordPress non è una grande sfida: Vengono inseriti direttamente nell'editor nel punto appropriato del post. Affinché WordPress riconosca i codici come tali, vengono inseriti tra parentesi quadre [ ]. Ad esempio, uno shortcode ha la forma [current-posts]. In combinazione con la funzione PHP corrispondente, questo codice visualizza altri post pubblicati di recente nella posizione selezionata. Il codice I codici brevi di WordPress può anche essere specificato con parametri aggiuntivi. Ad esempio, per limitare la visualizzazione dei post pubblicati più di recente a cinque, lo shortcode appena utilizzato può essere esteso come segue: [current-posts posts="5″].

Perché gli shortcode di WordPress possono essere così utili

Due aspetti in particolare rendono gli shortcodes in WordPress così pratici: in primo luogo, anche gli utenti che non hanno conoscenze di JavaScript o CSS possono aggiungere dinamismo al loro progetto web. Anche il linguaggio di scripting PHP, che è elementare per gli shortcodes, non deve necessariamente essere padroneggiato, in quanto vari shortcodes, compresi gli script corrispondenti, sono già disponibili in WordPress per impostazione predefinita. Questi sono chiaramente elencati sulla homepage ufficiale. Lì troverà anche le istruzioni su come usare i rispettivi Sbloccare il codice breve e può utilizzarli. Inoltre, molti utenti di WordPress mettono a disposizione gratuitamente i loro shortcode WordPress sviluppati da loro stessi su varie piattaforme come SNIPPLR. Anche molti plugin e template offrono i propri codici brevi. Quindi deve programmarsi solo se desidera modificare uno script esistente o ha bisogno di uno script completamente nuovo.

Il secondo vantaggio principale di Gli shortcode sono il risparmio di tempoSe, ad esempio, utilizza ripetutamente un determinato passaggio di testo, un logo o un altro elemento nei suoi articoli, l'inserimento di uno shortcode opportunamente programmato le farà risparmiare un'enorme quantità di tempo. Se in seguito desidera modificare qualcosa di questo elemento, non dovrà farlo individualmente per ogni articolo. È sufficiente adattare il codice PHP e le modifiche saranno applicate a tutte le pagine del suo progetto WordPress che contengono lo shortcode.

Come creare i suoi shortcodes in WordPress

È già chiaro che il cuore di uno shortcode è lo script PHP che viene eseguito non appena WordPress incontra uno shortcode precedentemente definito. Tuttavia, le sezioni che seguono non si soffermano su come programmare tale script, in quanto ciò comporterebbe un corso di base di programmazione PHP che la porterebbe fuori tema. Invece, le sezioni seguenti le mostreranno come integrare gli shortcode in WordPress, utilizzarli per il suo progetto e disattivarli nuovamente. Può aggiungere il codice PHP corrispondente al file functions.php nella directory del tema che sta utilizzando, oppure ad un file PHP separato che integrerà di conseguenza. Dovrebbe creare un tema figlio, in modo che i suoi shortcode non scompaiano al successivo aggiornamento del tema. Questo può essere fatto in pochi semplici passi, come mostrano le istruzioni del forum di supporto di WordPress.

Creare una funzione di callback

La funzione PHP che viene eseguita non appena WordPress registra uno shortcode è una cosiddetta funzione di callback. Come tale, viene passata ad un'altra funzione come parametro e richiamata in condizioni definite con parametri definiti. La seguente funzione di esempio cerca nel database e genera un link all'ultimo post per lo shortcode [current-posts]:

funzione current_posts_function() {
  query_posts(array('orderby' =&gt; 'date', 'order' =&gt; 'DESC' , 'showposts' =&gt; 1));
  se (have_posts()) :
    while (have_posts()) : the_post();
      $return_string = '<a href="/it/'.get_permalink().'/">'.get_the_title().</a>';
    endwhile;
  endif;
  wp_reset_query();
  restituisce $return_string;
}

Il testo che deve sostituire lo shortcode si trova nella variabile $return_string (PHP identifica tutte le variabili con $). La funzione PHP (current_posts_function) restituisce questa variabile. Se per errore utilizza il comando echo, l'elemento implementato tramite shortcode appare improvvisamente prima del contenuto effettivo.

Inserire un codice breve in WordPress

Deve dire a WordPress che la funzione che ha creato è uno shortcode che deve essere eseguito automaticamente quando una pagina richiamata contiene lo shortcode [current-posts]. Per farlo, aggiunga il seguente codice al suo file PHP:

add_shortcode('current-posts', 'current_posts_function');

In questo modo ha definito il nome dello shortcode [current-posts], che utilizzerà successivamente nell'editor, e la funzione current_posts_function() da utilizzare. Per evitare conflitti tra i diversi shortcode di WordPress, è importante scegliere un nome unico.

Definire shortcodes parametrizzati e funzionalizzati

Per rendere il suo shortcode WordPress ancora più flessibile, può aggiungere dei parametri opzionali. Nell'esempio utilizzato finora, ha senso specificare nello shortcode esattamente il numero di post da visualizzare. Per farlo, ha bisogno di due funzioni aggiuntive: In primo luogo, la funzione shortcode_atts(), che combina gli attributi shortcode generati dall'utente con gli attributi nativi e inserisce automaticamente i valori predefiniti richiesti. In secondo luogo, la funzione PHP extract() è necessaria per estrarre gli attributi shortcode. Nel caso in cui il campo degli argomenti rimanga vuoto, è necessario specificare il valore predefinito 1 ('posts' => 1):

funzione current_posts_function($atts){
  extract(shortcode_atts(array(
    'posts' =&gt; 1,
  ), $atts));

  $return_string = '<ul>';
  query_posts(array('orderby' =&gt; 'date', 'order' =&gt; 'DESC' , 'showposts' =&gt; $posts));
  se (have_posts()) :
    while (have_posts()) : the_post();
      $return_string .='<li><ahref="'.get_permalink().'">'.get_the_title().</a></li>';
    endwhile;
  endif;
  1TP4Stringa_di_ritorno .= '</ul>';

  wp_reset_query();
  restituisce $return_string;
}

Se ora inserisce lo shortcode nel testo come segue [current-posts posts="5″], non viene visualizzato solo l'articolo pubblicato più di recente, ma anche un elenco dei cinque articoli più recenti.

Utilizzo di determinati contenuti come parametri di shortcode

Può modificare ulteriormente l'esempio presentato e aggiungere un elemento di contenuto specifico come parametro. Nel nostro esempio, questo parametro di contenuto dovrebbe definire il titolo di un'intestazione. Per farlo, aggiunga la variabile $content allo script di callback e inserisca il titolo HTML prima dell'enumerazione:

function current_posts_function($atts, $content = null) {
  extract(shortcode_atts(array(
    'posts' =&gt; 1,
  ), $atts));

  $return_string = '<h3>'.$content'.</h3>';
  1TP4Stringa_di_ritorno .= '<ul>';
  query_posts(array('orderby' =&gt; 'date', 'order' =&gt; 'DESC' , 'showposts' =&gt; $posts));
  se (have_posts()) :
    while (have_posts()) : the_post();
       $return_string .= '<li><a href="/it/'.get_permalink().'/">'.get_the_title().</a></li>';
    endwhile;
  endif;
  1TP4Stringa_di_ritorno .= '</ul>';

  wp_reset_query();
  restituisce $return_string;
}

Ora circondi l'intestazione desiderata nel suo testo con uno shortcode di apertura e uno di chiusura, simile a un tag HTML:

[current-posts posts ="5"]Intestazione dell'elenco degli articoli attuali[/current-posts].

Utilizzi il codice breve di WordPress in un widget

Finora abbiamo trattato solo l'uso degli shortcode nell'editor di testo di WordPress. Tuttavia, ci sono spesso situazioni in cui gli shortcode sono interessanti anche per un widget come una barra laterale. WordPress non riconosce gli shortcode per impostazione predefinita, ma questo può essere rapidamente modificato con una piccola riga di codice aggiuntiva nel file PHP:

add_filter('widget_text', 'do_shortcode');

Utilizzi questo codice per indicare a WordPress di controllare anche gli elementi di testo nei widget per gli shortcode.

Disattivazione dei codici brevi che non sono più richiesti

Se non ha più bisogno di un determinato shortcode di WordPress, ha due opzioni per disattivarlo: La soluzione ottimale sarebbe quella di rimuovere la funzione di callback dal file PHP e tutte le voci del codice dai suoi post. Se invece elimina solo la funzione di callback, WordPress non riconoscerà più lo shortcode come tale e lo visualizzerà in testo normale al centro dell'articolo. Poiché questo metodo richiede molto tempo per uno shortcode utilizzato di frequente, esiste una seconda opzione per questi casi: invece di eliminare il codice e la funzione PHP, la funzione di callback viene ampliata con un'istruzione che non restituisce nulla e quindi viene praticamente bloccata:

add_shortcode('current-posts', '__return_false');

Utili shortcodes per il suo blog

Ora che ha acquisito una breve visione della struttura degli shortcode e sa come registrarli e integrarli in WordPress, i seguenti esempi dovrebbero darle un'idea delle numerose possibilità della tecnologia shortcode.

Inserisca il pulsante di collegamento

Per aggiungere un pulsante di collegamento con etichettatura individuale al suo progetto, tutto ciò che le serve è uno shortcode con la seguente funzione di callback:

function link_button_function( $atts, $content = null ) {
  return '';
}
add_shortcode('link-button', 'link_button_function');

L'etichettatura desiderata del pulsante viene semplicemente inserita tra lo shortcode di apertura e quello di chiusura:

[link-button]Clicchi qui![/link-button]

Visualizzazione del menu di WordPress

Può utilizzare il seguente codice per visualizzare un menu selezionato del suo progetto WordPress sotto il post di testo:

function menu_function($atts, $content = null) {
  estrarre(
    shortcode_atts(
      array( 'name' => null, ),
      $atts
    )
  );
  restituire wp_nav_menu(
    array(
      'menu' => $name,
      'echo' => false
      )
  );
}
add_shortcode('menu', 'menu_function');

Se desidera utilizzare questo shortcode, deve semplicemente inserire il nome del menu corrispondente come parametro, ad esempio:

[menu name="Menu principale"]

Il modo più semplice per WordPress shortcode sono i plugin

Per tutti coloro che non vogliono creare il proprio shortcode né implementare manualmente gli esempi già pronti in functions.php o nel rispettivo file PHP, esiste un altro modo per attivare gli utili shortcode per il proprio progetto web: Sulla homepage ufficiale di WordPress, troverà un'ampia selezione di plugin che aggiungono shortcode singoli o diversi alla sua installazione di WordPress. Con l'estensione Last Updated Shortcode, ad esempio, può accedere all'omonimo shortcode [lastupdated], che mostra quando un articolo o una pagina sono stati aggiornati l'ultima volta.

Con oltre 50 shortcode e un proprio editor CSS, il plugin Shortcodes Ultimate è un po' più completo. Può essere utilizzato per aggiungere shortcode per schede, pulsanti, box o cursori a WordPress, ad esempio. Tuttavia, deve sempre tenere presente quanto segue quando utilizza i plugin shortcode: Le estensioni consumano risorse informatiche e rallentano il suo progetto web se utilizzate in modo eccessivo. Inoltre, di solito non è possibile sapere se un Plugin sia ulteriormente sviluppato e regolarmente aggiornato o se rappresenti una vulnerabilità di sicurezza.

Infine, va detto che non ci sono solo plugin che implementano gli shortcode, ma anche quelli che la aiutano a creare le sue funzioni di callback e a gestire i suoi shortcode.

Shortcoder: Può creare i suoi shortcode in un editor visuale e aggiungere semplicemente snippet HTML e JavaScript.