Búsqueda

Explicación de la interfaz "Mis contenidos

Introducción a MyContent Search

CleverReach le ofrece una forma bastante sencilla de integrar sus propios contenidos utilizando el asistente. Para ello, hay que configurar un sencillo script dinámico (php, asp, jsp, perl, ...) que tiene que devolver datos formateados en JSON en base a dos pasos.

  1. Configurar valores de filtro personalizados como f.e. nombre y categoría del producto
  2. Devuelve los resultados de la búsqueda y algunos ajustes.

Eche un vistazo a este ejemplo básico de PHP

1. Configuración inicial

CleverReach realizará un "POST" (no GET) (?get=filter[&password=contraseña]) en la URL de búsqueda de productos almacenada. Esto "TIENE QUE" devolver filtros codificados en JSON para que CleverReach pueda configurar un formulario basado en los siguientes filtros para que el usuario busque datos. CleverReach creará campos de entrada basados en los filtros devueltos por usted. El usuario rellenará el formulario generado y estos valores se enviarán al script para filtrar los resultados de la búsqueda.

El siguiente ejemplo creará una lista desplegable llamada "Categoría" y un campo de entrada llamado "Producto".

Ejemplo de respuesta:

[	 
	{
	"name": "Categoría", /Nombre mostrado del valor a buscar 
	"description": "Coloque la descripción aquí o deje emtpy", //[opcional] descripción detallada del campo
	"required":false, //es requerido (true|false)
	"query_key": "categoría", /nombre submitido (POST) del campo. NO use "get" y "password" aquí
	"type": "dropdown", //tipo de entrada (input | dropdown)
	"values": //si es dropdown, establezca las opciones aquí
		[ {"text":"", "value":""}, //texto > texto mostrado, valor > balue enviado
			{"text": "cat 1", "value":1}, //...
			{"text": "cat 2", "value":2},
			{"text": "cat 3", "value":3},
			{"text":"   subcat 1", "value":4}
		]
	}
	// ... (añade tantos filtros como quieras)
	, {
	"name": "Producto",
	"description": "Pon la descripción aquí o deja emtpy",
	"required":false,
	"query_key": "producto",
	"type": "input"}
]

2. Resultados de la búsqueda

Una vez que el usuario pulsa el botón de búsqueda, se inicia un POST. CleverReach realizará un "POST" (no GET) (?get=search[&password=contraseña]) en la URL de búsqueda de productos almacenada. La respuesta tiene que incluir Ajustes y Elementos basados en el siguiente formato.

La respuesta codificada en JSON consta de 2 partes. Los "ajustes", que contienen el tipo de resultado y otras opciones, y los "elementos", que contienen los propios resultados de la búsqueda.

Ejemplo de respuesta:

{
	// define los tipos de datos devueltos y las opciones misc
	"settings":{
				"type": "product", // determina qué tipo de diseño pueden elegir los usuarios 
								// una vez seleccionado el elemento 
								// los tipos disponibles son: (rss | producto | contenido)
								// "rss" > Sólo maquetaciones de TEXTO 
								// "producto" > Sólo maquetaciones de PRODUCTO  
								// "contenido" > Ignora las maquetaciones y utiliza el contenido/descripción del artículo como contenido 
				
				// las siguientes opciones se mostrarán después de que el usuario haya elegido una maquetación
				 
				"link_editable":false, // permite al usuario cambiar el enlace (true|false)			
				"link_text_editable":false, // permite al usuario editar el texto del enlace (true|false)
				"image_size_editable":false, // permite al usuario cambiar el tamaño de las imágenes (true|false)
	},
				
	// array de resultados de búsqueda reales				
	"items":	
		[
			{ "title": "Test Product 1", // Título
				"description": "Description text", // Si es RSS o PRODUCT > description text.
				"content":"<b>contenido HTML personalizado</b>", // [opcional] Si el tipo es "content", este se convierte en el contenido HTML
										// si no está configurado, se utilizará la descripción
										
				"image":'http://server.com/image.jpg', // [opcional] Ruta de la imagen  	
				"url":'http://www.server.com', // [opcional] Enlace
				"price": "EUR 12,99", // [opcional] (sólo para tipos de producto) Precio preformado
				"display_info": "additional info text" // [opcional] añade una línea de información adicional a los resultados de búsqueda
			},
			// ...
			{"title": "Arkham City Batman Figura de Acción",
				"description":'Bienvenido a Arkham City, el nuevo "hogar" de máxima seguridad para todos los matones, gángsters, ...',
				"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'
			}
		]
}