ما يمكنك البناء عليه اليوم.
زر واحد قابل للتضمين، موثَّق بالكامل.
سطران، والأول رابط.
انسخ مقتطفك جاهزًا من شاشة «زرّك» في لوحة التحكم.
<a href="{page}" data-bw-venue="{publicKey}" data-bw-launcher>Book a table</a>
<script src="{origin}/embed/v1/embed.js" async></script>ضع في الصفحة ما شئت من الأزرار؛ يُحمَّل النص البرمجي مرة واحدة ويخدمها جميعًا. حجمه أقل من 6 كيلوبايت مضغوطًا، ولا يخزّن أي ملفات تعريف ارتباط، ويُبقي الزر رابطًا عاديًا حتى يكتمل تحميله أو إذا تعطّل فيه أي شيء.
اثنتا عشرة تكتبها أنت، واثنتان يكتبهما النص البرمجي.
الزر نفسه
- data-bw-venue
- إلزامية، ويُتجاهَل أي زر بدونها. مفتاحك العام ليس سرًّا: فهو لا يقرأ إلا ما يستطيع الضيف رؤيته أصلًا، لذا لا يستطيع مفتاح منسوخ أكثر من وضع زر يعمل على موقع آخر.
- data-bw-launcher
- تُبقي عنصرك أنت زرًّا بتنسيق موقعك، وتتيح لحدث الحجز الوصول إلى صفحتك. وبدونها يضع النص البرمجي زرّه الخاص مكان عنصرك.
- data-bw-title
- اسم النافذة لقارئات الشاشة، ولا يظهر على الشاشة أبدًا. إن لم تحدده فهو «احجز طاولة» بلغة الزائر.
- data-bw-locale
- en أو fr أو ar؛ ويُختصر الوسم الإقليمي إلى لغته الأساسية. إن لم تحدده تتبع النافذة خاصية lang في صفحتك، ثم متصفح الزائر، ثم الإنجليزية.
- data-bw-theme
- light أو dark أو auto؛ وتُهمَل أي قيمة أخرى. تحدد الوضع الفاتح أو الداكن لإطار النافذة حول ألوانك.
- data-bw-phone
- رقم يُعرض إذا تعذّر تحميل نموذج الحجز. وبدونه تحتوي لوحة الاحتياط على رابط، لكن دون وسيلة للاتصال بك.
ما يُفتح عليه النموذج
- data-bw-party
- عدد صحيح أكبر من الصفر: عدد الأشخاص الذي يُفتح عليه النموذج.
- data-bw-date
- YYYY-MM-DD، ويُقرأ على أنه يوم عمل المطعم نفسه. ويُتجاهَل أي شكل آخر.
- data-bw-time
- الموعد الذي يُفتح عليه النموذج إن كان لا يزال شاغرًا، كطابع زمني بالميلي ثانية، لا كوقت على الساعة مثل 19:30.
- data-bw-require
- مفاتيح جلوس مفصولة بفواصل يجب أن تتوفر للضيف، كالدخول دون درج مثلًا. ويُحجب أي وقت لا يستوفيها.
- data-bw-prefer
- القائمة نفسها كتفضيل. لا تحجب أي وقت أبدًا، وتصلك مع الحجز.
- data-bw-layout
- classic أو compact: أي من تخطيطَي الحجز يُفتح. وأي اسم لا نعرفه يعود إلى إعدادك الخاص.
الخاصية الوحيدة التي قد تحجب كل الأوقات.
data-bw-require كأن المطعم محجوز بالكامل.يكتب النص البرمجي data-bw-bound وdata-bw-overlay بنفسه؛ فلا تضفهما يدويًا أبدًا.
اختر المواقع التي يمكنها فتح نموذج الحجز.
مفتوح لأي موقع آمن لمدة أربعة عشر يومًا، ثم للمواقع التي سمحت بها فقط.
- الأيام من 1 إلى 14
- أي موقع آمن، إضافة إلى localhost و127.0.0.1 على أي منفذ. ويُقترح عليك كل موقع يضمّنه في لوحة التحكم على شاشة «زرّك»، لتسمح به أو تزيله.
- بعد هذه المدة
- المواقع التي أدرجتها أو سمحت بها فقط. وإن لم يوجد أي منها، فلا يُفتح في أي مكان.
- مقفل
- أدرج مواقعك، كلٌّ منها بمخطط ومضيف ومنفذ اختياري مثل
http://localhost:3000، واضبط الوضع على «مقفل» لتتجاوز هذه المدة. - مرفوض
- يحجب المتصفح الإطار؛ وبعد عشر ثوانٍ تعرض النافذة رابطًا إلى صفحة الحجز، ورقمك إن كانت
data-bw-phoneمحددة.
حدث واحد يصل إلى صفحتك.
رقم حجز لأدوات التحليل لديك، ولا شيء يكشف من قام بالحجز.
document.addEventListener("bw:booking-confirmed", (e) => {
// e.detail.bookingRef is the reference the guest was shown.
});اسأل النص البرمجي عمّا يراه.
شغّل __bw.verify() في وحدة التحكم، على الصفحة التي ثبّته عليها.
- launchers
- عدد الأزرار التي ربطها. الصفر يعني أن الزر والنص البرمجي ليسا على الصفحة نفسها، أو أن المفتاح مفقود.
- hrefFallback
- ما إذا كان كل زر لا يزال يحمل رابطًا، تحسبًا لتعطّل النص البرمجي.
- originAllowed
- قيمتها true بعد فتح النافذة واستجابة إطارها، وnull في غير ذلك. ولا تكون false أبدًا؛ اقرأ
degradedبجانبframeLoadedلتميّز موقعًا مرفوضًا من نموذج لم يُفتح. - frameLoaded
- تدل على أن الإطار جلب صفحتنا، لا على أن نموذج الحجز اكتمل تحميله.
- degraded
- قيمتها true حين تتوقف النافذة عن انتظار إطارها وتعرض رابطك بدلًا منه.
- build
- إصدار النص البرمجي الذي أجاب.
- ?bw-verify=1
- على عنوان URL الخاص بك، يجعل الاستدعاء نفسه يطبع تقريره أيضًا.
- ?bw-open=1
- على عنوان URL الخاص بك، يفتح أول زر في الصفحة، ناقلًا إليه
bw-dateوbw-timeوbw-party. - __bw.open({ venue })
- يفتح النافذة لمفتاحك ويُرجع ما إذا استجاب للنقرة. وبدون مفتاح يُرجع false.
أخبرنا بما يجب على الواجهة البرمجية أن تفعله.
في باقة Pro عند إطلاقها، ستتيح للمساعدين الأذكياء حجز طاولة شاغرة مؤقتًا ريثما يقرر الضيف.
سيؤكد الضيف كل حجز بزر، ولن يحجز أي مساعد أو يلغي نيابةً عنه أبدًا. أما ما تستدعيه تطبيقاتنا داخليًا فليس عقدًا، ويتغير دون إشعار.


