Referenziazione delle entità
Questa pagina spiega come referenziare BookingJs, il widget di prenotazione timum, con risorse e canali: tramite riferimento a canale, risorsa o prodotto.
Panoramica
Esistono tre diversi tipi di riferimenti che è possibile passare al widget. Ciascuno ha effetti diversi sugli appuntamenti visualizzati.
Channel Reference
I Resource Channels sono entità in timum, ciascuna delle quali memorizza una configurazione che modifica l'esperienza di prenotazione per i clienti. Ogni singola risorsa ha quattro canali che gli utenti possono distribuire ai propri clienti tramite un link.
timum.init({ ref: 'channel-reference@provider' });Resource Reference
Un riferimento che punta a una risorsa il cui canale è sconosciuto. Viene utilizzato il canale predefinito (e la relativa configurazione).
timum.init({ ref: 'resource-reference@provider' });Resource Reference con channelKey
Se non si dispone di un riferimento a canale ma si desidera utilizzare un canale diverso da quello predefinito, è possibile indicare una combinazione di riferimento a risorsa e channelKey.
timum.init({
ref: 'resource-reference@provider',
channelKey: 'RESOURCE_EXCLUSIVE'
});Valori channelKey disponibili
| channelKey | Descrizione |
|---|---|
RESOURCE_PUBLIC | Link di prenotazione pubblico (predefinito) |
RESOURCE_EXCLUSIVE | Accesso di prenotazione esclusivo |
RESOURCE_REFERENCE | Calendario di prenotazione incorporato |
CALENDAR_PUBLIC | Viste del plugin del sito web e calendario complessivo |
Priorità dei riferimenti
La tabella seguente mostra come BookingJs gestisce le diverse combinazioni di riferimenti:
| URL ref | init() ref | channelKey | Comportamento |
|---|---|---|---|
| - | - | ignorato | Widget nascosto |
| ResourceRef | ignorato | SÌ | Widget per channelKey |
| ResourceRef | ignorato | - | Canale predefinito |
| - | ResourceRef | - | Canale predefinito |
| - | ResourceRef | SÌ | Widget per channelKey |
| ChannelRef | ignorato | ignorato | Mostra canale |
Riferimenti prodotto (prdRefs)
Con prdRefs è possibile definire quali prodotti (tipi di appuntamento) sono disponibili per la scelta del cliente.
timum.init({
ref: 'resource-reference@provider',
prdRefs: 'besichtigung' // Mostra solo questo prodotto
});
// Oppure più prodotti
timum.init({
ref: 'resource-reference@provider',
prdRefs: ['besichtigung', 'beratung']
});Riferimenti fascia oraria (tslRefs)
Per gli scenari in cui devono essere condivisi solo determinati appuntamenti, è possibile utilizzare tslRefs.
timum.init({
tslRefs: ['timeslot-uuid-1', 'timeslot-uuid-2']
});Nota:
Multi-Resource Widget
È inoltre possibile offrire più risorse in un unico widget:
timum.init({
ref: ['resource-1@provider', 'resource-2@provider', 'resource-3@provider'],
allResourcesOption: true // Mostra l'opzione "Tutti"
});