Spiegazione dell'interfaccia "I miei contenuti

Introduzione alla ricerca MyContent

CleverReach offre un modo piuttosto semplice per integrare i propri contenuti utilizzando la procedura guidata. Per farlo, occorre impostare un semplice script dinamico (php, asp, jsp, perl, ...) che deve restituire dati in formato JSON in base a due passaggi.

1. Impostare valori di filtro personalizzati come ad es. nome e categoria del prodotto
2. Restituisce i risultati della ricerca e alcune impostazioni.

Date un'occhiata a questo esempio di base in PHP

1. Impostazione iniziale

CleverReach eseguirà un "POST" (non un GET) (?get=filter[&password=password]) sull'URL di ricerca prodotti memorizzato. Questo "DEVE" restituire filtri codificati in JSON, in modo che CleverReach possa impostare un modulo basato sui seguenti filtri per la ricerca dei dati da parte dell'utente. CleverReach creerà i campi di input in base ai filtri restituiti dall'utente. L'utente compila il modulo generato e i valori vengono inviati allo script per filtrare i risultati della ricerca.

L'esempio seguente crea un elenco a discesa di nome "Categoria" e un campo di input chiamato "Prodotto".

Esempio di risposta:

[	 
	{
	"name": "Category", //nome visualizzato del valore da ricercare 
	"description": "Place description here or leave emtpy", //[opzionale] descrizione dettagliata del campo
	"required":false, //è richiesto (true|false)
	"query_key": "category", //nome inviato (POST) del campo. NON usare "get" e "password" qui
	"type": "dropdown", //tipo di input (input | dropdown)
	"values": //se dropdown, impostare le opzioni qui
		[ {"text":"", "value":""}, //testo > testo visualizzato, valore > balla inviato
			{"text": "cat 1", "value":1}, //...
			{"text": "cat 2", "value":2},
			{"text": "cat 3", "value":3},
			{"text":"   subcat 1", "value":4}
		]
	}
	// ... (aggiungere tutti i filtri desiderati)
	, {
	"name": "Product",
	"description": "Inserire la descrizione qui o lasciare emtpy",
	"required":false,
	"query_key": "product",
	"type": "input"}
]
		

2. Risultati della ricerca

Quando l'utente preme il pulsante di ricerca, viene avviato un POST. CleverReach eseguirà un "POST" (non un GET) (?get=search[&password=password]) sull'URL di ricerca prodotti memorizzato. La risposta deve includere impostazioni ed elementi basati sul seguente formato.

La risposta codificata JSON è composta da 2 parti. Le "impostazioni", che contengono il tipo di risultato e altre opzioni, e gli "elementi", che contengono i risultati della ricerca.

Esempio di risposta:

{
	// Definisce i tipi di dati restituiti e le opzioni varie
	"settings":{
				"type": "product", // Determina il tipo di layout che gli utenti possono 
								// scegliere dopo la selezione dell'elemento 
								// I tipi disponibili sono: (rss | prodotto | contenuto)
								// "rss" > Solo layout di TESTO 
								// "prodotto" > Solo layout di PRODOTTO  
								// "contenuto" > Ignora i layout e usa il contenuto/descrizione dell'articolo come contenuto 
				
				// le seguenti opzioni saranno visualizzate dopo che l'utente ha scelto un layout
				 
				"link_editable":false, // permette all'utente di modificare il link (true|false)			
				"link_text_editable":false, // consente all'utente di modificare il testo del link (true|false)
				"image_size_editable":false, // consente all'utente di modificare le dimensioni delle immagini (true|false)
	},
				
	// array di risultati di ricerca effettivi				
	"items":	
		[
			{ "title": "Test Product 1", // Titolo
				"description": "Description text", // Se RSS o PRODUCT > description text.
				"content":"<b>contenuto HTML personalizzato</b>", // [opzionale] Se il tipo è "content", questo diventa il contenuto HTML
										// se non è impostato, verrà utilizzata la descrizione
										
				"image":'http://server.com/image.jpg', // [opzionale] Percorso dell'immagine  	
				"url":'http://www.server.com", // [opzionale] Link
				"price": "EUR 12,99", // [opzionale] (solo per i tipi di prodotto) Prezzo preformato
				"display_info": "additional info text" // [opzionale] aggiunge una riga di informazioni aggiuntive ai risultati della ricerca
			},
			// ...
			{"title": "Arkham City Batman Action Figure",
				"description": "Benvenuti ad Arkham City, la nuova "casa" di massima sicurezza per tutti i delinquenti, gangster, ... di Gotham City",
				"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'
			}
		]
}