| Amacı | Rezervasyon Motoru Etkinlik Sistemini yapılandırmak ve desteklenen etkinlikleri dinlemek için referans almak, ayrıca özel JavaScript içinde bu etkinliklerin veri yükü verilerini kullanmak. |
| En uygun olan | Tesis yöneticileri ve deneyimli web geliştiricileri |
| Ne zaman kullanılır | Rezervasyon Motoru etkinliklerini dinlemek, etkinlik veri yükleriyle çalışmak veya desteklenen etkinlik değişikliklerine yanıt vermek için özel JavaScript'e ihtiyaç duyduğunuzda |
| Gereksinimler | HTML, JavaScript ve Rezervasyon Motoru içinde özel kod deneyimi |
| Beklenen sonuç | Özel betiğiniz, Etkinlik Sistemini başlatabilir ve belgelenmiş veri yüklerini kullanarak desteklenen Rezervasyon Motoru etkinliklerini dinleyebilir veya tetikleyebilir. |
| Sınırlamalar | Cloudbeds, kendi uyguladığınız özel kodu desteklemez. Özelleştirmeler, Rezervasyon Motoru geliştikçe bakım gerektirebilir. |
Giriş
Etkinlik Sistemi, Rezervasyon Motorunun desteklenen etkinlikleri veri yükü ile göndererek özel betikler ve dış programlarla iletişim kurmasını sağlar. Bunu, Rezervasyon Motoru güncellemelerini almak ve Rezervasyon Motoru ayarlarında eklenen özel JavaScript ile özel işlemleri tetiklemek için kullanabilirsin.
Bu makale, eventSystem'in nasıl başlatılacağını, desteklenen etkinliklerin nasıl referans alınacağını ve bu etkinlikler için mevcut veri yükü verilerinin nasıl kullanılacağını açıklar.
Özel kod sınırlamaları ve bakım notları
- Burada verilen adımlar, HTML ve JavaScript konusunda zaten deneyimli olan kullanıcılar için ek bir bilgi kaynağıdır. Deneyimli web geliştiricileri için tasarlanmıştır.
- Cloudbeds ürünleri ve Rezervasyon Motoru geliştikçe, kendi uyguladığın özelleştirmeler güncelliğini yitirebilir veya ek çalışma gerektirebilir. Cloudbeds, özel kod işlevselliği için destek sağlayamaz.
- Uygulama sonrası kod davranışını hem masaüstü hem de mobil cihazlarda test et ve özel kodu güncel tutmak için düzenli olarak gözden geçir.
- Cloudbeds, otel web sitesi tasarımı/geliştirmesi veya profesyonel Özelleştirme Hizmetleri tarafından sağlanmayan özelleştirmeler konusunda destek sunmaz.
İçindekiler
- Event Emitter Sistemini nasıl kullanırsın
- Rezervasyon Motoru tarafından gönderilen etkinlikler
- Rezervasyon Motorunun abone olduğu etkinlikler
Event Emitter Sistemini nasıl kullanırsın
-
Hesap Menüsünün Ayarlar sayfasına git ve Rezervasyon Motoru bölümüne tıkla
- Özelleştir seçeneğine tıkla
-
Aşağıdaki kodu JavaScript alanına ekle
Etkinlik Sistemini kullanmak için, on-booking-engine-ready etkinliği için bir etkinlik dinleyicisi eklemen gerekir. Bu etkinlik, eventSystem öğesini şu şekilde açığa çıkarır:<script> window.addEventListener('on-booking-engine-ready', (e) => { const { eventSystem } = e.detail; }); </script> -
Kaydet butonuna tıkla
-
eventSystem arayüzünü uygular: IExternalEventSystem:
interface IExternalEventSystem { addEventListener: ( event: EventType, listener: (payload: PayloadOf<EventType>) => void ) => void; dispatchEvent: (event: EventType, payload: PayloadOf<EventType>) => void; removeEventListener: ( event: EventType, listener: (payload: PayloadOf<EventType>) => void ) => void; }EventType tetikleyebileceğimiz veya dinleyebileceğimiz etkinlik türünü ifade eder, PayloadOf<EventType> ise etkinlikle birlikte gönderilen veri yükünü ifade eder.
Rezervasyon Motoru tarafından gönderilen etkinlikler
- currency-change etkinliği:
Kullanıcı, üst bilgideki para birimi seçicisinden Rezervasyon Motoru'nun para birimini değiştirdiğinde bu etkinlik tetiklenir. payload içindeki currency değeri, seçilen para biriminin kısaltmasıdır ve URL'deki currency sorgu parametresinde göründüğü şekildedir.
export type CurrencyChangeEvent = {
event: 'currency-change';
payload: { currency: Currency };
};- language-change etkinlik:
Kullanıcı, üst bilgideki dil seçicisinden Rezervasyon Motoru'nun dilini değiştirdiğinde bu etkinlik tetiklenir. payload içindeki language değeri, seçilen dilin kısaltmasıdır ve URL'de göründüğü şekildedir.
type LanguageChangeEvent = {
event: 'language-change';
payload: { language: Language };
};- reservation-created etkinlik:
Rezervasyon Motoru'nda bir rezervasyon oluşturulduğunda bu etkinlik tetiklenir.
type ReservationCreatedEvent = {
event: 'reservation-created';
payload: CreatedReservation;
};CreatedReservation şu durumlarda:
interface CreatedReservation {
booking_id?: `${number}`;
booking_total?: number;
checkin_date?: string;
checkout_date?: string;
city?: string;
currency_code?: string;
custom_payment_method?: string;
hotel_name?: string;
nights?: number;
payment_method?: PAYMENT_METHOD;
real_booking_total?: number;
resRooms?: {
adults: `${number}`;
id: `${number}`;
kids: `${number}`;
package: `${number}`;
package_name: string | null;
rate_id: `${number}`;
room_total: `${number}`;
room_type_id: `${number}`;
room_type_name: string;
room_type_photos: ({
TYPE?: string;
alt: string;
cropParam: string | null;
croppedImage: string;
fullPath: string;
galleryPath?: string | null;
id: string;
imageHeight: string;
imageWidth: string;
mime?: string;
originalName: string;
ownerId?: string;
ownerType?: string;
parentId: string;
path: string;
section?: string;
size?: string;
thumbPath: string;
uploadedAt?: string;
utype?: string;
} & {
featured: number;
featuredPath: string | null;
})[];
}[];
rooms?: Record<string, {
adults: number;
amount: number;
bookedId: string[];
kids: number;
name: string;
packageId?: string;
packageName?: string;
picture?: string;
price?: number;
rateId: string;
roomId: string;
unit?: string;
}>;
state?: string;
total_tax?: number;
widget_property?: number;
} custom_payment_method ve payment_method hakkında notlar
-
payment_method, rezervasyonun dahili ödeme yöntemini yansıtır; örneğinebankingveyacardsgibi. -
custom_payment_method, yalnızca misafir Özel Ödeme Seçeneği seçtiğinde doldurulur. Bu alan, o seçeneğinid'sini tutar; aksi haldeundefinedolur.
Rezervasyon Motorunun Abone Olduğu Etkinlikler
- custom-payment-option-change
Bu etkinlik, müşterilerine Özel Ödeme Seçeneği sunmak isteyen tesisler için kullanılır.
type CustomPaymentOptionChangeEvent = {
event: 'custom-payment-option-change';
payload: {
id: string;
instructions?: string;
name: string;
};
};Sonraki Adım
Etkinlik Sistemini nasıl yapılandırıp referans vereceğini anladıktan sonra, Rezervasyon Motoruna üçüncü taraf ödeme ağ geçitleri ve hediye kartları eklemeye devam et; burada özel ödeme seçenekleriyle ilgili pratik bir örnek bulacaksın.
Yorumlar
Yorum yazmak için lütfen oturum açın: oturum aç.