wordpress-sidebar


Quando si realizza un tema per WordPress, spesso è necessario realizzare sidebar dinamiche (Dynamic Sidebar), in modo che l’utente possa amministrare liberamente i widget.

Per prima cosa illustreremo come registrare le sidebar e in seguito come posizionarle all’interno del template.

Registrate una sidebar

Come tutte le funzioni del nostro tema, andremo a lavorare all’interno di functions.php.

Per prima cosa dobbiamo configurare la sidebar, assegnando un nome e fornendo le impostazioni della gestione dei widget.

Come è possibile intuire, la variabile $sideInfo contiene tutte le informazioni che ci servono per poter impostare la barra di navigazione.  Analizziamo ora le variabile che la compongono:

  • name: nome della sidebar, tutti i caratteri sono accettati.
  • id: nome identificativo della sidebar. Deve essere minuscolo e privo di spazi.
  • description: descrizione che viene mostrata nella schermata dei widget di WordPress.
  • before_widget: codice html inserito prima di mostrare il contenuto del widget. Le variabili %1$s e %2$s vengono sostituite rispettivamente dall’id del widget e dalla classe css (tali parametri servono principalmente quando si desidera creare widget su misura, leggere in fondo per maggiori info).
  • after_widget: codice html inserito dopo il contenuto del widget. before_widget e after_widget servono quindi a creare il contenitore del widget.
  • before_title: codice html inserito prima del titolo del widget.
  • after_title: codice html inserito dopo il titolo.

Come è facile intuire, register_sidebar() si occupa di effettuare fisicamente la registrazione, estrapolando dalla variabile $sideInfo, le informazioni precedentemente fornite.

Inserire le sidebar nel tema

Una volta create le sidebar all’interno di functions.php, non ci resta che inserirle nelle pagine in cui vogliamo che appaiano.

Questo codice d’esempio tenta di eseguir dynamic_sidebar() cercando di richiamare il contenuto di main-sidebar registrata precedentemente. Se la sidebar non è registrata o è vuota, viene mostrato il widget di default.

Creare widget su misura

Come avete potuto appurare, la creazione di sidebar per WordPress è estremamente semplice. Quello che può essere “complicato” è la creazione di widget preconfezionati da inserire all’interno del nostro tema. In merito a questo, ho scritto una guida approfondita qualche mese fa: creare widget personalizzati per un tema.

Spero di essere stato sufficientemente chiaro, eventuali domande e suggerimenti sono ben accetti.