Personnaliser les articles liés

Comme les autres modules de Jetpack, le module module d’articles liés inclut des filtres vous permettant de personnaliser l’apparence des articles liés pour satisfaire tous vos besoins.

Les bouts de code ci-dessous fournissent des exemples de quelques filtres inclus dans le module. Vous pouvez ajouter ces bouts de code à un plugin de fonctionnalité, ou à votre fichier de thèmes functions.php.

Vous pouvez aussi vérifier le code source de Jetpack pour découvrir de nouveaux filtres.

• Changer le nombre d’articles liés affichés au dessous de vos articles
• Dépalcer les articles liés au dessus de vos articles
• Changer l’entête « liés » en haut de la section des articles liés
• Remplacer un des articles liés par un résultat personnalisé, pour un article spécifique
• Exclure un article spécifique de l’apparition dans les articles liés
• Exclure une catégorie entière de l’apparition dans les résultats d’articles liés
• Désactiver séléctivement des articles liés de l’apparition dans les articles sélectionnés

Changer le nombre d’articles liés affichés en bas de vos articles

Par défaut, la section d’articles liés va inclure au maximum 3 articles. Vous pouvez changer ce nombre grâce au filtre jetpack_relatedposts_filter_options comme ceci:

function jetpackme_more_related_posts( $options ) {
	$options['size'] = 6;
	return $options;
}
add_filter( 'jetpack_relatedposts_filter_options', 'jetpackme_more_related_posts' );

Déplacer les articles liés au dessus de vos articles

Par défaut, la section d’articles liés apparaît à la fin de votre contenu. Vous pouvez changer ceci pour afficher au dessus de vos articles grâce au filtre jetpack_relatedposts_filter_options comme ceci:

function jetpackme_move_related_posts_to_top( $options ) {
	$options['show_above_content'] = true;
	return $options;
}
add_filter( 'jetpack_relatedposts_filter_options', 'jetpackme_move_related_posts_to_top' );

Changer l’entête « articles liés » en haut de la section des articles liés

Dans cet exemple, nous pouvons changer l’entête « articles liés » par « Regardez ça! »:

function jetpackme_related_posts_headline( $headline ) {
$headline = sprintf(
			'<h3 class="jp-relatedposts-headline"><em>%s</em></h3>',
			esc_html( 'Check These Out!' )
			);
return $headline;
}
add_filter( 'jetpack_relatedposts_filter_headline', 'jetpackme_related_posts_headline' );

Remplacez un des articles liés par un résultat personnalisé, pour un article spécifique

Dans l’exemple suivant, nous aimerions ajouter l’ID de l’article 1036 comme étant le premier résultat d’article lié, de façon que nous puissions retourner un tableau de clics:

function jetpackme_append_related_post( $hits, $post_id ) {
	// $post_id is the post we are currently getting related posts for
	// Add 1036 to the front of the hits array
	array_unshift( $hits, array( 'id' => 1036 ) );
	return $hits;
}
add_filter( 'jetpack_relatedposts_filter_hits', 'jetpackme_append_related_post' );

Exclure un article spécifique de l’apparition parmi les résultats d’articles liés

Dans l’exemple suivant, 1037 and 1038 sont les ID des articles que l’on veut exclure:

function jetpackme_exclude_related_post( $exclude_post_ids, $post_id ) {
	// $post_id is the post we are currently getting related posts for
	$exclude_post_ids[] = 1037; // Exclude post_id 1037
	$exclude_post_ids[] = 1038; // Also exclude post_id 1038
	return $exclude_post_ids;
}
add_filter( 'jetpack_relatedposts_filter_exclude_post_ids', 'jetpackme_exclude_related_post' );

Exclure une catégorie entière de l’apparition dans les résultats d’articles liés

Disons que vous avez une catégorie nommée « Chiens » que vous voulez exclure complètement de l’apparition parmi les articles liés retournés:

function jetpackme_filter_exclude_category( $filters ) {
    $filters[] = array( 'not' => array( 'term' => array( 'category.slug' => 'dogs' ) ) );
    return $filters;
}
add_filter( 'jetpack_relatedposts_filter_filters', 'jetpackme_filter_exclude_category' );

Désactiver séléctivement des articles liés de l’apparition dans les articles sélectionnés

Si vous avez des articles spécifiques que vous voulez ne pas que des articles soient affichés dessus, vous pouvez utiliser ce bout de code comme point de départ.

function jetpackme_no_related_posts( $options ) {
    if ( is_single( array( 17, 19, 1, 11 ) ) ) {
    	$options['enabled'] = false;
    }
    return $options;
}
add_filter( 'jetpack_relatedposts_filter_options', 'jetpackme_no_related_posts' );

Vous pouvez utiliser une multitude de Tags conditionnels à la place de is_single. Dans
l’exemple suivant, 17, 18, 1 et 11 sont les ID des articles suivants que nous voulons empêcher l’affichage des articles liés dessus. Ces articles peuvent être affichés dans d’autres articles en tant qu’articles liés.

Si vous avez d’autres questions sur le module des articles liés, n’hésitez pas à nous envoyer un email!