MANUALE DI COLLEGAMENTO - gruppost.com · Collegamento Gift-Card ... Collegamento Modulo Simple...

MANUALE DI COLLEGAMENTOVersione 2.3.5

Revisioni:Nome doc. Versione Autore Revisore Data Modifica

MANUALE COLLEGAMENTOBOOKING-ONE_v2.3.5.doc

A Giuseppe Massarotto Umberto Zanatta 12/mag/10 17:07


B Umberto Zanatta Umberto Zanatta 26/mag/10 11:00


C Umberto Zanatta Umberto Zanatta 10/nov/10 10:00


D Umberto Zanatta Umberto Zanatta 11/feb/11 14:45


E Umberto Zanatta Umberto Zanatta 04/apr/11 12:30


F Daniele Turcato Daniele Turcato 29/feb/12 09:22


G Giuseppe Donato Giuseppe Donato 10/Apr/12 11:15


H Daniele Turcato Daniele Turcato 08/Giu/12 11:15


I Daniele Turcato Daniele Turcato 22/Ago/12 14:45


L Giuseppe Donato Giuseppe Donato 16/gen/13 14:05

MM ONE Group Srl Pagina 1 di 22Via Calnova 119 - 30020 Noventa di Piave (VE) ItalyTel. +39 0421 65261 - Fax +39 0421 308056www.mm-one.com [email protected]

Le informazioni contenute nella presente sono riservate. La diffusione, distribuzione e/o copiatura parziale e/o totale del presente documento proibita sia ai sensi dellart. 616 c.p., che ai sensi del D.Lgs. n. 196/2003.

Uso confidenziale PubblicoInterno

http://www.mm-one.com/

Indice

1. Premessa..........................................................................................................................32. Panoramica dellambiente.................................................................................................33. Collegamento Booking-ONE.............................................................................................3

3.1 Collegamento iFrame con autoadattamento dell'altezza.......................................................4

4. Collegamento box di ricerca.............................................................................................55. Personalizzazione della grafica........................................................................................86. Collegamento form Richiesta informazioni.......................................................................87. Collegamento Listino prezzi..............................................................................................88. Collegamento Offerte........................................................................................................9

8.1 Dettaglio offerta testuale singola.........................................................................................10

9. Collegamento Gift-Card..................................................................................................1010. Collegamento Modulo Simple Chain............................................................................1011. Allegato A File CSS...................................................................................................1112. Customercare.................................................................................................................1613. Questionario...................................................................................................................16

13.1 Estrazione delle valutazioni e dei commenti pubblicati (Guest Review)...........................1713.2 Chiamata XMLRPC (Avanzata)........................................................................................21

14. API Prezzo Migliore.......................................................................................................2215. Attivazione ricerche da Tripadvisor................................................................................22




1. PremessaBooking One lo strumento ideale per Gestire le richieste e le prenotazioni delgli appartamenti on line. Con il presente manuale si intende supportare lamministratore del sito della struttura per procedere al corretto collegamento del sistema booking-ONE allinterno del sito della struttura e alla personalizzazione grafica allineandola a quella del sito.

2. Panoramica dellambienteIl booking-ONE fornisce diversi ambienti visualizzabili in modalit i-frame completamente autosufficienti, ognuno con una specifica funzionalit:

Booking-ONE: ambiente che permette di prenotare e calcolare il preventivo del soggiorno direttamente online

Richiesta informazioni: ambiente che permette di effettuare una richiesta di informazioni

Listino prezzi: ambiente che permette di visualizzare il listino prezzi delgli appartamenti presenti in booking-ONE

Visualizzazione offerte: ambiente che consente di visualizzare le offerte testuali inserite allinterno di booking-ONE

3. Collegamento Booking-ONEPer visualizzare il booking-ONE nel sito della struttura sufficiente includere allinterno della pagina un i-frame con richiamato il seguente link:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it

dove:

il parametro stid indica il codice intero univoco della struttura (comunicato allatto dellattivazione del booking-ONE)

il parametro lg consente di modificare la lingua (codice delle lingue disponibili in ISO2, it, en, de, fr, es, ru)




