Referenciación de entidades
Esta página explica cómo referenciar BookingJs, el widget de reserva de timum, con recursos y canales: mediante referencia de canal, de recurso o de producto.
Resumen
Existen tres tipos diferentes de referencias que puede pasar al widget. Cada una tiene efectos distintos sobre las citas mostradas.
Channel Reference
Los Resource Channels son entidades en timum, cada una de las cuales almacena una configuración que modifica la experiencia de reserva para los clientes. Cada recurso individual tiene cuatro canales que los usuarios pueden distribuir a sus clientes mediante un enlace.
timum.init({ ref: 'channel-reference@provider' });Resource Reference
Una referencia que apunta a un recurso cuyo canal se desconoce. Se utiliza el canal predeterminado (y su configuración correspondiente).
timum.init({ ref: 'resource-reference@provider' });Resource Reference con channelKey
Si no dispone de una referencia de canal, pero desea utilizar un canal distinto del predeterminado, puede indicar una combinación de referencia de recurso y channelKey.
timum.init({
ref: 'resource-reference@provider',
channelKey: 'RESOURCE_EXCLUSIVE'
});Valores de channelKey disponibles
| channelKey | Descripción |
|---|---|
RESOURCE_PUBLIC | Enlace de reserva público (predeterminado) |
RESOURCE_EXCLUSIVE | Acceso de reserva exclusivo |
RESOURCE_REFERENCE | Calendario de reservas integrado |
CALENDAR_PUBLIC | Vistas del plugin del sitio web y calendario completo |
Prioridades de referencia
La siguiente tabla muestra cómo gestiona BookingJs las distintas combinaciones de referencias:
| URL ref | init() ref | channelKey | Comportamiento |
|---|---|---|---|
| - | - | ignorado | Widget oculto |
| ResourceRef | ignorado | SÍ | Widget para channelKey |
| ResourceRef | ignorado | - | Canal predeterminado |
| - | ResourceRef | - | Canal predeterminado |
| - | ResourceRef | SÍ | Widget para channelKey |
| ChannelRef | ignorado | ignorado | Mostrar canal |
Referencias de producto (prdRefs)
Con prdRefs puede definir qué productos (tipos de cita) están disponibles para que el cliente elija.
timum.init({
ref: 'resource-reference@provider',
prdRefs: 'besichtigung' // Mostrar solo este producto
});
// O varios productos
timum.init({
ref: 'resource-reference@provider',
prdRefs: ['besichtigung', 'beratung']
});Referencias de franja horaria (tslRefs)
Para escenarios en los que solo se deben compartir citas específicas, puede utilizar tslRefs.
timum.init({
tslRefs: ['timeslot-uuid-1', 'timeslot-uuid-2']
});Nota:
Multi-Resource Widget
También puede ofrecer varios recursos en un solo widget:
timum.init({
ref: ['resource-1@provider', 'resource-2@provider', 'resource-3@provider'],
allResourcesOption: true // Mostrar la opción "Todos"
});