แพ็กเกจอย่างเป็นทางการ · เฟรมเวิร์ก

การแสดงผู้แก้ไขและรายการแบบสดสำหรับ Craft CMS

ปลั๊กอิน Craft CMS 5: ผู้แก้ไขเห็นว่ามีใครเปิดรายการเดียวกันอยู่ และได้รับข้อความให้โหลดใหม่เมื่อมีคนบันทึก หน้าเว็บอัปเดตเองเมื่อรายการเปลี่ยน และหน้าคำสั่งซื้อของ Craft Commerce ติดตามสถานะแบบสด

hibira-io/craft-hibiraPackagist ↗GitHub ↗

• หน้ารายการในแผงควบคุมแสดงทุกคนที่เปิดรายการเดียวกัน และเตือนคนอื่นทันทีที่มีคนหนึ่งบันทึก
• การบันทึกรายการที่เผยแพร่แล้วจะส่ง entry-updated ไปที่ craft-entry-{id} และ entry-saved ไปที่ craft-section-{handle} เทมเพลตจึงรีเฟรชได้โดยไม่ต้อง polling
• Craft Commerce: ลูกค้าติดตามสถานะคำสั่งซื้อได้แบบสด และแผงควบคุมแสดงคำสั่งซื้อใหม่ทันทีที่เข้ามา
• craft.hibira.trigger() ส่งอีเวนต์ของคุณเองจากเทมเพลต และ actions/hibira/auth ลงนามช่อง private และ presence

ลงชื่อเข้าใช้เพื่อดูโค้ดตัวอย่างเหล่านี้พร้อมโฮสต์คลัสเตอร์ของคุณเอง ลงชื่อเข้าใช้

1. ติดตั้ง

   composer require hibira-io/craft-hibira
   php craft plugin/install hibira

2. ตั้งค่า

   # .env (Settings → Plugins → Hibira Realtime reads these by default)
   HIBIRA_APP_ID=YOUR_APP_ID
   HIBIRA_APP_KEY=YOUR_APP_KEY
   HIBIRA_APP_SECRET=YOUR_APP_SECRET
   # and set Host to ws.hibira.io in the plugin settings

3. ใช้งาน

   {% do craft.hibira.registerScript() %}
   
   {# Readers get a "This page was updated" notice with a Reload button #}
   <article data-hibira-entry="{{ entry.id }}">
     {{ entry.body }}
   </article>
   
   {# Send your own events #}
   {% do craft.hibira.trigger('scores', 'goal', { team: 'home' }) %}

ก่อนเริ่ม

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

ใช้ app key จากแดชบอร์ดของคุณ ส่วน secret ให้เก็บไว้บนเซิร์ฟเวอร์เท่านั้น ช่อง อีเวนต์ และ endpoint การยืนยันสิทธิ์ทำงานเหมือนกับที่ใช้กับ Pusher ทุกประการ สร้างบัญชีฟรีของคุณ →