3.1 Collegamento iFrame con autoadattamento dell'altezzaE' possibile integrare booking-ONE in un iframe che si adatti in modo automatico all'altezza del contenuto valorizzando la variabile iframe_url con l'url (evidenziato in grassetto) della chiamata come da punto precedente (questa modalit utilizzabile anche con l'Frame delle offerte, enquiry, pricelist):

Documento senza titolo

$(function(){

var if_height;var iframe_url = 'https://reservation.cmsone.it/abs/indexabs.php?

stid=2&lg=it&type=offer';var src = iframe_url + "&referer_minisite=" + encodeURIComponent(

document.location.href);var iframe = $( '' );$( "#iframe" ).html( iframe );

$.receiveMessage(function(e){ if (e.data == "scrollTop") {

var top = parseInt($('#iframe').offset().top); $('html,body').animate({scrollTop:top}, 'slow');

} else { // posso togliere lo scroll // Get the height from the passsed data. var h = (Number( e.data.replace( /.*if_height=(\d+)(?:&|

$)/, '$1' ) )*1.1);




if ( !isNaN( h ) && h > 0 && h !== if_height ) { // Height has changed, update the iframe. iframe.height( if_height = h ); } $(iframe).attr('scrolling','no'); }

// An optional origin URL (Ignored where window.postMessage is unsupported).

}, iframe_url );});

4. Collegamento box di ricerca

Allinterno del sito della struttura possibile anche realizzare un box di prenotazione (vd immagine di esempio) collegata direttamente al booking-ONE.Il box di prenotazione dovr essere impostato in modo da trasferire al booking-ONE i parametri necessari per effettuare la ricerca di disponibilit delgli appartamenti inserite.

In base alle impostazioni della struttura (vendita a appartamento/vendita a persona) i parametri da trasferire al booking-ONE saranno i seguenti:

VENDITA A APPARTAMENTO (i prezzi inseriti nel Booking-ONE sono relativi allappartamento e non al numero degli occupanti)

I parametri necessari da trasferire al booking-ONE sono le date di arrivo (check-in), la data di partenza (check-out) e il numero di persone che entrano in ogni appartamento

Ad esempio se viene richiesta 1 appartamento con 2 occupanti per le date dal 17/11 al 19/11 la stringa da richiamare dovr essere:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&checkin=17-11-2009&checkout=19-11-2009&numRooms=1&bform[reqRooms][1][adults]=2&step2=1




dove: il parametro checkin indica la data di arrivo selezionata

il parametro checkout indica la data di partenza selezionata

il parametro numRooms indica il numero di appartamenti selezionate

il parametro bform[reqRooms][1][adults] indica il numero persone occupanti lappartamento 1

il parametro step2 consente di visualizzare direttamente gli appartamenti disponibili per i parametri impostati

Ulteriore esempio se vengono richieste 2 appartamenti, la prima con 2 occupanti e la seconda con 3 occupanti per le date dal 17/11 al 19/11 la stringa da richiamare dovr essere:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&checkin=17-11-2009&checkout=19-11-2009&numRooms=2&bform[reqRooms][1][adults]=2&bform[reqRooms][2][adults]=3&step2=1

VENDITA A PERSONA (i prezzi inseriti nel Booking-ONE sono relativi al numero degli occupanti, il prezzo complessivo della appartamenti dipende dal numero di occupanti e alla presenza o meno di bambini)

I parametri necessari da trasferire al booking-ONE sono le date di arrivo (check-in), la data di partenza (check-out), il numero di adulti, il numero di bambini e let dei bambini che entrano in ogni appartamento

Ad esempio se viene richiesta 1 appartamento con 2 adulti e 2 bambini di 10 e 12 anni per le date dal 17/11 al 19/11 la stringa da richiamare dovr essere:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&checkin=17-04-2009&checkout=19-04-2009&numRooms=1&bform[reqRooms][1][adults]=2&bform[reqRooms][1][child]=2&bform[reqRooms][1][childAge][1]=10&bform[reqRooms][1][childAge][2]=12&step2=1

dove: il parametro checkin indica la data di arrivo selezionata

il parametro checkout indica la data di partenza selezionata

il parametro numRooms indica il numero di appartamenti selezionate

il parametro bform[reqRooms][1][adults] indica il numero adulti occupanti lappartamento 1

il parametro bform[reqRooms][1][child] indica il numero bambini occupanti lappartamento 1

il parametro bform[reqRooms][1][childAge][1] indica let del bambino 1 occupante lappartamento 1




il parametro step2 consente di visualizzare direttamente gli appartamenti disponibili per i parametri impostati

Ulteriore esempio se vengono richieste 2 appartamenti, la prima con 2 adulti e 2 bambini di 10 e 12 anni e la seconda con 1 adulto e 1 bambino di 7 anni per le date dal 17/11 al 19/11 la stringa da richiamare dovr essere:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&checkin=17-04-2009&checkout=19-04-2009&numRooms=2&bform[reqRooms][1][adults]=2&bform[reqRooms][1][child]=2&bform[reqRooms][1][childAge][1]=10&bform[reqRooms][1][childAge][2]=12&bform[reqRooms][2][adults]=1&bform[reqRooms][2][child]=1&bform[reqRooms][2][childAge][1]=7&step2=1

