Social Links

Il modulo Social Links permette agli utenti di scegliere quali dei servizi selezionati e collegati attraverso Pubblicizza mostreranno i collegamenti ai profili personali, nella loro sezione del tema adibita all’integrazione con altri media. Per utilizzare questa funzione occorre:

Aggiungere il supporto al tema attraverso la funzione add_theme_support(), da inserire nel codice del tuo tema.
Utilizzare le Theme Modifications API (o API Modifica Tema) per codificare i dati nello stile del tuo tema.

Garantire la Compatibilità

Attivare il modulo Social Links è molto simile a rendere compatibili i thumbnails degli articoli o gli stili degli editor, dato che si utilizza la funzione add_theme_support(). Impostando come secondo parametro l’array di prefissi dei servizi supportati richiamando add_theme_support(), Social Links provvederà a fornire l’informazione di cui necessita il tuo tema. Social Links al momento supporta soltanto 5 servizi: Facebook, Twitter, LinkedIn, Google+ e Tumblr. Dato che ogni tema è differente e certi temi potrebbero non supportare tutti i servizi, il tema deve necessariamente riportare i servizi nello specifico:

add_theme_support( 'social-links', array(
    'facebook', 'twitter', 'linkedin', 'google_plus', 'tumblr'
) );

Utilizzare l’informazione

Social Links rende disponibile quest’informazione attraverso le Theme Modifications API (o API Modifica Tema). In questo modo i temi possono codificare questa informazione chiamando get_theme_mod() per gestirla. In quanto sviluppatore di temi è importante per te controllare se l’utente ha di fatto impostato un collegamento a quel servizio prima di utilizzarlo. Puoi fare riferimento al parametro predefinito della struttura base, che è false, oppure inserire una stringa vuota come secondo valore per procedere con una codificazione coerente. Abbiamo aggiunto il prefisso 'jetpack'al nome da assegnare al tema revisionato, in modo da non collidere con nessun altro plugin o funzionalità del tema che potrebbe utilizzare anche soltanto il nome del servizio. Così è come potrebbe essere effettuata l’implementazione in un file di template, nel caso in cui l’utente abbia inserito un URL:

&lt;a href=&quot;&lt;?php echo esc_url( get_theme_mod( 'jetpack-facebook' ) ); ?&gt;&quot;&gt;
    &lt;?php _e( 'Facebook', 'textdomain' ); ?&gt;
&lt;/a&gt;

Ti preghiamo di notare che mentre l’informazione è disponibile via get_theme_mod(), intanto è memorizzata come un un valore serializzato nelle Opzioni di Jetpack — non come una modifica al tema. Stiamo semplicemente utilizzando dei filtri dietro le quinte per renderlo maggiormente accessibile agli sviluppatori attraverso get_theme_mod(), non sono quindi necessarie funzioni personalizzate astruse a rischio sintassi se i tuoi utenti non hanno installato Jetpack!