In questo tutorial vedremo le funzioni WordPress principali usate per nello sviluppo di template grafici wordpress personalizzati. Tali funzioni prendono il nome di built-in (strutturali) e sono essenziali per manipolare ed estendere a piacimento i “meccanismi” del CMS.
Navigazione
Le funzioni WordPress per la navigazione sono tra le più conosciute ed usate: sono loro che permettono di creare il menu informativo che l’utente userà per esplorare le pagine ed i contenuti presenti. Le più popolari sono wp_list_pages e wp_nav_menu, quest’ultima introdotta a partire da WordPress 3.0.
wp_list_pages
Wp_list_pages permette di creare un elenco di link delle pagine da mostrare: le pagine verranno presentate in ordine alfabetico qualora non venga apportata alcuna modifica ai parametri. Questa funzione può essere usata per personalizzare sidebar, header o altre parti desiderate del template.
Il codice d’implementazione base per visualizzare la lista completa è il seguente:
[html]<?php wp_list_pages(); ?>[/html]
Piccole modifiche apportate al codice permettono un’ulteriore personalizzazione: potremo decidere di elencare soltanto alcune pagine specifiche tramite il parametro “include”
[html]<?php wp_list_pages(‘include=4,5’); ?>
[/html]
o escluderle tramite “exclude”
[html]<?php wp_list_pages(‘exclude=4,5’); ?>
[/html]
Un altro parametro da non dimenticare è rappresentato da “depht”
[html]<?php wp_list_pages(‘depth=1′); ?>
[/html]
che determina la profondità di navigazione che avranno pagine e sottopagine del sito, elemento importante ai fini dell’usabilità web.
wp_nav_menu
Wp_nav_menu è una funzione introdotta con la release 3.0 del CMS. Wp_nav_menu permette di aggiungere e personalizzare menu di navigazione in ogni parte del tema. Nel nostro tema dovremo aprire il file functions.php ed aggiungere la seguente stringa:
[html]<?php add_theme_support( ‘menus’ ); ?>
[/html]
Questo consentirà il pieno supporto alla funzione. Fatto questo, dovremo aggiungere questo pezzetto di codice nel file del template dove vorremmo apparisse il menu:
[html]<?php wp_nav_menu( array(‘menu’ => ‘[Aggiungere il Nome del Menu]’ )); ?>
[/html]
Dopo aver implementato questa stringa, potremo creare il nostro menu attraverso il pannello di amministrazione cliccando su appearance>menus, immettendo lo stesso nome inserito fra parentesi.
Mostrare le informazioni del blog
Informazioni e dettagli di un blog sono elementi che vanno sempre inseriti nel corso della creazione di un template grafico. WordPress dispone di una funzione che permette di implementare e visualizzare le varie informazioni inerenti ad un blog: “bloginfo“. Bloginfo dispone di molti parametri configurazione, vediamone alcuni.
Visualizzare l’URL di un sito
Uno degli utilizzi più comuni della funzione “bloginfo” è la visualizzazione a video dell’URL del proprio sito: tutto questo avviene grazie all’utilizzo del parametro “url” ed all’implementazione di questo codice:
[html]<?php bloginfo(‘url’); ?>
[/html]
Questa operazione è possibile anche utilizzando un’immagine (ad esempio il proprio logo) al posto dell’URL:
[html]<img src="<?php bloginfo(‘url’); ?>/cartella-immagini/logo-aziendale.jpg" />
[/html]
Informazioni sul percorso del tema
Il parametro “template_url” include informazioni sul percorso relativo al tema, vedi esempio:
[html]<?php bloginfo(‘template_url’); ?>
[/html]
Quanto descritto sopra include le funzioni più usate e conosciute, per tutte le altre è possibile consultare il WordPress Codex.