E' possibile inoltre visualizzare lo step 2 visualizzando solo un camera/un listino e un trattamento desiderato, alla chiamata precedente possibile aggiungere i seguenti parametri:

roomPreSelection= Questo parametro visualizza solo la camera con id corrispondente per tutti i listini

listPreSelection= Questo parametro utilizzabile con il precedente permette di visualizzare solo il listino corrispondente

treatmentPreSelection= es. OB=only board HB=half board FB=fullboard, questo paramentro permette di visualizzare il trattamento desiderato




5. Personalizzazione della graficaPer personalizzare la grafica del booking-ONE possibile realizzare un file CSS inserendolo nel proprio spazio di hosting. Per richiamare il file CSS realizzato sufficiente aggiungere la stringa &style=https://mio-dominio.it/file-stile.css

ATTENZIONE : necessario che il file css e tutte le immagini per la personalizzazione grafica provengano da un dominio SSL (https) con certificato valido

Il file .css standard riportato come allegato al documento

Esempio di stringa da richiamare:

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&checkin=17-04-2009&checkout=19-04-2009&numRooms=1&bform[reqRooms][1][adults]=2&bform[reqRooms][1][child]=2&bform[reqRooms][1][childAge][1]=10&bform[reqRooms][1][childAge][2]=12&step2=1&style=https://mio-dominio.it/file-stile.css

6. Collegamento form Richiesta informazioniPer visualizzare il form di richiesta informazioni sufficiente aggiungere la stringa &type=enquiry


https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=enquiry

7. Collegamento Listino prezziPer visualizzare il form di richiesta informazioni sufficiente aggiungere la stringa &type=pricelist


https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=pricelist



http://www.mm-one.com/https://reservation.cmsone.it/abs/indexabs.php?stidhttps://reservation.cmsone.it/abs/indexabs.php?stidhttps://reservation.cmsone.it/abs/indexabs.php?stidhttps://reservation.cmsone.it/abs/indexabs.php?stid

8. Collegamento OffertePer visualizzare lelenco di tutte le offerte, delle descrizioni delle riduzioni e delle descrizioni dei multi listini inserite allinterno di Booking ONE, sufficiente aggiungere la stringa

&type=offer


https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=offerQuesta chiamata visualizzer tutti i tipi di offerta (testuali, miltilistini, e riduzioni), possibile per disattivare la visualizzazione di determinti tipi di offerta aggiungendo i seguenti parametri:

Per non visualizzare le offerte testuali:&offertxt=0

Per non visualizzare i multilistini:&offermultirate=0

Per non visualizzare le riduzioni:&offerreduction=0

Le offerte sono ordinate per data di scadenza inversa, quindi le offerte che scadono prima saranno visualizzate per prime, in caso di offerte di diverse tipologie che scadono nella stessa data l'odinamento sar Multilistini, Riduzioni, Offerte testuali.

E' possibile modificare l'ordinamento, im modo che le offerte vengano ordinate prima per tipologia e poi per data utilizzando il paramentro ordertype;&ordertype=MVO in questo caso le offerte saranno ordinate in questo ordine: M = MultilistiniV = RiduzioniO = Offerte testuali

E' possibile specificare una qualsiasi combinazione VMO, MOV ecc..

Dalla lista completa delle offerte lutente pu visualizzare il dettaglio offerta con il relativo box di prenotazione o con il pulsante che consente di prenotare direttamente lofferta (se impostati i parametri di ricerca della riduzione o del multilistino nel Booking One)

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=offerd&offer=&offertype=

Nel caso la pagina di prenotazione sia differente da quella nella quale presente liframe del dettaglio delle offerte, possibile aggiungere la stringa:

&bookingpage=http://www.miodimio.it/pagina_prenotazione.php

Esempio di stringa da richiamare:MM ONE Group Srl Pagina 9 di 22Via Calnova 119 - 30020 Noventa di Piave (VE) ItalyTel. +39 0421 65261 - Fax +39 0421 308056www.mm-one.com [email protected]


http://www.mm-one.com/https://reservation.cmsone.it/abs/indexabs.php?stidhttps://reservation.cmsone.it/abs/indexabs.php?stid

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=offer&bookingpage=http://www.miodimio.it/preonta.php

