Uitleg "Mijn inhoud" interface

Inleiding tot zoeken met MyContent

CleverReach biedt u een vrij eenvoudige manier om uw eigen inhoud te integreren met behulp van de wizard. Hiervoor moet je een eenvoudig dynamisch script opzetten (php, asp, jsp, perl, ...) dat JSON-geformatteerde gegevens moet teruggeven op basis van twee stappen.

1. Aangepaste filterwaarden instellen zoals bijv. productnaam en -categorie
2. Zoekresultaten en enkele instellingen weergeven.

Kijk eens naar dit PHP basisvoorbeeld

1. Eerste installatie

CleverReach zal een "POST" (geen GET) doen (?get=filter[&password=password]) op de opgeslagen Product Zoeken URL. Dit "MOET" JSON-gecodeerde filters retourneren, zodat CleverReach een formulier kan instellen op basis van de volgende filters voor de gebruiker om gegevens te zoeken. CleverReach maakt invoervelden aan op basis van de door u geretourneerde filters. De gebruiker vult dan het gegenereerde formulier in en deze waarden worden teruggestuurd naar je script om de zoekresultaten te filteren.

Het volgende voorbeeld maakt een vervolgkeuzelijst met de naam "Categorie" en een invoerveld met de naam "Product".

Voorbeeld van een antwoord:

[	 
	{
	"name":"Category", //Displayed naam van de te zoeken waarde 
	"description":"Place description here or leave emtpy", //[optioneel] gedetailleerde beschrijving van het veld
	"required":false, //is vereist (true|false)
	"query_key":"category", //submited (POST) naam van het veld. GEBRUIK hier GEEN "get" en "password"
	"type":"dropdown", //invoertype (input | dropdown)
	"values": //indien dropdown, stel hier opties in
		[ {"text":"","value":""}, //tekst > weergegeven tekst, waarde > verzonden balue
			{"text":"cat 1","value":1}, //...
			{"text":"cat 2","value":2},
			{"text":"cat 3","value":3},
			{"text":"   subcat 1","value":4}
		]
	}
	// ... (voeg zoveel filters toe als je wilt)
	, {
	"name":"Product",
	"description":"Plaats beschrijving hier of laat emtpy staan",
	"required":false,
	"query_key":"product",
	"type":"input"}
]
		

2. Zoekresultaten

Zodra de gebruiker op de zoekknop drukt, wordt een POST gestart. CleverReach zal een "POST" (geen GET) (?get=search[&password=password]) uitvoeren op de opgeslagen Product Search URL. Het antwoord moet instellingen en items bevatten volgens het volgende formaat.

Het JSON-gecodeerde antwoord bestaat uit 2 delen. De "instellingen", die het type resultaat en diverse opties bevatten en de "items", die de eigenlijke zoekresultaten zelf bevatten.

Voorbeeld van een antwoord:

{
	// definieer geretourneerde gegevenstypes en misc opties
	"settings":{
				"type":"product", // bepaalt welk type lay-out gebruikers kunnen 
								// kiezen nadat item is geselecteerd 
								// beschikbare types zijn: (rss | product | content)
								// "rss" > alleen TEKST lay-outs 
								// "product" > alleen PRODUCT lay-outs  
								// "content" > negeert lay-outs en gebruikt de inhoud/beschrijving van het item als inhoud 
				
				// de volgende opties worden weergegeven nadat de gebruiker een lay-out heeft gekozen
				 
				"link_editable":false, // laat gebruiker link wijzigen (true|false)			
				"link_text_editable":false, // laat gebruiker linktekst wijzigen (true|false)
				"image_size_editable":false, // laat gebruiker afbeeldingsformaten wijzigen (true|false)
	},
				
	// array van actuele zoekresultaten				
	"items":	
		[
			{"title":"Testproduct 1", // Titel
				"description":"Beschrijvingstekst", // Indien RSS of PRODUCT > beschrijvingstekst.
				"content":"<b>aangepaste HTML-content</b>", // [optioneel] Als type "content" is, wordt dit de HTML-content
										// als deze niet is ingesteld, wordt de beschrijving gebruikt
										
				"image":"http://server.com/image.jpg", // [optioneel] Afbeeldingspad  	
				"url":"http://www.server.com", // [optioneel] Link
				"price":"EUR 12,99", // [optioneel] (alleen voor producttypen) Voorgeformuleerde prijs
				"display_info":"additional info text" // [optioneel] voegt een extra informatieregel toe aan de zoekresultaten
			},
			// ...
			{ "title":"Arkham City Batman Action Figure",
				"description":"Welkom in Arkham City, het nieuwe maximaal beveiligde "thuis" voor alle schurken, gangsters, ... van 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"
			} }.
		]
}