Asteriscoweb

Una delle potenzialità che preferisco di WordPress è sicuramente l’altissima configurabiltà che ha. L’esempio lampante è il poter definire un proprio file functions.php. Detto in parole povere functions.php è un file facente parte di un tema WordPress che permette, appunto, di andare ad implementare delle funzioni aggiuntive alla presentazione del nostro blog.

La maggior parte delle volte questo file contiene il codice che serve a rendere la sidebar del tema pronta ad essere riempita con dei widget. Vediamo ora come definire un nostro widget.

Nello scrivere il tema di questo blog mi è stato molto utile definire un widget che contenesse i link ai feed rss relativi agli articoli ed ai commenti. È un widget di realizzazione molto semplice, ma si presta bene ad essere utilizzato come esempio.

Un po’ di teoria

Per definire e registrare un widget si utilizza la funzione register_sidebar_widget(string nome, string nomefunzione) dove nomefunzione rappresenta il nome della funzione che gestisce il widget e nome indica il nome che vogliamo assegnare al widget. Nei casi più semplici la funzione nomefunzione si occuperà di mandare in output del codice html, nei casi più complessi si occuperà di gestire anche le opzioni del widget.

L’anatomia di un widget

Dopo l’introduzione teorica, passiamo subito ad editare il nostro functions.php e definiamo la funzione che gestirà il nostro nuovo widget.

1
2
3
4
5
6
7
8
9
10

<?php
function myRSSfeed($args){
	extract($args);
	echo $before_widget;
	echo $before_title . 'I miei feed RSS' . $after_title;
	echo '<a href="'. get_bloginfo('rss2_url') . '">Articoli</a> - ';
	echo '<a href="'. get_bloginfo('comments_rss2_url') . '">Commenti</a> ';
	echo $after_widget;
}
?>

Le variabili $before_widget, $after_widget, $before_title e $after_title indicano come verrà visualizzato il widget ed hanno come valore i corrispettivi valori assegnati tramite register_sidebars, date uno sguardo alla documentazione ufficiale per chiarimenti a riguardo.

Registriamo il widget

Dopo aver definito la funzione che gestisce il widget non dobbiamo fare altro che renderlo operativo registrandolo tramite l’apposita funzione.

11
12
13

<?php
register_sidebar_widget('I miei feed rss', 'myRSSfeed');
?>

Ora dal pannello di amministrazione dei widget troveremo anche il nostro pronto da aggiungere.

Tags: functions.php, php, widget