In questo modo dalla pagina del dettaglio offerta possibile uscire dall'IFRAME ed essere indirizzati su un'altra pagina del sito con il link di prenotazione. Si precisa inoltre che possibile aggiungere eventuali altri parametri in GET alla stringa sopraindicata.

Booking-ONE permette, inoltre, di visualizzare le offerte in formato XML. Per ottenere le offerte in formato XML sufficiente aggiungere alla stringa precedente il parametro offeroutput=xml :

https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=offer&offeroutput=xml

8.1 Dettaglio offerta testuale singolaPagina che server per richiamare l'offerta singola:


https://reservation.cmsone.it/abs/indexabs.php?stid=&lg=it&type=offerd&bookingpage=http://www.miodimio.it/preonta.php&offer=&offertype=O

9. Collegamento Gift-CardIl frontend della gift card raggiungibile all'indirizzo:

https://reservation.cmsone.it/booking/index.abs?stid=&type=giftcard

10. Collegamento Modulo Simple ChainIl modulo Simple Chain permette di collegare 2 o pi strutture appartenenti ad un unico gruppo/catena, consentendo di visualizzare le camere disponibili di tutte le strutture collegate. Per visualizzare la disponibilit di tutte le strutture collegate al Simple sufficiente utilizzare la seguente stringa:

https://reservation.cmsone.it/abs/indexabs.php?stid=6,8&lg=it&chid=1&stidsOrder=6,8

dove: nel parametro stid necessario riportare gli id di tutte le strutture della chain il parametro chid indica lid della catena creata nellABS ONE il parametro stidsOrder indica l'ordinamento delle strutture




11. Allegato A File CSS/*====================================================== GENERALE */

/* TIPO DI FONT E GRANDEZZA TESTO */body {

font-family:Arial, Helvetica, sans-serif;font-size:12px;

}

/* COLORE PRINCIPALE TEST0 */#container { color:#005380; }

/* STILE PRINCIPALE COLLEGAMENTI */#container a,#container a:hover,#container a:visited {

text-decoration:underline;color:#0274B0;

}

/* GRANDEZZA TESTO INPUT E SELECT */#container input,#container select {

font-size:11px;}

/* IMMAGINE CALENDARIO */#container input#bform\[checkin\],#container input#bform\[checkout\] {

background: #FFFFFF url(../images/calendar.png) no-repeat 66px center;}

/* STILE BOTTONI */#container .button,#container .button:visited {

background:#2976A0;color:#FFFFFF;border-top:1px solid #7FADC6;border-left:1px solid #7FADC6;border-right:1px solid #215E80;border-bottom:1px solid #215E80;

}

/* STILE BOTTONI: HOVER */#container .button:hover {

text-decoration:none;color:#FFFFFF;

}

/* STILE TITOLO PRINCIPALE */#container h2 {

color:#FFFFFF;background:#509AC8;

}

/* STILE TITOLO SECONDARIO */#container h3 {

color:#FFFFFF;background:#99C2D8;

}

/* SFONDO TABELLE */#container table {

background:#F3F8FA;




}

/* COLORE SFONDO BOX NESSUNA DISPONIBILITA' */#no_solutions {

background-color:transparent;}

/*============================================= STEP 1 */

/* STILE RIGHE APPARTAMENTI */#container form#form_step1 ul li {}

/* STILE BOTTONE LOGIN */#container form#form_login th.last input.button {

color:#FFFFFF;background:#2976A0;border-top:1px solid #7FADC6;border-left:1px solid #7FADC6;border-right:1px solid #215E80;border-bottom:1px solid #215E80;

}

/* STILE BOTTONE VERIFICA STEP 1 */#container form#form_step1 input.button {

color:#FFFFFF;background:#ED6C18;border-top:1px solid #F4A774;border-left:1px solid #F4A774;border-right:1px solid #BE5613;border-bottom:1px solid #BE5613;

}

/*============================================================ STEP 2 */

/* STILE PREZZO PRINCIPALE APPARTAMENTO */#container div.price strong {

font-size:15px;color:#CC3300;

}

/* STILE PREZZO SUPPLEMENTI E VARIAZIONI */#container div.price span { color:#CC3300; }

/* SFONDO BOX APPARTAMENTO DISPARI */#container ul.rooms li.odd { background:#F3F8FA; }

/* SFONDO BOX APPARTAMENTO PARI */#container ul.rooms li.even { background:#D9E9F1; }

/* STILE NOME APPARTAMENTO */#container ul.rooms h4 { font-size:16px; }

