همه‌ی یکپارچه‌سازی‌ها

سایت‌ها و فروشگاه‌ها · افزودن ویجت رزرو به سایت

هماهنگ برای اسکوئراسپیس

اسکوئراسپیس فروشگاه اپ ندارد؛ پس اپی برای نصب وجود ندارد. هماهنگ را با یک Code Block در یک صفحه یا با Code Injection برای کل سایت اضافه می‌کنید. مراحل زیر از کد واقعی ویجت استفاده می‌کنند.

چه چیزی به دست می‌آورید

  • بدون فروشگاه اپ و افزونه

    ویجت فقط HTML و جاوااسکریپت ساده است؛ پس روی هر قالب اسکوئراسپیس کار می‌کند.

  • بازدیدکننده در صفحه‌ی شما می‌ماند

    فرم رزرو داخل چیدمان شما باز می‌شود، نه در آدرس دیگری.

  • قاب همراه فرم بزرگ می‌شود

    صفحه‌ی رزرو ارتفاعش را اعلام می‌کند و اسکریپت قاب را هم‌اندازه‌ی آن می‌کند.

  • فقط دامنه‌ی شما می‌تواند آن را بارگذاری کند

    هماهنگ روی دامنه‌ای که در فهرست مجاز شما نیست داخل قاب بارگذاری نمی‌شود.

نحوه‌ی اتصال Squarespace

  1. کلید Embed را کپی کنید

    در هماهنگ به سازمان › Embed بروید و کلید Embed را کپی کنید. همان صفحه دامنه‌هایی را که اجازه‌ی نمایش ویجت دارند فهرست می‌کند.

  2. اسلاگ نوع رویداد را کپی کنید

    به بخش لینک‌ها بروید، نوع رویداد را انتخاب کنید و بخش آخر آدرس رزرو آن را بردارید. آن بخش همان اسلاگ است.

  3. Embed را برای نوع رویداد فعال کنید

    نوع رویداد را باز کنید، به بخش امکانات اضافه‌ی رزرو بروید و «اجازه‌ی جاسازی در سایت‌های خارجی» را روشن کنید. نوع رویدادی که این تنظیم را ندارد، ویجت خالی نشان می‌دهد.

  4. دامنه‌ی اسکوئراسپیس را اضافه کنید

    در هماهنگ به سازمان › Embed بروید و با «افزودن وب‌سایت» دامنه‌ی دقیق را وارد کنید، مثلاً https://www.example.com. تا دامنه در فهرست نباشد، ویجت خالی می‌ماند.

  5. ویرایشگر صفحه را باز کنید

    در اسکوئراسپیس به Pages بروید، صفحه را انتخاب کنید و Edit را بزنید. روی علامت به‌علاوه در جای ویجت بزنید و Code را انتخاب کنید. اسکوئراسپیس به این Code Block می‌گوید و به پلن Business یا بالاتر نیاز دارد.

  6. کد را بگذارید

    نوع بلوک را روی HTML بگذارید و Display Source را خاموش کنید. کد زیر را بگذارید و YOUR_EMBED_KEY و YOUR_EVENT_TYPE_SLUG را با مقادیر خودتان جایگزین کنید.

  7. ذخیره و منتشر کنید

    Save را بزنید و صفحه را منتشر کنید. Code Block در ویرایشگر اجرا نمی‌شود؛ برای دیدن ویجت صفحه‌ی منتشرشده را باز کنید.

  8. برای همه‌ی صفحه‌ها با هم، از Code Injection استفاده کنید

    به Website › Website Tools › Code Injection بروید و فقط بخش اسکریپت را در فیلد Footer بگذارید. سپس div را در هر صفحه‌ای که ویجت می‌خواهد قرار دهید. اسکریپت در صفحه‌ی بدون div کاری نمی‌کند.

Code Block یا Code Injection اسکوئراسپیس

<div id="retime-booking" style="max-width:900px;margin:0 auto"></div>
<script>
  (function () {
    var mount = document.getElementById('retime-booking');
    if (!mount) return;

    var origin = 'https://www.hamahang.app';
    var key = 'YOUR_EMBED_KEY';
    var slug = 'YOUR_EVENT_TYPE_SLUG';

    var frame = document.createElement('iframe');
    frame.src =
      origin + '/embed/' + encodeURIComponent(key) + '/' + encodeURIComponent(slug);
    frame.title = 'Book a time';
    frame.loading = 'lazy';
    frame.allow = 'clipboard-write';
    frame.style.width = '100%';
    frame.style.border = '0';
    frame.style.display = 'block';
    frame.style.minHeight = '600px';

    window.addEventListener('message', function (event) {
      if (event.origin !== origin) return;
      if (event.source !== frame.contentWindow) return;

      var data = event.data;
      if (data && data.type === 'retime:resize' && typeof data.height === 'number') {
        frame.style.height = Math.max(200, Math.min(data.height, 4000)) + 'px';
      }
    });

    mount.appendChild(frame);
  })();
</script>

پیش‌نمایش ویرایشگر اسکریپت را اجرا نمی‌کند. صفحه را ذخیره کنید و برای آزمایش، آدرس منتشرشده را باز کنید.

سؤال‌های رایج درباره‌ی Squarespace

آیا اپ هماهنگ در فروشگاه اپ اسکوئراسپیس هست؟

نه. اسکوئراسپیس برای این نوع ابزار فروشگاه اپ ندارد. Code Block بالا روش پشتیبانی‌شده برای افزودن هماهنگ است.

به کدام پلن اسکوئراسپیس نیاز دارم؟

Code Blockی که اسکریپت اجرا کند به پلن Business یا بالاتر نیاز دارد. Code Injection در Website › Website Tools هم همین پلن را لازم دارد.

محل ویجت خالی است. مشکل چیست؟

چهار چیز را بررسی کنید: نوع رویداد باید اجازه‌ی جاسازی در سایت‌های خارجی داشته باشد، دامنه باید در فهرست مجاز باشد، کلید Embed باید با سازمان شما یکی باشد و Code Block باید HTML با Display Source خاموش باشد.

می‌توانم در هر صفحه خدمت متفاوتی نشان دهم؟

بله. همان کد را در هر صفحه بگذارید و YOUR_EVENT_TYPE_SLUG را به نوع رویداد آن صفحه تغییر دهید.

ویجت در موبایل کار می‌کند؟

بله. قاب عرضی را که به آن داده شود پر می‌کند و فرم رزرو برای صفحه‌های کوچک چیده می‌شود.

همین حالا از Squarespace استفاده کنید

یک حساب رایگان بسازید، تقویمتان را وصل کنید و همین امروز اولین لینک رزروتان را به اشتراک بگذارید.

شروع رایگان