WordPress 2.9: Post Thumbnail Images

La versione 2.9 di WordPress offre una nuova funzione grazie alla quale sarà  possibile inserire delle miniature (thumbnail) negli articoli/pagine senza piú l’obbligo di utilizzare i Campi Personalizzati. Affinché questa opzione sia disponibile, sarà  per il momento necessario aggiungere alcune righe di codice ai file del proprio tema in uso.

Sebbene l’operazione in sé non sia particolarmente difficoltosa, capita spesso che una buona parte degli utenti abbia una comprensibile reazione di smarrimento qualora decidesse di modificare per la prima volta un file del template.
Questo tutorial é dedicato a quei coraggiosi che ne hanno l’intenzione…

Accordiamo il tema alla nuova funzione (!)

Un aspetto particolarmente importante dell’intera operazione concerne l’avere le idee ben chiare in merito a cosa si stia effettivamente facendo: di fatto, dovremo informare il nostro tema circa la nuova funzione.°  La modifica può essere effettuata in due modi (esegui il backup del file originale prima di procedere):

1. Bacheca/Aspetto/Editor nella sezione “Modifica temi” selezioniamo il file functions.php (Funzioni tema)
2. apriamo con un editor di testo – del tipo Notepad++ ad esempio – il file functions.php

ed inseriamo in esso la seguente riga di codice facendo molta attenzione che il codice venga copiato almeno una riga sopra la chiusura ?>

add_theme_support( 'post-thumbnails' );

Ad operazione compiuta, salvare le modifiche al file. Nel caso in cui si abbia utilizzato un editor di testo, caricare il file (via FTP) sostituendo quello omonimo allocato nella cartella del tema.

Qualora avessimo effettuato correttamente le modifiche al file, nella barra laterale destra dell’editor di WordPress (articoli e pagine) apparirà  un nuovo widget a nome “Miniatura articolo” con un link testuale per potere accedere alle impostazioni per le immagini.

Approfondimenti (!)

Grazie alla modifica apportata al file functions.php, il nostro tema potrà  mostrare le miniature tanto negli articoli quanto nelle pagine del nostro sito.

Qualora si avesse la necessità  di includere le thumbnail nei soli articoli (escludendone la visualizzazione nelle pagine) sarà  necessario sostituire il codice suggerito nel passo precedente con:

add_theme_support( 'post-thumbnails', array( 'post' ) );

nel caso inverso, ossia l’includere le thumbnail nelle sole pagine (escludendone la visualizzazione negli articoli) sarà  necessario sostituire il codice suggerito nel passo precedente con:

add_theme_support( 'post-thumbnails', array( 'page' ) );

Dimensione delle miniature (!)

La nuova funzione offre inoltre la possibilità  di impostare una dimensione predefinita per le thumbnail. Questa operazione sarà  disponibile con due opzioni di scelta via:

1. box-resizing: ridimensionamento proporzionato. L’immagine verrà  adattata al box definito nei parametri senza alcuna distorsione in modo tale che il contenuto venga mostrato nella sua interezza. Ad esempio, con una immagine originale dalle dimensioni di 100×50 pixel ed un box impostato a 50×50, il prodotto del ridimensionamento del file sarà  una miniatura di dimensione pari a 50x25px.
2. hard-cropping: ritaglio. L’immagine dovrà  rispettare i parametri impostati in modo tale che il contenuto si adatti esattamente ad essi. Ad esempio, con una immagine originale dalle dimensioni di 100×100 pixel ed un box impostato a 50×50, il prodotto finale sarà  una miniatura (ritagliata) di dimensione pari a 50x50px.

Anche in questo caso, sarà  necessario aggiungere una riga di codice:

box-resizing

set_post_thumbnail_size( 50, 50 );

hard-cropping

set_post_thumbnail_size( 50, 50, true );

ad esempio, volessimo utilizzare l’hard-cropping, dovremo aggiungere il codice a quello precedente in questo modo:

add_theme_support( 'post-thumbnails' ); set_post_thumbnail_size( 100, 50, true );

Funzioni tema (!)

Affinché il risultato del nostro lavoro possa essere visualizzabile, sarà  necessario inserire la funzione has_post_thumbnail() nel loop del tema in uso

<?php
if ( has_post_thumbnail() ) {
	// the current post has a thumbnail
} else {
	// the current post lacks a thumbnail
}
?>

inoltre, andrà  inserito nel Loop anche l’output (Post Thumbnail) per la funzione the_post_thumbnail()

<?php the_post_thumbnail(); ?>

Personalizzazione (!)

Qualora si desiderasse utilizzare una immagine (hard-cropped) 100x100px per la homepage ed una immagine con la larghezza pari ad 800 pixel (con altezza illimitata) per l’articolo, sarà  necessario aggiungere questo codice al file functions.php del tema:

add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 100, 100, true ); // Normal post thumbnails
add_image_size( 'single-post-thumbnail', 800, 9999 ); // Permalink thumbnail size

nonché inserire questo codice nel loop del file home.php o index.php (a seconda della struttura del tema):

<?php the_post_thumbnail(); ?>

e infine questo codice nel file single.php (nel Loop)

<?php the_post_thumbnail( 'single-post-thumbnail' ); ?>

L´articolo che hai appena letto vuole essere un cordiale invito a familiarizzare con la nuova funzione di WordPress, un´occasione in piú per provare a se stessi che effettuare alcune modifiche al proprio tema non sia poi così difficoltoso. Per chi fosse interessato ad approfondire l´argomento, suggerisco il consulto di questi articoli che sono di certo piú dettagliati e migliori del mio:

Mark on WordPress | New in WordPress 2.9: Post Thumbnail Images

Justin Tadlock | Everything you need to know about WordPress 2.9´s post image feature

Matthias Kretschmann | Using The New Post Thumbnail Feature In WordPress 2.9