Associé

Cette extension nécessite une licence Pro

Version actuelle : 1.5.5

Utilisez SearchWP pour afficher du contenu similaire sur votre site !

L'extension Related de SearchWP est conçue pour fonctionner avec une surcharge minimale tout en offrant des options de personnalisation étendues pour répondre aux exigences de conception et de fonctionnalité de votre site. L'affichage de contenu similaire aux visiteurs est une stratégie efficace pour maintenir l'engagement et encourager les utilisateurs à explorer d'autres pages de votre site. Si vous utilisez actuellement un autre système de contenu similaire, Related de SearchWP réduira probablement la surcharge du serveur en utilisant l'index de contenu que SearchWP a déjà créé.

Remarque : L'algorithme Related de SearchWP utilise les titres des articles comme source de mots-clés par défaut pour identifier et afficher le contenu similaire sur votre site, garantissant ainsi des suggestions pertinentes et contextuellement appropriées pour vos visiteurs.

Configuration et intégration

Comme toutes les extensions SearchWP, Related est un plugin WordPress autonome qui fonctionne parallèlement à SearchWP. Une fois installé, l'extension Related reste inactive par défaut jusqu'à ce que vous la configuriez selon vos préférences. Vous pouvez accéder à toutes les options de configuration et personnaliser l'apparence du contenu similaire sur vos pages d'articles en accédant à Paramètres SearchWP → Related dans votre backend WordPress.

Thèmes de mise en page

La section des thèmes de mise en page propose plusieurs styles prédéfinis pour afficher votre bloc de contenu similaire sur le frontend de votre site Web. Vous pouvez facilement basculer entre différents thèmes de mise en page et prévisualiser chaque option avant d'enregistrer vos modifications pour vous assurer que la conception correspond à l'esthétique de votre site.

Minimal : Ce thème présente une mise en page de liste épurée et simple qui affiche uniquement les titres des articles, organisés dans un format de grille ordonné.

Colonnes : Cette mise en page en grille affiche les résultats sur plusieurs colonnes, avec les titres et les descriptions des articles pour fournir aux visiteurs plus de contexte sur chaque élément similaire.

Miniature : Cette mise en page combine une structure en grille avec des images mises en avant de grande taille à côté des titres des articles, créant un affichage visuellement attrayant qui met l'accent sur le contenu visuel.

Riche : Cette option de mise en page complète offre la présentation la plus attrayante visuellement, avec de grandes images, des titres d'articles et des descriptions dans un format de grille attrayant qui maximise l'attrait visuel et la densité d'informations.

Personnalisé : Cette option flexible vous permet de créer une mise en page entièrement personnalisée en combinant et en ajustant divers paramètres de la section de configuration du contenu similaire pour répondre à vos exigences de conception spécifiques.

Style de mise en page

Le paramètre de style de mise en page vous permet de choisir entre les formats grille et liste pour afficher votre contenu associé. De plus, vous pouvez spécifier le nombre exact de résultats associés à afficher dans chaque bloc de contenu associé, vous donnant un contrôle précis sur la quantité de contenu présentée aux visiteurs.

Titre du bloc

Le paramètre de titre de bloc détermine le texte d'en-tête qui apparaît au-dessus de votre section de contenu associé sur le frontend. La valeur par défaut est « Contenu associé », mais vous pouvez la modifier en fonction du contenu de votre site.

Images

Choisissez la taille de l'image affichée avec chaque article associé. Les options de taille disponibles sont petite, moyenne et grande.

Descriptions :
Un interrupteur pour afficher ou masquer les descriptions du contenu du bloc associé.

Moteur

Le paramètre moteur définit quel moteur SearchWP sera utilisé pour déterminer les types d'articles inclus dans vos suggestions de contenu associé. Seules les sources d'articles qui ont été ajoutées à vos paramètres de moteur sélectionnés seront éligibles pour l'affichage dans le bloc de contenu associé.

Fonctionnalité d'ajout automatique

La fonctionnalité d'ajout automatique vous permet de sélectionner des types d'articles spécifiques où le bloc de contenu associé apparaîtra automatiquement sur les pages d'articles sans nécessiter de placement manuel. Seuls les types d'articles qui ont été ajoutés à votre moteur SearchWP seront disponibles pour la sélection dans ce paramètre.

Vous pouvez également spécifier la position exacte où le contenu associé doit apparaître sur vos pages, avec des options pour afficher le bloc en bas de votre contenu ou après un paragraphe spécifique dans le contenu de votre article.

Exclure les entrées

L'option d'exclusion des entrées offre un contrôle granulaire sur les articles qui apparaissent dans vos suggestions de contenu associé. Vous pouvez exclure des ID d'articles spécifiques de l'apparition dans tous les blocs de contenu associé sur votre site.

