PHP Esempi

PHP: Esempi di integrazione

Premessa

yacht4web rende disponibile una tecnologia chiamata search engine (motore di ricerca) che permette l'accesso a due metodi che sono l' elenco degli annunci  e la visualizzazione dell'annuncio della barca. Entrambi sono parametrizzabili e disponibili in 9 lingue.
Per poterli integrare con il vostro sito si possono scegliere due tecnologie, il metodo Embedded Http Request descritto in questa sezione o il più complesso ma versatile REST APIs.

Come leggere la lista degli annunci

Questo metodo è il più semplice e rapido e permette di includere nel vostro sito l'elenco degli annunci, con il minimo intervento, 
Consiste nel creare uno file PHP che contiene la vostra intestazione (header), un eventuale barra di navigazione (toolbar) ed il piede della pagina (footer)
All'interno del body inseriremo quindi il motore di ricerca di yacht4web. I colori e i molti parametri sono configurabili attraverso la sezione dedicata, nell'account dell'utente.


Esempio di integrazione elenco annunci

<!-- your Header ----->
<link href="http://cdn.yacht4web.com/css/1205/ywEngine.css" rel="stylesheet" type="text/css" />

<!-- your Navigation Bar ----->

<!-- Yacht4web engine core ----->
<div>
<?php
 error_reporting(~0); ini_set('display_errors', 1); // <-- only for debug

 function _add($sz,$szAdd) {
	if (strlen($sz)) $sz=$sz."&";
	$sz=$sz.$szAdd;
	return $sz;
 }

 $appId='[appid]';  // yacht4web appId key
 $idLang=isset($_GET["lang"])?$_GET["lang"]:"it";  // Choose ads language: en,fr,it,de,es,cn,ru,pt,ar

 // Get query params
 $szQuery=$_SERVER['QUERY_STRING'];
 if (!strstr($szQuery,"appid=")) $szQuery=_add($szQuery,"appid=".$appId);
 if (!strstr($szQuery,"nohf=")) $szQuery=_add($szQuery,"nohf=1");
 if (!strstr($szQuery,"_order=")) $szQuery=_add($szQuery,"_order=SHIP%20ASC");
 
 $url= "http://".$idLang.".yacht4web.com/srch?".$szQuery;
 $data = file_get_contents($url);
 echo $data;
?>
</div>
<!-- your Footer  ----->


Highlights
Integrare il l'elenco è rapido, ma sono necessari alcuni punti per permettere a yacht4web di strutturare il servizio in modo corretto.

  1. Includere la classe di stile di default ywEngine.css come illustrato nell'esempio
    Lo stile è deciso in parte da classi contenute nel file ed in parte da un tag <style/> personalizzato in base ai colori scelti nel setup del motore.
  2. Indicare il proprio codice appId all'interno della chiamata.
  3. Indicare la pagina/script nel vostro sito contiene il motore di ricerca
    E' necessario comprendere che la pagina del sito è localizzata sul vostro server, ma l'elenco delle barche vengono generate dl yacht4web.
    Per poter costruire in modo corretto  link per la navigazione, yacht4web ha la necessità di sapere il nome della vostra pagina URL (la pagina PHP che contiene il codice yacht4web).
    E' possibile indicare sia URL assoluti (Es http://<vostro sito>/search.php) che relativi (Es. /search.php).
  4. Indicare la pagina/script nel vostro sito contiene la visualizzazione della barca

Tutti gli argomenti/parametri vengono ritrasmessi all applicazione yacht4web/srch: fare quindi attenzione a non usare "internamente" parametri con lo stesso nome, usati dal motore di ricerca yacht4web (es appid o w).
Un parametro importante è lang che contiene le due lettere corrispondenti alla lingua da visualizzare.


Modulo (form) di ricerca / Parametri di ricerca
Attraverso il setup del motore di ricerca, potete indicare se desiderate avere un form di ricerca gestito da yacht4web.
In alternativa potete indicare attraverso dei parametri, il filtro degli annunci che desiderare estrarre
Le specifiche dei parametri possibili le trovate descritte qui

 

Come vedere un annuncio

La scheda dell'imbarcazione può essere visualizzata in due formati

  • strict - scheda in modalità breve (modalità di default)
  • detail - scheda dettagliata : indicare come parametro mode=dett

Il parametro head=1 indica che si vuole l'intestazione dell'azienda.
Il parametro nohf=1 indica che non si vuole l'intestazione html standard di yacht4web.
Il parametro lang la lingua desiderata

<?php

 $appId='[appId]';	// Id User
 $idLang=isset($_GET["lang"])?$_GET["lang"]:"it";	// Choose language: en,fr,it,de,es,cn,ru,pt,ar
 $idBoat=isset($_GET["id"])?$_GET["id"]:0;	// idBoat 

	error_reporting(~0); ini_set('display_errors', 1); // <-- remove  after test

	if ($idBoat>0) {
		$url= "http://".$idLang.".yacht4web.com/boatc?appid=".$appId."&id=".$idBoat;
        $url.="&mode=dett&head=1&nohf=1";
		$data = file_get_contents($url);
		echo $data;
		} else {
			printf("no boat selection");
		}
?>