/* STILE TESTO APPARTAMENTI RIMANENTI */#container ul.rooms h4 span {

color:#CC3300;font-style:italic;text-decoration:underline;font-size:12px;

}

/* STILE BORDO IMMAGINE APPARTAMENTO */#container ul.rooms a.thumb img { border:2px solid #99C2D8; }

/* IMMAGINE LENTE DI INGRANDIMENTO / ZOOM APPARTAMENTO */#container ul.rooms a.thumb span.overlay {

background:url(../images/zoom.png) no-repeat;MM ONE Group Srl Pagina 12 di 22Via Calnova 119 - 30020 Noventa di Piave (VE) ItalyTel. +39 0421 65261 - Fax +39 0421 308056www.mm-one.com [email protected]



width:24px;height:24px;

}

/* STILE COLLEGAMENTI DETTAGLI */#container ul.rooms div.details_container a { color:#028FDB; }#container ul.rooms div.details a,#container ul.rooms div.price a { font-size:11px; }

/* STILE BORDO SEPARATORE BOARDING, SPECIAL OFFERS, VARIATIONS, POLICY */#container ul.rooms div.details div.boarding,#container ul.rooms div.details div.special_offers,#container ul.rooms div.details div.variations {

border-bottom:1px dotted #B8CFDC;}

/* STILE TESTO POLICY */#container ul.rooms div.details div.policy {

font-size:11px;line-height:1.2;

}

/* STILE TOTALE APPARTAMENTO */#container div.total {

color:#CC3300;border-top:1px solid #B8CFDC;

}

/* STILE BOTTONE SELEZIONA */#container ul.rooms div.total input.button,#container div.total input.button {

color:#FFFFFF;background:#ED6C18;border-top:1px solid #F4A774;border-left:1px solid #F4A774;border-right:1px solid #BE5613;border-bottom:1px solid #BE5613;

}

/* SFONDO RIGA APPARTAMENTO PRECEDENTE */#container .prev_room {

background:#F3F8FA;}

/*=================================================== MULTIRATE */

/* STILE BOX MULTIRATE */#container ul.multirate {

border:2px solid #CC3300;}

/* STILE DESCRIZIONE MULTIRATE */#container ul.multirate .description {

font-size:11px;line-height:1.4;border-bottom:1px dotted #CC3300;

}

/* STILE TITOLO MULTIRATE */#container ul.multirate .description h4 {

color:#CC3300;}

/* SFONDO BOX APPARTAMENTO PARI MULTIRATE */#container ul.multirate li.even {

background:#E4F3F2;MM ONE Group Srl Pagina 13 di 22Via Calnova 119 - 30020 Noventa di Piave (VE) ItalyTel. +39 0421 65261 - Fax +39 0421 308056www.mm-one.com [email protected]



}

/* SFONDO BOX APPARTAMENTO DISPARI MULTIRATE */#container ul.multirate li.odd {

background:#D0EAE2;}

/*========================================================= CHAIN */

/* STILE TITOLO CHAIN */#container h3.chain {

border:2px solid #509AC8;background:#509AC8;line-height:2;

}

/*=================================================== STEP 3 */

/* COLORE TESTO BOX CARTA DI CREDITO */#container div#credit_card {

color:;}

/* COLORE COLLEGAMENTI BOX CARTA DI CREDITO */#container div#credit_card a,#container div#credit_card a:hover,#container div#credit_card a:visited {

color:;}

/* IMMAGINE BOTTONE CONFERMA */#container input#submit_butt.confirm_it { background: url(../images/DEFAULT/confirm_it.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.confirm_en { background: url(../images/DEFAULT/confirm_en.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.confirm_de { background: url(../images/DEFAULT/confirm_de.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.confirm_fr { background: url(../images/DEFAULT/confirm_fr.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.confirm_es { background: url(../images/DEFAULT/confirm_es.jpg) no-repeat 0px 0px scroll; }

/* IMMAGINE BOTTONE INVIA */#container input#submit_butt.send_it { background: url(../images/DEFAULT/send_it.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.send_en { background: url(../images/DEFAULT/send_en.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.send_de { background: url(../images/DEFAULT/send_de.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.send_fr { background: url(../images/DEFAULT/send_fr.jpg) no-repeat 0px 0px scroll; }#container input#submit_butt.send_es { background: url(../images/DEFAULT/send_es.jpg) no-repeat 0px 0px scroll; }

/*====================================================== STEP 4 */

/* STILE BOX E TESTO CONFERMA PRENOTAZIONE */#container #result {