Alternativement, en sélectionnant l'option « Rechercher uniquement les ID sélectionnés », vous pouvez limiter le contenu associé à une liste définie d'articles.

Intégration de votre bloc

Au-delà de l'option d'ajout automatique, vous pouvez intégrer le bloc de contenu associé manuellement de différentes manières :

Intégration du bloc Gutenberg

La méthode du bloc Gutenberg offre une intégration transparente avec l'éditeur de blocs moderne de WordPress, vous permettant d'intégrer le contenu associé de SearchWP directement dans n'importe quel article ou page. Lors de la modification d'un article ou d'une page dans l'éditeur Gutenberg, recherchez simplement le bloc « Related » et ajoutez-le à l'emplacement souhaité.

Implémentation de shortcode

Vous pouvez utiliser le shortcode [searchwp_related] pour afficher le contenu associé dans toute zone de votre site compatible avec les shortcodes.

Intégration de widget

Pour les thèmes qui utilisent des zones de barre latérale avec fonctionnalité de widget, SearchWP Related fournit une option de widget dédiée qui vous permet d'afficher le contenu associé dans les zones de barre latérale de vos pages d'articles.

Intégration de code PHP

Si vous travaillez avec des modèles d'articles personnalisés ou des fichiers de thème, vous pouvez implémenter le contenu associé à l'aide de l'intégration de code PHP directe. Cette méthode offre le contrôle le plus technique et permet aux développeurs de placer les blocs de contenu associé précisément dans le code du modèle de thème personnalisé et les frameworks de style.

Configuration spécifique aux articles

Lorsque vous sélectionnez des types d'articles spécifiques sous l'option d'ajout automatique, des paramètres supplémentaires de l'extension SearchWP Related deviennent disponibles sous l'en-tête « Contenu lié SearchWP » dans l'écran de modification des articles pour ces types d'articles.

Mots-clés personnalisés

Par défaut, l'algorithme de contenu lié analyse les mots-clés trouvés dans les titres des articles pour identifier les suggestions de contenu lié pour chaque article. Cependant, l'option de mots-clés personnalisés vous permet de spécifier des mots-clés alternatifs pour trouver du contenu lié pour des articles spécifiques.

Cette fonctionnalité inclut un aperçu « Échantillon des résultats » qui affiche les articles qui apparaîtront dans le bloc de contenu lié en fonction de vos sélections de mots-clés personnalisés, vous permettant de vérifier la pertinence du contenu suggéré avant la publication.

Paramètres d'inclusion systématique

Le bouton de paramètres situé à droite de la section des mots-clés personnalisés révèle des options de configuration supplémentaires, y compris la fonctionnalité « Inclure systématiquement ».

Cette option puissante vous permet de sélectionner manuellement des titres d'articles spécifiques que vous souhaitez garantir l'apparition dans le bloc de contenu lié pour l'article actuel, indépendamment de la correspondance algorithmique. Cela garantit que le contenu important ou stratégiquement lié apparaît toujours dans vos suggestions de contenu lié, offrant un contrôle éditorial sur les recommandations automatisées.

Personnalisation de la sortie : le chargeur de modèles

Comme c'est le cas avec la Recherche en direct, Related utilise également un chargeur de modèles pour permettre une personnalisation complète des résultats Related. Il existe un modèle par défaut qui ressemble à ceci :

Screen Shot 2017-04-14 at 10.10.33 AM - SearchWP — Le modèle Related par défaut correspondra dans une certaine mesure à la police et aux couleurs de votre thème

Dans le dossier du plugin Related, il y a un autre dossier nommé templates contenant ce modèle Related par défaut (related.php) utilisé pour afficher le contenu Related.

~/wp-content/plugins/searchwp-related/templates/related.php

Le contenu de ce fichier est le suivant : related.php

Ne modifiez pas ce fichier directement. Si vous installez une mise à jour de Related, toutes les personnalisations que vous apportez à ce fichier seront écrasées !

Au lieu de cela, vous pouvez utiliser le chargeur de modèles intégré à Related pour ajouter votre propre modèle personnalisé dans votre thème.

Pour personnaliser la sortie du contenu Related, créez un nouveau dossier dans votre thème et collez une copie du modèle Related par défaut dans ce dossier, en conservant le même nom de fichier :

~/wp-content/themes/my-theme/searchwp-related/related.php

Vous pouvez personnaliser entièrement ce modèle pour répondre à vos besoins. Il est basé sur The Loop, et vous pouvez faire tout ce que vous feriez dans n'importe quel autre modèle de thème au sein de ce modèle.

Options du modèle

