คู่มือ aWhere
พัฒนาWidgets

การ์ดบัญชี

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

widget account แสดงการ์ดของผู้ใช้ที่ token หรือ API key เป็นของ คือรูป ชื่อ และอีเมล พร้อมปุ่ม จัดการบัญชีของคุณ ช่วยเหลือ และ ออกจากระบบ เมื่อผู้ใช้กดปุ่มแรกและปุ่มสุดท้าย widget ส่งข้อความถึงหน้าของคุณ ส่วนปุ่ม ช่วยเหลือ ทำงานเอง

URL และพารามิเตอร์

พารามิเตอร์ที่ขึ้นต้นด้วย _ ที่ไม่ใช่สองตัวล่างนี้เหมือนกันทุก widget ดู Widgets

พารามิเตอร์ความหมายจำเป็น
_appid ของแอปที่แสดงการ์ด เช่น drive ปุ่ม ช่วยเหลือ เปิดคู่มือของแอปนั้นไม่
_releaseเวอร์ชันที่แอปนั้นรัน เช่น 5.0.3 ปุ่ม ช่วยเหลือ เปิดคู่มือของเวอร์ชันนี้ไม่

ถ้าไม่ส่ง _app และ _release ปุ่ม ช่วยเหลือ เปิดหน้าแรกของคู่มือเวอร์ชันของแพลตฟอร์ม

ข้อความ

widget นี้ไม่ส่ง ready และไม่รับ post-widget-parameters ข้อความทั่วไปที่เหลือดู Widgets

actionทิศทางpayload
view-accountwidget ถึงหน้าของคุณรายการของแอป Account จากรายการแอปของแพลตฟอร์ม ใช้ url ของมันพาผู้ใช้ไปที่ Account
sign-outwidget ถึงหน้าของคุณไม่มี

widget ไม่ออกจากระบบและไม่เปลี่ยนหน้าเอง เมื่อได้ sign-out หน้าของคุณต้องล้าง token และพาผู้ใช้ออกไปเอง

ปุ่ม ช่วยเหลือ เป็นลิงก์ที่เปิดแท็บใหม่ และไม่ส่งข้อความ

ตัวอย่าง

const messageToken = crypto.randomUUID()
const params = new URLSearchParams({
  _credential_type: 'bearer-token',
  _token: token,
  _origin: location.origin,
  _message_token: messageToken,
  _locale: 'th',
  _app: 'my-app',
  _release: '5.0.3',
})
frame.src = `${site}/widgets/account?${params}`

addEventListener('message', (e) => {
  if (e.origin !== site || e.data.messageToken !== messageToken) return
  if (e.data.action === 'view-account') window.open(e.data.payload.url, '_blank')
  if (e.data.action === 'sign-out') signOut() // ล้าง token ของคุณเอง
})

ในหน้านี้