Créer une page d’archive d’un custom post type en classant selon les termes d’une taxonomie

Créer une page d’archive d’un type de contenu est relativement simple, il convient de nommer le fichier archive-CPT.php dans le dossier de votre thème.

La problématique ici consistait non seulement à lister tous les contenus mais en tenant compte des termes qui leur étaient reliés.

Si je devais résumer, voici le résultat souhaité :

• Terme 1
  • Contenu A
  • Contenu B
  • Contenu C
• Terme 2
  • Contenu A
  • Contenu B
  • Contenu C
• Terme 3
  • Contenu A
  • Contenu B
  • Contenu C

Et ainsi de suite jusqu’à ce que tous les contenus aient été listés dans ma page d’archive.

Pour ce faire, j’ai donc commencé par lister les termes à l’aide de la fonction get_terms en spécifiant le nom de la taxonomie reliée à mon type de contenu.

Ensuite, pour chaque terme, une requête WP_Query pour récupérer les contenus qui sont bien associés à ce terme. Une fois dans la boucle, à vous de choisir les éléments que vous souhaitez récupérer : le titre, le permalien, l’image à la une, etc.

Ce code se place dans le fichier archive-CPT.php de votre thème, ou mieux de votre thème enfant, en remplaçant CPT par l’identifiant de votre type de contenu : archive-livre.php pour un type livre, par exemple. WordPress n’utilise ce modèle que si le type de contenu a été déclaré avec l’argument has_archive. Remplacez aussi NOM_CPT et NOM_TAXONOMIE, aux lignes surlignées, par les identifiants de votre type de contenu et de votre taxonomie.

Voici l’intégralité du code du tutoriel avec des éléments facultatifs pour bien présenter les choses dont le titre de la page d’archive.

<?php if (! defined('ABSPATH')) die('Restricted Area'); ?>
<?php get_header(); ?>
	<header class="page-header">
	<h1 class="container"><?php post_type_archive_title(); ?></h1>
	</header>
<div class="content">
	<div class="container">
		<?php
			$post_type = 'NOM_CPT';
			$taxonomy = 'NOM_TAXONOMIE';

			$terms = get_terms(array(
			 'taxonomy' => $taxonomy,
			 'orderby' => 'name',
			 'order' => 'ASC'
			 ));

			if (! is_wp_error($terms) && $terms) { foreach($terms as $term) {
		?>

		<?php 
			$args = array(
			'post_type' => $post_type,
			'posts_per_page' => -1,
			'tax_query' => array(
			array(
				'taxonomy' => $taxonomy,
				'terms' => array($term->term_id),
				'include_children' => true,
				'operator' => 'IN'
				)
			)
		);
		$my_query = new WP_Query($args); if ($my_query->have_posts()) { ?>
			<div class="row">
				<h2 class="term-title"><?php echo esc_html($term->name); ?></h2>

				<?php while ($my_query->have_posts()) : $my_query->the_post(); ?>
					<div class="col-sm-2">
						<?php if (has_post_thumbnail()) : ?>
							<?php the_post_thumbnail('thumbnail', array('class' => 'img-responsive aligncenter')); ?>
						<?php endif; ?>
						
						<h3><a href="<?php the_permalink() ?>" rel="bookmark"><?php the_title(); ?></a></h3>
					</div>
				<?php endwhile; ?>
			</div>

		<?php wp_reset_postdata(); } 
		 } } ?>
	</div>
</div>
<?php get_footer(); ?>

Le titre de l’archive est placé hors de la boucle principale, qui l’aurait répété pour chaque contenu, et chaque terme devient un titre de niveau 2. Sans posts_per_page à -1, chaque requête s’arrêterait au nombre fixé dans Réglages > Lecture par le réglage « Nombre de publications récentes affichées sur les pages d’archive » (10 par défaut). wp_reset_postdata() rétablit le contenu courant après chaque boucle, et le test is_wp_error() évite des avertissements PHP si le nom de la taxonomie est erroné.

Si votre taxonomie est hiérarchique, comme les catégories, un contenu classé dans un terme enfant apparaît sous ce terme et sous son parent : passez include_children à false pour ne l’afficher que sous son propre terme. Les termes sans contenu et les contenus sans terme n’apparaissent pas.

Le reste vous l’aurez compris n’est que mise en forme HTML / CSS. Ici, je me base sur les classes de Bootstrap 3 : depuis Bootstrap 4, img-responsive s’appelle img-fluid. Adaptez ces classes à votre thème.

Et avec un thème à blocs ?

Avec un thème à blocs, comme Twenty Twenty-Five, ce fichier PHP n’est pas la bonne solution. WordPress l’utilise bien, mais get_header() et get_footer() n’y trouvent ni header.php ni footer.php : ils chargent alors un en-tête et un pied de page de secours, obsolètes depuis WordPress 3.0, au lieu de ceux de votre thème. Placez plutôt la même logique dans un code court (shortcode), à ajouter au fichier functions.php de votre thème enfant :

/**
 * [wpc_cpt_terms] shortcode: lists the posts of a post type grouped by the terms of a taxonomy.
 */
function wpc_cpt_terms_shortcode() {
	$post_type = 'NOM_CPT';
	$taxonomy  = 'NOM_TAXONOMIE';

	$terms = get_terms( array(
		'taxonomy' => $taxonomy,
		'orderby'  => 'name',
		'order'    => 'ASC',
	) );

	if ( is_wp_error( $terms ) || ! $terms ) {
		return '';
	}

	$output = '';

	foreach ( $terms as $term ) {
		$my_query = new WP_Query( array(
			'post_type'      => $post_type,
			'posts_per_page' => -1,
			'tax_query'      => array(
				array(
					'taxonomy' => $taxonomy,
					'terms'    => array( $term->term_id ),
				),
			),
		) );

		if ( ! $my_query->have_posts() ) {
			continue;
		}

		$output .= '<h2 class="term-title">' . esc_html( $term->name ) . '</h2><ul>';

		while ( $my_query->have_posts() ) {
			$my_query->the_post();
			$output .= '<li><a href="' . esc_url( get_permalink() ) . '">' . esc_html( get_the_title() ) . '</a></li>';
		}

		$output .= '</ul>';
		wp_reset_postdata();
	}

	return $output;
}
add_shortcode( 'wpc_cpt_terms', 'wpc_cpt_terms_shortcode' );

Ouvrez ensuite Apparence > Éditeur > Modèles, cliquez sur Ajouter un modèle et choisissez Archives : Livre, Livre étant le nom de votre type de contenu. Ce choix n’apparaît que si le type de contenu a été déclaré avec has_archive et show_in_rest à true.

Dans la fenêtre Choisir une composition qui s’ouvre, sélectionnez le Contenu de secours, tiré des modèles de votre thème. Remplacez-y le bloc Boucle de requête par un bloc Code court contenant [wpc_cpt_terms], puis cliquez sur Enregistrer.

Pour maîtriser l’adresse de cette archive, voyez comment définir l’URL d’archive d’un Custom Post Type.