[WP] Format d’image personnalisé

Initialisation

Dans le fichier functions.php :

  • On ajoute le support des thumbnails
add_theme_support( 'post-thumbnails' );
  • On utilise la fonction add_image_size()
add_image_size( 'nom_du_format', largeur, hauteur, crop mode);

add_image_size( 'carre-200', 200, 200, true); // Par défaut: crop = false
add_image_size( 'hauteur-illimitee', 200, 9999); // Largeur = 200px ; Hauteur = 100%

// Il est vivement conseillé d'utiliser le hook "after_setup_theme"
add_action('after_setup_theme', 'wpdocs_theme_setup');
function wpdocs_theme_setup() {
    add_image_size('nom_du_format_1', 100) // hauteur illimitée ici
    add_image_size('nom_du_format_2', 150, 150, true)
}

Mise à jour des thumbnails

On utilise le plugin Regenerate Thumbnails pour créer les nouveaux formats à partir des images existantes.

Utilisation

Pour intégrer ce nouveau format dans les templates :


<!-- Pour l'image -->
<?php the_post_thumbnail( 'nom_du_format' ); ?>
<!-- Pour son URL -->
<img src="<?php the_post_thumbnail_url('nom_du_format'); ?>" alt="">

<!-- On n'oublie pas la condition évidemment -->
<?php
if ( has_post_thumbnail() ) { 
    the_post_thumbnail( 'nom_du_format' ); 
}
?>

Précisions

Les termes thumb, thumbnail, medium, large, post-thumbnail (et full ?) sont réservés.

Annexes