ระบบส่งเหตุการณ์ของเครื่องมือการจองพลัส

วัตถุประสงค์ กำหนดค่าและอ้างอิงระบบอีเวนต์ของเครื่องมือการจองเพื่อฟังอีเวนต์ที่รองรับและใช้ข้อมูลเพย์โหลดของอีเวนต์เหล่านั้นใน JavaScript ที่กำหนดเอง
เหมาะสำหรับ ผู้ดูแลระบบที่พักและผู้พัฒนาเว็บที่มีประสบการณ์
ใช้เมื่อ คุณต้องการ JavaScript ที่กำหนดเองเพื่อฟังอีเวนต์ของเครื่องมือการจอง ทำงานกับเพย์โหลดของอีเวนต์ หรือโต้ตอบกับการเปลี่ยนแปลงของอีเวนต์ที่รองรับ
ข้อกำหนด มีประสบการณ์กับ HTML, JavaScript และโค้ดที่กำหนดเองในเครื่องมือการจอง
ผลลัพธ์ที่คาดหวัง สคริปต์ที่กำหนดเองของคุณสามารถเริ่มต้นระบบอีเวนต์และฟังหรือส่งอีเวนต์ของเครื่องมือการจองที่รองรับโดยใช้เพย์โหลดที่มีเอกสารประกอบ
ข้อจำกัด Cloudbeds ไม่รองรับโค้ดที่กำหนดเองที่ผู้ใช้เพิ่มเอง การปรับแต่งอาจต้องมีการบำรุงรักษาเมื่อเครื่องมือการจองมีการพัฒนา

บทนำ

ระบบอีเวนต์ช่วยให้เครื่องมือการจองสื่อสารกับสคริปต์ที่กำหนดเองและโปรแกรมภายนอกโดยการส่งอีเวนต์ที่รองรับพร้อมข้อมูลเพย์โหลด ใช้ระบบนี้เพื่อรับการอัปเดตจากเครื่องมือการจองและกระตุ้นการทำงานที่กำหนดเองจาก JavaScript ที่เพิ่มในการตั้งค่าของเครื่องมือการจอง

บทความนี้อธิบายวิธีเริ่มต้น eventSystem อ้างอิงอีเวนต์ที่รองรับ และใช้ข้อมูลเพย์โหลดที่มีสำหรับอีเวนต์เหล่านั้น

 ข้อจำกัดของโค้ดที่กำหนดเองและหมายเหตุการบำรุงรักษา

  • ขั้นตอนที่ให้ไว้ที่นี่เป็นแหล่งข้อมูลเพิ่มเติมสำหรับผู้ใช้ที่มีความคุ้นเคยกับ HTML และ JavaScript อยู่แล้ว โดยมีวัตถุประสงค์สำหรับ ผู้พัฒนาเว็บที่มีประสบการณ์ เท่านั้น
  • เนื่องจากผลิตภัณฑ์ของ Cloudbeds และเครื่องมือการจองมีการพัฒนาอย่างต่อเนื่อง การปรับแต่ง โค้ดที่ทำเองอาจล้าสมัยหรือจำเป็นต้องมีการปรับปรุงเพิ่มเติม Cloudbeds ไม่สามารถให้การสนับสนุน ในการทำงานของโค้ดที่กำหนดเองได้
  • ทดสอบพฤติกรรมของโค้ดหลังจากนำไปใช้ทั้งบน เดสก์ท็อปและมือถือ และตรวจสอบโค้ดที่กำหนดเองอย่างสม่ำเสมอเพื่อให้ทันสมัย
  • Cloudbeds ไม่ให้ความช่วยเหลือด้านการออกแบบ/พัฒนาเว็บไซต์โรงแรม หรือการปรับแต่งที่ไม่ได้จัดทำโดย บริการปรับแต่ง มืออาชีพของเรา

สารบัญ

วิธีใช้ระบบ Event Emitter

  1. ไปที่หน้า การตั้งค่า Settings.pngในเมนู บัญชี Account menu.pngแล้วคลิกที่ส่วน เครื่องมือการจอง
  2. คลิกที่ ปรับแต่ง
  3. เพิ่มโค้ดด้านล่างลงในช่อง JavaScript
    เพื่อใช้ระบบอีเวนต์ คุณต้องเพิ่มตัวฟังอีเวนต์สำหรับอีเวนต์ on-booking-engine-ready ซึ่งจะเปิดเผย eventSystem ดังนี้:

    <script>
     window.addEventListener('on-booking-engine-ready', (e) => {
       const { eventSystem } = e.detail;
     });
    </script>
  4. คลิก บันทึก

    Booking Engine Customize tab showing the JavaScript field and Save button for adding Event System code

  5. 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> หมายถึงข้อมูลที่ส่งมาพร้อมกับอีเวนต์นั้น

อีเวนต์ที่เครื่องมือการจองส่งออก

  1.  currency-change อีเวนต์:

เหตุการณ์นี้จะถูกเรียกใช้เมื่อผู้ใช้งานเปลี่ยนสกุลเงินของเครื่องมือการจองจากตัวเลือกสกุลเงินในส่วนหัว ค่าของ currency ใน payload คือคำย่อของสกุลเงินที่เลือก ซึ่งเหมือนกับที่ปรากฏในพารามิเตอร์ currency ของ URL

export type CurrencyChangeEvent = {
 event: 'currency-change';
 payload: { currency: Currency };
};
  1. language-change event:

เหตุการณ์นี้จะถูกเรียกใช้เมื่อผู้ใช้งานเปลี่ยนภาษาในเครื่องมือการจองจากตัวเลือกภาษาในส่วนหัว ค่า language ใน payload คือคำย่อของภาษาที่เลือก ซึ่งเหมือนกับที่ปรากฏใน URL

type LanguageChangeEvent = {
 event: 'language-change';
 payload: { language: Language };
};
  1. 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;
 };
};

ขั้นตอนถัดไป

เมื่อคุณเข้าใจวิธีการกำหนดค่าและอ้างอิงระบบอีเวนต์แล้ว ให้ดำเนินการต่อไปที่ เพิ่มช่องทางการชำระเงินบุคคลที่สามและกิฟต์การ์ดในเครื่องมือการจอง เพื่อดูตัวอย่างการใช้งานจริงกับตัวเลือกการชำระเงินแบบกำหนดเอง

บทความนี้มีประโยชน์หรือไม่
0 จาก 0 เห็นว่ามีประโยชน์

ข้อคิดเห็น

0 ข้อคิดเห็น

โปรด ลงชื่อเข้าใช้ เพื่อแสดงข้อคิดเห็น