Bien que le modèle utilisé pour afficher le contenu Related soit principalement un modèle de thème standard, vous pouvez influencer le comportement de Related en modifiant le bloc de commentaires optionnel en haut du fichier :

/** * SearchWP Engine: default * Maximum Results: 3 */<code></code>

Vous pouvez personnaliser le moteur SearchWP utilisé et le nombre maximum d'entrées connexes affichées en modifiant la ligne appropriée en haut du modèle.

Vous pouvez également personnaliser les modèles de résultats par type de publication en ajoutant un trait d'union et le type de publication au nom du fichier. Par exemple, si vous créiez un modèle avec ce nom de fichier :

~/wp-content/themes/my-theme/searchwp-related/related-page.php

Il serait utiliséuniquement pour les Pages. Tous les autres types de publication utiliseraient le modèle de base.

Récupérer par programme le contenu connexe

Si vous souhaitez utiliser le chargeur de modèles mais à un endroit différent de celui utilisé par la case à cocher d'ajout automatique, laissez cette case décochée et modifiez votre fichier de modèle pour inclure ce qui suit là où vous souhaitez que le contenu connexe soit affiché :

	<?php

	// This should be within your single.php or other applicable template that has the $post defined
	$related = new SearchWP_Related\Template();
	echo $related->get_template();

view raw single.php hosted with ❤ by GitHub

Vous pouvez également ignorer complètement le chargeur de modèles et récupérer le contenu connexe directement dans le code de votre thème. Voici comment vous pouvez procéder :

	<?php

	/*
	* Programmatically find Related content from SearchWP Related
	*/

	// Instantiate SearchWP Related
	$searchwp_related = new SearchWP_Related();

	// Use the keywords as defined in the SearchWP Related meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$args = array(
	's' => $keywords, // The stored keywords to use
	'engine' => 'default', // the SearchWP engine to use
	'posts_per_page' => 3, // how many entries to find
	);

	// Retrieve Related content for the current post
	$related_content = $searchwp_related->get( $args );

	// Returns an array of Post objects for you to loop through
	print_r( $related_content );

view raw functions.php hosted with ❤ by GitHub

Vous pouvez passer un certain nombre d'arguments pour personnaliser la façon dont Related trouve le contenu connexe. Voici une description complète des arguments possibles :

	<?php

	// Use the saved keywords from the meta box
	$keywords = get_post_meta( get_the_ID(), $searchwp_related->meta_key, true );

	$defaults = array(
	'engine' => 'default', // Engine to use
	's' => $keywords, // Terms to search
	'fields' => 'all', // Return post objects, use 'ids' to return IDs
	'posts_per_page' => 3, // How many results to return
	'log' => false, // Log the search?
	'post__in' => array(), // Limit results pool?
	'post__not_in' => array() // Exclude posts from results?
	);

view raw functions.php hosted with ❤ by GitHub

Il est suggéré de mettre en place une forme de mise en cache (par exemple, via Transient) pour réduire l'utilisation des ressources.

Personnalisation de l'entrée : définition du contenu connexe

Par défaut, Related crée une liste de mots-clés à partir du titre de vos entrées. Les mots courants sont supprimés afin d'augmenter la pertinence des résultats connexes. Sur chaque écran de modification d'entrée, Related affiche une boîte de métadonnées vous permettant de personnaliser les mots-clés utilisés pour déterminer le contenu connexe :

searchwp-related - SearchWP — Échantillons de résultats en temps réel lors de la personnalisation des mots-clés

Un ensemble de trois exemples de résultats est affiché, vous permettant de personnaliser les mots-clés que vous utilisez si vous le souhaitez. Ceci n'est qu'un échantillon, le chargeur de modèles contrôle la façon dont les résultats sont affichés sur le front-end, et SearchWP détermine quelles entrées afficher au moment de l'exécution.

Les échantillons de résultats incluront tous les moteurs disponibles. Si vous souhaitez limiter les échantillons affichés à certains moteurs uniquement, vous pouvez utiliser ce filtre :

	<?php

	// Define the engines to use for the metabox samples.
	add_filter( 'searchwp_related_meta_box_sample_engines', function( $engines ) {
	return [ 'default', 'products' ];
	} );

view raw functions.php hosted with ❤ by GitHub

Journal des modifications

1.5.5

[Mise à jour] Compatibilité mise à jour avec WP 6.9.
[Correction] Ligne vide supplémentaire supprimée dans les éléments du menu déroulant.

1.5.4

[Correction] Brouillons, articles en attente listés dans l'option Inclure toujours et potentiellement affichés sur le front-end.
[Mise à jour] Mise à jour de l'outil de mise à jour.

1.5.3