background:#FFFFFF;border:1px solid #ED6C18;color:#ED6C18;font-size:18px;font-weight:bold;

}

/* STILE TESTO NUMERO PRENOTAZIONE */#container #nr_prenotazione {MM ONE Group Srl Pagina 14 di 22Via Calnova 119 - 30020 Noventa di Piave (VE) ItalyTel. +39 0421 65261 - Fax +39 0421 308056www.mm-one.com [email protected]



font-size:14px;}

/* STILE BORDO CELLE DATI */#container table.data td {

border-bottom:1px dotted #99C2D8;}

/* SFONDO BOX STAMPA */#container form#stampa {

background:#F3F8FA;}

/* STILE BOX TOTALE SOGGIORNO */#container #total_reservation_price {

background:#99C2D8;}

/* STILE TESTO TOTALE SOGGIORNO */#container div.total_price p { font-size:14px; color:#145477; }

/*============================== TOOLTIPS DETTAGLI APPARTAMENTO E PREZZO */

/* STILE BOX E TESTO */.room_details,.detail{

border: 1px solid #549dca;background:#FFFFFF;color:#0274B0;line-height:1.4;font-size:11px;

}

/*====================================== IMMAGINI STEP */

#container #step_1 { background: url(../images/DEFAULT_FORTRAVEL/step_1.jpg) no-repeat right -20px; }#container #step_2 { background: url(../images/DEFAULT_FORTRAVEL/step_2.jpg) no-repeat right -20px; }#container #step_3 { background: url(../images/DEFAULT_FORTRAVEL/step_3.jpg) no-repeat right -20px; }#container #step_4 { background: url(../images/DEFAULT_FORTRAVEL/step_4.jpg) no-repeat right -20px; }

#container .step {background-position:right -65px;padding-top:72px; /* altezza dell'immagine di sfondo */height:33px;

}

#container .step h1,#container #step_1 h1,#container #step_2 h1,#container #step_3 h1,#container #step_4 h1 {

position:static;width:auto;background:#6294AF none repeat scroll 0 0;line-height:2.2;text-transform:uppercase;color:#FFFFFF;font-size:14px;margin-bottom:2px;padding-left:16px;text-shadow:none;

}




#container .step p { display:none; }

12.CustomercareL'indirizzo per il modulo customercare il seguente:

https://reservation.cmsone.it/customercare/indexabs.php?stid=lg=

dove: stid l'id della struttura lg la lingua in formato ISO2

13.QuestionarioQuesto modulo, 48 ore dopo il checkout del cliente, gli invia un questionario tramite mail. Il cliente che lo riceve pu compilarlo accedendo alla pagina web indicata nella mail.Il questionario compilato apparir immediatamente nel backend del BookingOne nella sezione modera commenti.

L'indirizzo per la compilazione del questionario inserito nella mail conterr il parametro pars essenziale per l'integrazione del questionario. Il parametro infatti, identifica l'hotel, il cliente che deve effettuare la valutazione e la lingua del questionario.

Il parametro pars deve essere usato per personalizzare la pagina che risponde al seguente link

https://reservation.cmsone.it/customercare/manager/services/edit_questionnaire.php?pars=

dove pars il parametro che arriva dall'email.L'integrazione possibile tramite l'uso di pagine html con iframe ad esempio tramite il linguaggio php l'html della pagina pu essere generato cos:

echo '';

Le dimensioni del iframe, height="985" width="670" , possono essere variate.La variabile della querystring $_GET["pars"] il parametro proveniente dalla mail.

Cosa inviare a MM-ONE:1. Le caratteristiche e i servizi dell'albergo di cui si vuole effettuare la valutazione. Con le

relative traduzioni nelle lingue supportate dal sito del cliente.2. Il testo della mail che invita alla compilazione del questionario i clienti e la sua

traduzioni.3. Il link della pagina del sito del cliente che integra il questionario tramite iframe.

Richieste da fare a MM-ONE: 1. L'albergatore o la software house che effetta l'integrazione del booking deve richiedere uno

o pi link di test del questionario. I link del questionario saranno legate a vecchie prenotazioni che non potranno pi ricevere il questionario di valutazione. Ogni link mono uso , l'uso termina infatti se viene effettuato l'invio del questionario.




13.1 Estrazione delle valutazioni e dei commenti pubblicati (Guest Review)

La pubblicazione dei commenti pu essere effettuata tramite un estrazioni dati dal XML, aggiornato dinamicamente, scaricabile dal url: http://reservation.cmsone.it/customercare/manager/services/guest_review.php?stid=&lg=

