WordPress Widgets & Sidebars

Scopriamo come creare nuove sidebars e popolarle con Widgets creati ad hoc di Guido Scialfa

Source code: https://github.com/wpcatania/widgets-and-sidebar

Transcript

1. Widgets & Sidebars Come creare widgets e widgets area per il nostro tema
2. Cosa è un widget? Un widget è un elemento riutilizzabile in diverse instanze che assurge ad una specifica funzione.
3. Cosa è una sidebar? Una sidebar o anche detta widgets area, è una sezione della pagina predisposta per poter renderizzare i widgets.
4. Come creo una widget area?
8. functions.php wp-content/themes/2017/functions.php
9. Renderizzare i widgets Per renderizzare i widgets, bisogna creare un file sidebar.php Aggiungere il codice per richiamare il contenuto della sidebar.
10. wp-includes/widgets.php register_sidebar unregister_sidebar is_registered_sidebar dynamic_sidebar is_dynamic_sidebar is_active_sidebar
11. register_sidebar ( [ ] ) Registra una sidebar prendendo un array di argomenti come parametro.
12. unregister_sidebar ( $sidebar_id ) Deregistra una sidebar, prendendo come argomento l’id della sidebar da rimuovere. L’id è il valore stringa passato nella lista degli argomenti a register_sidebar
13. is_active_sidebar ( $sidebar_id ) Ci informa se una sidebar contiene widgets. Utile per evitare di stampare markup vuoto che potrebbe creare problemi di layout.
14. is_dynamic_sidebar ( ) Ci informa se le sidebars registrate contengono widgets. Inoltre controlla se i widgets che contiene sono dei widgets registrati. Ritorna true se almeno una sidear è registrata ed almeno un widget è registrato.
15. dynamic_sidebar ( $sidebar_id ) Renderizza una sidebar e tutti i widgets contenuti in essa. La funzione ritorna un valore che indica se almeno un widget è stato richiamato.
16. get_sidebar( $name ) La funzione get_sidebar() serve a caricare e renderizzare una sidebar. 
 
 Essa prende un parametro $name, ovvero il nome della sidebar da renderizzare. Es: get_sidebar(‘header’); proverà ad includere il file sidebar-header.php e se non verrà trovato utilizzerà sidebar.php
17. sidebar-header.php
18. Richiamare una sidebar Il tema definisce una hook “2017_header” che ci permette di eseguire una funzione in cui richiamare la sidebar.
19. Creare un Widget Come creare un widget?
20. Tutti i widgets devono estendere \WP_Widget class MyWidget extends \WP_Widget
21. Ogni widget deve implementare i seguenti metodi: public function update( $new_instance, $old_instance ) { } public function form( ) { } public function widget( $args, $instance ) { } public function __construct( ) { }
24. PostLoopWidget
27. https://github.com/wpcatania
30. https://wordpress.org/plugins/custom-sidebars/ https://wordpress.org/plugins/easy-custom-sidebars/ https://wordpress.org/plugins/ocean-custom-sidebar/ https://wordpress.org/plugins/content-aware-sidebars/
32. https://www.facebook.com/WordPressMeetupCatania/ https://www.meetup.com/Meetup-WordPress-Catania/