| วัตถุประสงค์ | กำหนดค่าและอ้างอิงระบบอีเวนต์ของเครื่องมือการจองเพื่อฟังอีเวนต์ที่รองรับและใช้ข้อมูลเพย์โหลดของอีเวนต์เหล่านั้นใน JavaScript ที่กำหนดเอง |
| เหมาะสำหรับ | ผู้ดูแลระบบที่พักและผู้พัฒนาเว็บที่มีประสบการณ์ |
| ใช้เมื่อ | คุณต้องการ JavaScript ที่กำหนดเองเพื่อฟังอีเวนต์ของเครื่องมือการจอง ทำงานกับเพย์โหลดของอีเวนต์ หรือโต้ตอบกับการเปลี่ยนแปลงของอีเวนต์ที่รองรับ |
| ข้อกำหนด | มีประสบการณ์กับ HTML, JavaScript และโค้ดที่กำหนดเองในเครื่องมือการจอง |
| ผลลัพธ์ที่คาดหวัง | สคริปต์ที่กำหนดเองของคุณสามารถเริ่มต้นระบบอีเวนต์และฟังหรือส่งอีเวนต์ของเครื่องมือการจองที่รองรับโดยใช้เพย์โหลดที่มีเอกสารประกอบ |
| ข้อจำกัด | Cloudbeds ไม่รองรับโค้ดที่กำหนดเองที่ผู้ใช้เพิ่มเอง การปรับแต่งอาจต้องมีการบำรุงรักษาเมื่อเครื่องมือการจองมีการพัฒนา |
บทนำ
ระบบอีเวนต์ช่วยให้เครื่องมือการจองสื่อสารกับสคริปต์ที่กำหนดเองและโปรแกรมภายนอกโดยการส่งอีเวนต์ที่รองรับพร้อมข้อมูลเพย์โหลด ใช้ระบบนี้เพื่อรับการอัปเดตจากเครื่องมือการจองและกระตุ้นการทำงานที่กำหนดเองจาก JavaScript ที่เพิ่มในการตั้งค่าของเครื่องมือการจอง
บทความนี้อธิบายวิธีเริ่มต้น eventSystem อ้างอิงอีเวนต์ที่รองรับ และใช้ข้อมูลเพย์โหลดที่มีสำหรับอีเวนต์เหล่านั้น
ข้อจำกัดของโค้ดที่กำหนดเองและหมายเหตุการบำรุงรักษา
- ขั้นตอนที่ให้ไว้ที่นี่เป็นแหล่งข้อมูลเพิ่มเติมสำหรับผู้ใช้ที่มีความคุ้นเคยกับ HTML และ JavaScript อยู่แล้ว โดยมีวัตถุประสงค์สำหรับ ผู้พัฒนาเว็บที่มีประสบการณ์ เท่านั้น
- เนื่องจากผลิตภัณฑ์ของ Cloudbeds และเครื่องมือการจองมีการพัฒนาอย่างต่อเนื่อง การปรับแต่ง โค้ดที่ทำเองอาจล้าสมัยหรือจำเป็นต้องมีการปรับปรุงเพิ่มเติม Cloudbeds ไม่สามารถให้การสนับสนุน ในการทำงานของโค้ดที่กำหนดเองได้
- ทดสอบพฤติกรรมของโค้ดหลังจากนำไปใช้ทั้งบน เดสก์ท็อปและมือถือ และตรวจสอบโค้ดที่กำหนดเองอย่างสม่ำเสมอเพื่อให้ทันสมัย
- Cloudbeds ไม่ให้ความช่วยเหลือด้านการออกแบบ/พัฒนาเว็บไซต์โรงแรม หรือการปรับแต่งที่ไม่ได้จัดทำโดย บริการปรับแต่ง มืออาชีพของเรา
สารบัญ
วิธีใช้ระบบ Event Emitter
- ไปที่หน้า การตั้งค่า
ในเมนู บัญชี
แล้วคลิกที่ส่วน เครื่องมือการจอง
- คลิกที่ ปรับแต่ง
-
เพิ่มโค้ดด้านล่างลงในช่อง JavaScript
เพื่อใช้ระบบอีเวนต์ คุณต้องเพิ่มตัวฟังอีเวนต์สำหรับอีเวนต์ on-booking-engine-ready ซึ่งจะเปิดเผย eventSystem ดังนี้:<script> window.addEventListener('on-booking-engine-ready', (e) => { const { eventSystem } = e.detail; }); </script> -
คลิก บันทึก
-
eventSystem ทำหน้าที่เป็น อินเตอร์เฟส 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 หมายถึงประเภทของอีเวนต์ที่เราสามารถเรียกใช้หรือฟังได้ และPayloadOf<EventType> หมายถึงข้อมูลที่ส่งมาพร้อมกับอีเวนต์นั้น
อีเวนต์ที่เครื่องมือการจองส่งออก
- currency-change อีเวนต์:
เหตุการณ์นี้จะถูกเรียกใช้เมื่อผู้ใช้งานเปลี่ยนสกุลเงินของเครื่องมือการจองจากตัวเลือกสกุลเงินในส่วนหัว ค่าของ currency ใน payload คือคำย่อของสกุลเงินที่เลือก ซึ่งเหมือนกับที่ปรากฏในพารามิเตอร์ currency ของ URL
export type CurrencyChangeEvent = {
event: 'currency-change';
payload: { currency: Currency };
};- language-change event:
เหตุการณ์นี้จะถูกเรียกใช้เมื่อผู้ใช้งานเปลี่ยนภาษาในเครื่องมือการจองจากตัวเลือกภาษาในส่วนหัว ค่า language ใน payload คือคำย่อของภาษาที่เลือก ซึ่งเหมือนกับที่ปรากฏใน URL
type LanguageChangeEvent = {
event: 'language-change';
payload: { language: Language };
};- reservation-created event:
เหตุการณ์นี้จะถูกเรียกใช้เมื่อมีการสร้างการจองในเครื่องมือการจอง
type ReservationCreatedEvent = {
event: 'reservation-created';
payload: CreatedReservation;
};เมื่อ CreatedReservation คือ:
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 และ payment_method
-
payment_methodแสดงถึงวิธีการชำระเงินภายในของการจอง เช่นebankingหรือcards -
custom_payment_methodจะถูกกำหนดค่าเฉพาะเมื่อผู้เข้าพักเลือกตัวเลือกการชำระเงินแบบกำหนดเอง โดยจะเก็บidของตัวเลือกนั้นไว้ หากไม่ใช่จะเป็นundefined
อีเวนต์ที่เครื่องมือการจองสมัครรับ
- custom-payment-option-change
อีเวนต์นี้ใช้สำหรับที่พักที่ต้องการใช้ตัวเลือกการชำระเงินแบบกำหนดเองเพื่อเสนอให้กับลูกค้าของพวกเขา
type CustomPaymentOptionChangeEvent = {
event: 'custom-payment-option-change';
payload: {
id: string;
instructions?: string;
name: string;
};
};ขั้นตอนถัดไป
เมื่อคุณเข้าใจวิธีการกำหนดค่าและอ้างอิงระบบอีเวนต์แล้ว ให้ดำเนินการต่อไปที่ เพิ่มช่องทางการชำระเงินบุคคลที่สามและกิฟต์การ์ดในเครื่องมือการจอง เพื่อดูตัวอย่างการใช้งานจริงกับตัวเลือกการชำระเงินแบบกำหนดเอง
ข้อคิดเห็น
โปรด ลงชื่อเข้าใช้ เพื่อแสดงข้อคิดเห็น