Creare Sidebar per WordPress

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.
|
1 2 3 4 5 6 7 8 9 10 |
$sideInfo= array( 'name' => 'Sidebar Principale', 'id' => 'main-sidebar', 'description' => 'Barra di navigazione principale', 'before_widget' => '<div id="%1$s" class="widget %2$s">', 'after_widget' => '</div>', 'before_title' => '<h3>', 'after_title' => '</h3>' ); register_sidebar($sideInfo); |
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.
|
1 2 3 4 5 |
<div id="sidebar"> <?php if ( !dynamic_sidebar('main-sidebar') ) {?> <div class="widget">{Widget di Default}</div> <?php } ?> </div> |
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.
-
Ricky
-
http://www.adostudio.it Andrea Dell’Orco
-
Army
-
http://www.adostudio.it Andrea Dell’Orco
