Recherche

Explication de l'interface "Mon contenu

MyContent Search Introduction

CleverReach vous offre un moyen très simple d'intégrer votre propre contenu en utilisant l'assistant. Pour ce faire, vous devez mettre en place un simple script dynamique (php, asp, jsp, perl, ...) qui doit renvoyer des données formatées en JSON selon deux étapes.

  1. Définir des valeurs de filtre personnalisées telles que f.e. le nom et la catégorie du produit
  2. Renvoie les résultats de la recherche et certains paramètres.

Voici un exemple de base en PHP

1. Configuration initiale

CleverReach effectuera un "POST" (pas de GET) (?get=filter[&password=password]) sur l'URL de recherche de produits stockée. Ceci "DOIT" renvoyer des filtres encodés en JSON afin que CleverReach puisse configurer un formulaire basé sur les filtres suivants pour que l'utilisateur puisse rechercher des données. CleverReach créera des champs de saisie sur la base des filtres que vous aurez renvoyés. L'utilisateur remplit alors le formulaire généré et ces valeurs sont renvoyées à votre script afin de filtrer les résultats de la recherche.

L'exemple suivant crée une liste déroulante nommée "Catégorie" et un champ de saisie nommé "Produit".

Exemple de réponse :

[	 
	{
	"name" : "Category", //Nom affiché de la valeur à rechercher 
	"description" : "Place description here or leave emtpy", //[facultatif] description détaillée du champ
	"required":false, //est obligatoire (true|false)
	"query_key" : "category", //nom du champ soumis (POST). N'UTILISEZ PAS "get" et "password" ici
	"type" : "dropdown", //type d'entrée (input | dropdown)
	"values" : //si dropdown, définissez les options ici
		[ {"text" :", "value" :""}, //texte > texte affiché, valeur > valeur soumise
			{"text" : "cat 1", "value":1}, //...
			{"text" : "cat 2", "value":2},
			{"text" : "cat 3", "value":3},
			{"text" : "   subcat 1", "value":4}
		]
	}
	// ... (ajoutez autant de filtres que vous le souhaitez)
	, {
	"name" : "Product",
	"description" : "Place description here or leave emtpy",
	"required":false,
	"query_key" : "product",
	"type" : "input" }
]

2. Résultats de la recherche

Une fois que l'utilisateur a cliqué sur le bouton de recherche, un POST est lancé. CleverReach effectuera un "POST" (pas de GET) (?get=search[&password=password]) sur l'URL de recherche de produits stockée. La réponse doit inclure les paramètres et les éléments selon le format suivant.

La réponse codée en JSON se compose de deux parties. Les "paramètres", qui contiennent le type de résultat et d'autres options, et les "éléments", qui contiennent les résultats de recherche proprement dits.

Exemple de réponse :

{
	// définit les types de données renvoyées et les options diverses
	"settings":{
				"type" : "product", // détermine le type de mise en page que les utilisateurs peuvent 
								// choisir après la sélection de l'élément 
								// les types disponibles sont : (rss | product | content)
								// "rss" > Mises en page TEXTE uniquement 
								// "product" > Mises en page PRODUIT uniquement  
								// "content" > Ignore les mises en page et utilise le contenu/la description de l'article comme contenu 
				
				// les options suivantes s'affichent après que l'utilisateur a choisi une mise en page
				 
				"link_editable":false, // permet à l'utilisateur de modifier le lien (true|false)			
				"link_text_editable" :false, // permet à l'utilisateur de modifier le texte du lien (true|false)
				"image_size_editable":false, // permet à l'utilisateur de modifier la taille des images (true|false)
	},
				
	// tableau des résultats de recherche actuels				
	"items" :	
		[
			{ "title" : "Test Product 1", // Titre
				"description" : "Description text", // Si RSS ou PRODUIT > texte de description.
				content" :"<b>custom HTML content</b>", // [optionnel] Si le type est "content", cela devient le contenu HTML
										// s'il n'est pas défini, la description sera utilisée
										
				"image" : "http://server.com/image.jpg", // [optionnel] Chemin de l'image  	
				"url" : "http://www.server.com', // [optionnel] Lien
				"price" : "EUR 12,99", // [optionnel] (uniquement pour les types de produits) Prix préformaté
				"display_info" : "additional info text" // [optionnel] ajoute une ligne d'information supplémentaire aux résultats de la recherche
			},
			// ...
			{"title" : "Arkham City Batman Action Figure",
				"description" : "Welcome to Arkham City, the new maximum security "home" for all of Gotham City's thugs, gangsters, ...",
				"image" : "http://ecx.images-amazon.com/images/I/41fR%!B(MISSING)l-cb5L._SL500_AA300_.jpg",
				"price" : "$ 12,99",
				"url" : "http://www.amazon.com/DC-Direct-Batman-Arkham-Series/dp/B005UH6HOG"
			}
		]
}