Il primo parametro indica l'identificativo della struttura di cui si vuol avere il display dei guest reviews.

Il secondo parametro indica la lingua con cui il cliente ha effettuato la prenotazione relativa al questionario (attenzione che il parametro case sensitive):

1. 'it'

2. 'en'

3. 'de'

4. 'fr'

5. 'es'

Esempio file XML

6.76922988891602

6.0000

4.5000

5.5000

8.0000

9.0000

6.0000

5.5000




7.0000

4.0000

4.0000

6.0000

Lorem ipsum dolor sit amet, consectetur

adipiscing elit. Duis dapibus tortor id dui auctor at fringilla purus dictum.

Aliquam volutpat malesuada augue, eu vestibulum orci convallis scelerisque.

Ut consequat bibendum purus, sed pellentesque turpis auctor ut.

Donec at convallis urna. Vivamus quam mauris, tempor pretium tincidunt ac,

adipiscing in quam. Mauris rhoncus orci vitae nibh auctor sit amet tincidunt felis tincidunt.

Nullam ac elit augue. Ut nunc odio, fringilla ac varius dignissim, iaculis sit amet eros.

]]>

Lorem ipsum dolor sit amet, consectetur

adipiscing elit. Duis dapibus tortor id dui auctor at fringilla purus dictum.









]]>

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Duis dapibus tortor id dui auctor at fringilla purus dictum.






]]>

2

3

3

8

8

6

5

6

4

4

6




...

...

Descrizione campi

(1-9 o . ) => Molteplicit 1 X => Molteplicit N

1. gr , tag di apertura , ne presente solo uno e contiene tutto i restanti campi2. average_total_rating ( molteplicit: 1 ) , il punteggio ottenuto tramite il questionario la

media dei valori di tutte le voci(Pulizia,Servizi,etc. ) presenti nei questionari immessi e pubblicati.

3. average_ratings ( molteplicit: 1 ) , il contenitore delle voci di valutazione ogni average_ratings contiene pi tag average_rating ( molteplicit: N ) . Ogni

average_rating un elmento che definisce una voce di valutazione. Ogni average_rating composto da ( molteplicit: 1 ) :

cat , descrizione testuale in lingua della voce di valutazione qAvg , valore medio di valutazione della voce

4. guest_reviews , contenitore di tutte le recensioni ( molteplicit: 1 ) ogni guest_reviews contiene pi tag guest_review ( molteplicit: N ) . Ogni

guest_review una recensione . ogni guest_review composto da i seguenti campi i quali possono essere presenti una sola volta:

qId ( molteplicit: 1 ) , identificativo del questionario gName ( molteplicit: 1 ), nome visitatore gCity ( molteplicit: 1 ) , citt di provenienza del visitatore gType ( molteplicit: 1 ) , tipologia del visitatore : Coppia giovane, Coppia

Matura, Gruppo di amici ,etc. qcDate ( molteplicit: 1 ) , data di inserimento del questionario qcPositive ( molteplicit: 1 ), commento positivio qcNegative ( molteplicit: 1 ) , commento negativo qcPrivacy ( molteplicit: 1 ) , se valorizzato con 0 stato richiesto di

nascondere il nome qcHotelManager ( molteplicit: 1 ), risposta del Hotel qcHotelPublished ( molteplicit: 1 ), se il valore 1 la recensione da

pubblicare qCountry ( molteplicit: 1 ), nazionalit di chi ha compilato il questionario

(ISO2) qCat ( molteplicit: 1 ), il codice numerico corrispondente al gType reservation_language ( molteplicit: 1 ), lingua di prenotazione reservation_checkin_date ( molteplicit: 1 ), data del checkin reservation_checkout_date ( molteplicit: 1 ), data del checkout




rat ( molteplicit: 1 ), elenco di rating composti come average_rating ma con i valori esatti

average ( molteplicit: 1 ), campo che indica la media dei voti del singolo questionario

13.2 Chiamata XMLRPC (Avanzata)Con il metodo 'backend.getGuestReviews' del server XMLRPC del Booking ONE possibile scaricare gli esiti dei questionari degli ospiti che hanno soggiornato in una determinata struttura.

Il metodo accetta due parametri:

Il primo parametro indica l'identificativo della struttura di cui si vuol avere il display dei guest reviews ed di tipo int.Il secondo parametro indica la lingua con cui il cliente ha effettuato la prenotazione relativa al questionario, di tipo string e deve assumere uno di questi tre valori (attenzione che il parametro case sensitive):

6. 'it'