[Nouveau] Ajout du hook searchwp_related_meta_box_sample_engines pour filtrer les moteurs affichés dans les échantillons de la boîte de métadonnées.
[Changement] Les résultats d'échantillons sont maintenant réactifs.

1.5.2

[Correction] Erreur JavaScript si l'option "Masquer l'annonce" de SearchWP est activée.

1.5.1

[Changement] Ajout de la balise "Testé jusqu'à" pour indiquer la compatibilité avec la dernière version de WP
[Changement] Fichiers de build supprimés pour éviter de déclencher des automatisations sur certains systèmes
[Correction] Erreur PHP lorsque le plugin SearchWP n'est pas actif

1.5.0

[Nouveau] La zone des paramètres est remaniée, offrant plus de contrôle sur le contenu et l'apparence visuelle du bloc Connexe
[Nouveau] Un nouveau bloc Gutenberg et un Shortcode sont ajoutés pour l'intégration manuelle
[Changement] La version minimale requise de SearchWP pour l'extension Related est 4.2.6
[Changement] Fonctions et méthodes redondantes/inutilisées supprimées

1.4.8

[Correction] Erreur dans les versions PHP antérieures à 7.3 causée par une virgule finale dans l'appel de fonction
[Correction] La liste des suggestions n'est pas réaffichée lors de la modification du champ Mots-clés dans la métabox de l'article
[Correction] Avis de dépréciation sur PHP 8.2

1.4.7

[Correction] Erreur d'analyse pour PHP 7.2 et versions antérieures
[Correction] Compatibilité avec SearchWP 4.2.0 et supérieur

1.4.6

[Nouveau] Tableau de contexte ajouté à searchwp_related_default_keywords
[Correction] Avis PHP
[Correction] Articles exclus en aperçu dans certains cas

1.4.5

[Correction] Rendu initial de l'aperçu

1.4.4

[Correction] Avis PHP, Erreur dans certains cas
[Mise à jour] Updater mis à jour

1.4.3

[Correction] Empêche la journalisation dans SearchWP Metrics lorsque applicable

1.4.2

[Correction] Corrige une erreur lors de l'utilisation de SearchWP 4

1.4.0

[Nouveau] Ajoute la prise en charge de SearchWP 4

1.3

[Nouveau] Forcer des entrées Related spécifiques pour chaque entrée
[Nouveau] Le contenu Related est maintenant mis en cache pendant 12 heures
[Nouveau] Hook pour contrôler la durée de vie du cache de requête en secondes searchwp_related_cache_length
[Nouveau] Hook pour contrôler si le cache est utilisé searchwp_related_cache_enabled
[Correction] L'ajout automatique ne fonctionnait pas dans certains cas
[Correction] La pagination n'était pas respectée dans certains cas
[Correction] Les mots-clés par défaut n'étaient pas renseignés dans certains cas
[Correction] Liens vers la documentation
[Changement] La boîte méta n'apparaît plus sur les types de publication non publics par défaut
[Changement] Résultats supplémentaires trouvés si l'ensemble des résultats initiaux est trop restreint par SearchWP
[Mise à jour] Source de traduction
[Mise à jour] Updater mis à jour

1.1.1

[Changement] L'ensemble de mots-clés de secours est maintenant défini lors de la sauvegarde des brouillons (auparavant lors de la publication)

1.1

[Nouveau] Ajoute un widget
[Nouveau] Nouveaux hooks pour contrôler le placement de la boîte de métadonnées searchwp_related_meta_box_context et searchwp_related_meta_box_priority

1.0.4

[Correction] Correction d'un problème avec des enqueues trop zélées

1.0.3

[Correction] Correction d'un problème où les entrées connexes n'étaient pas trouvées dans certaines circonstances
[Mise à jour] Updater mis à jour

1.0.2

[Correction] Les nouvelles entrées publiées ne sont plus automatiquement ignorées si aucun mot-clé n'est saisi, elles utiliseront les valeurs de secours par défaut
[Correction] L'implémentation du filtre searchwp_related_excluded_post_types est maintenant appliquée correctement et fonctionne

1.0.1

[Correction] Empêche l'erreur fatale PHP(<5.5) Impossible d'utiliser la valeur de retour de la fonction dans le contexte d'écriture

1.0.0

Version initiale

Associé

Configuration et intégration

Thèmes de mise en page

Style de mise en page

Intégration de votre bloc

Configuration spécifique aux articles

Personnalisation de la sortie : le chargeur de modèles

Options du modèle

Récupérer par programme le contenu connexe

Personnalisation de l'entrée : définition du contenu connexe

Journal des modifications

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.0

1.3

1.1.1

1.1

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

Créez dès aujourd'hui une meilleure expérience de recherche WordPress