7. 'en'

8. 'de'

9. 'fr'

10. 'es'

11. 'all' (se non si vuol fare distinguo di lingua).

Se la chiamata viene inoltrata correttamente il server risponde con un array di struct in cui ogni member ha 7 chiavi:

1. guest_name (di tipo string e indica il nome dell'ospite che ha inserito il questionario, a patto che lo stesso ospite ne abbia autorizzato la pubblicazione);

2. guest_nation (di tipo string e indica l'iso2 della nazione di provenienza dell'ospite, a patto che l'ospite l'abbia indicata);

3. review_date (di tipio string e indica la data di invio del questionario, nel formato YYYY-MM-DD);

4. positive_comment (di tipo string e contiene un commento positivo lasciato dall'ospite);5. negative_comment (di tipo string e contiene un commento negativo lasciato dall'ospite);6. average_evaluation (di tipo string e contiene la media totale delle valutazioni; le

valutazioni vanno da un minimo di 1 ad un massimo di 10);

7. single_cat_evaluation (di tipo struct i cui membri hanno come chiave il nome in INGLESE della singola categoria cui l'ospite pu dare un giudizio e come valore il giudizio dell'ospite, giudizio che va da un minimo di 1 ad un massimo di 10).

Per l'abilitazione del modulo e l'indirizzo del server XMLRPC chiamare il supporto tecnico di MM-ONE Group.




14.API Prezzo MiglioreE' possibile ottenere il miglior prezzo disponibile per una determinata ricerca.Il prezzo migliore sar restituito in formato JSON.

Per ottenere il prezzo necessario comporre la chiamata come per il tipo booking , fare riferimento al punto 4 del presente manuale, selezionando il tipo bestprice :

&type=bestprice

&authToken=

Note: questo tipo di chiamata non utilizzabile in una catena richiamando pi strutture contemporaneamente, possibile comunque richiamarle singolarmente

15.Attivazione ricerche da TripadvisorIl sistema di prenotazioni Booking One compatibile con la gestione del Direct Advertising di Tripadvisor.

Lutente proveniente da Trip Advisor verr indirizzato direttamente al sito della struttura, ed effettuer una ricerca nel booking one gi compilato con i parametri selezionati nel sito di Trip Advisor.

Per ottenere questo risultato necessario che la pagina di ricerca disponibilit del vostro sito effettui il PASSTHROUGH dei seguenti parametri:

1. bform[checkin]2. bform[checkout]3. numRooms4. bform[numRooms]5. bform[reqRooms][1][adults]6. bform[reqRooms][1][child]7. step28. advid9. stid10. pid11. lg

Per PASSTHROUGH si intende che i parametri ricevuti nella querystring (es. http://www.mioalbergo.it/ricerca.php?bform[checkin]=15-11-2012&bform[checkout]=17-11-2012&....) siano utilizzati cos come sono nel SRC del IFRAME del BookingONE escludendo gli eventuali valori di DEFAULT impostati nel vostro sito.

N.B tutti i parametri non coincidenti con quelli sopra riportati devono essere mantenuti, ad esempio va mantenuto il parametro style contenente il css del vostro sito (se presente).



http://www.mioalbergo.it/ricerca.php?bform[checkin]=15-11-2012&bform[checkout]=17-11-2012&http://www.mioalbergo.it/ricerca.php?bform[checkin]=15-11-2012&bform[checkout]=17-11-2012&http://www.mm-one.com/

1. Premessa2. Panoramica dellambiente3. Collegamento Booking-ONE3.1 Collegamento iFrame con autoadattamento dell'altezza

4. Collegamento box di ricerca5. Personalizzazione della grafica6. Collegamento form Richiesta informazioni7. Collegamento Listino prezzi8. Collegamento Offerte8.1 Dettaglio offerta testuale singola

9. Collegamento Gift-Card10. Collegamento Modulo Simple Chain11. Allegato A File CSS12. Customercare13. Questionario13.1 Estrazione delle valutazioni e dei commenti pubblicati (Guest Review)Esempio file XMLDescrizione campi

13.2 Chiamata XMLRPC (Avanzata)

14. API Prezzo Migliore15. Attivazione ricerche da Tripadvisor

CheckBox: OffCheckBox1: OffCheckBox2: Off

MANUALE DI COLLEGAMENTO - gruppost.com · Collegamento Gift-Card ... Collegamento Modulo Simple...

Documents

Transcript of MANUALE DI COLLEGAMENTO - gruppost.com · Collegamento Gift-Card ... Collegamento Modulo Simple...