جاسازی BuildingsScore در سایت شما

امتیاز قابلیت سکونت هر آدرس را به‌صورت زنده در صفحات خودتان نمایش دهید — رایگان، واکنش‌گرا و بدون هیچ مرحله ساخت. ایده‌آل برای فهرست‌های ملکی، راهنمای محله‌ها، ابزارهای جابه‌جایی و صفحات شهری. بازدیدکنندگانی که روی امتیاز ضربه می‌زنند به گزارش کامل BuildingsScore هدایت می‌شوند.

دو خط HTML

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

<div data-buildingsscore data-lat="48.8584" data-lng="2.2945"></div>
<script async src="https://buildingsscore.com/embed.js"></script>

همین. اسکریپت مکان‌نگهدار را با یک کارت امتیاز جایگزین می‌کند و اندازه آن را به‌طور خودکار تنظیم می‌کند.

پیش‌نمایش زنده

این دقیقاً همان ویجتی است که قطعه کد بالا تولید می‌کند:

چیدمان‌ها

دو شکل از طریق data-layoutvertical (پیش‌فرض نمایش داده شده در بالا، ایده‌آل برای نوارهای کناری و کارت‌ها) و horizontal، یک بنر عریض که در بالای یک فهرست یا یک ردیف تمام‌عرض قرار می‌گیرد:

<div data-buildingsscore data-layout="horizontal"
     data-lat="48.8584" data-lng="2.2945"></div>

گزینه‌ها

ویجت را با ویژگی‌های data-* روی مکان‌نگهدار پیکربندی کنید:

ویژگیتوضیحات
data-lat / data-lngمختصات نقطه‌ای که باید امتیازدهی شود. گزینه مطمئن بدون جستجو — وقتی آن‌ها را دارید از این‌ها استفاده کنید.
data-addressآدرس خیابانی برای امتیازدهی (اگر lat/lng ارائه نشود، موقعیت‌یابی می‌شود) و/یا برچسبی که روی کارت نمایش داده می‌شود.
data-layoutvertical (پیش‌فرض، یک کارت بلند) یا horizontal (یک بنر عریض — امتیاز در کنار یک شبکه فشرده دو ستونه).
data-themeauto (پیش‌فرض، از سیستم‌عامل بازدیدکننده پیروی می‌کند)، light یا dark.
data-refبرچسب سایت/کمپین شما برای انتساب. به‌طور پیش‌فرض دامنه شما است.
data-heightارتفاع اولیه به پیکسل قبل از اینکه کارت خود را اندازه‌گیری کند (پیش‌فرض 440).
data-ctaروی 0 تنظیم کنید تا دکمه "مشاهده گزارش کامل" پنهان شود.

افزودن ویجت‌ها پس از بارگذاری صفحه

فهرست‌ها را به‌صورت پویا رندر می‌کنید (اسکرول بی‌نهایت، SPA، نتایج AJAX)؟ پس از درج مکان‌نگهدارهای جدید، فراخوانی کنید:

BuildingsScore.render();

iframe ساده ترجیح می‌دهید؟

اسکریپت را حذف کنید و ویجت را مستقیماً جاسازی کنید:

<iframe
  src="https://buildingsscore.com/embed.html?lat=48.8584&lng=2.2945"
  style="width:100%;height:440px;border:0"
  loading="lazy" title="BuildingsScore"></iframe>

با اسکریپت، کارت اندازه خود را به‌طور خودکار با محتوا تنظیم می‌کند؛ با یک iframe ساده، ارتفاع ثابت را خودتان تعیین می‌کنید.

نحوه عملکرد کلیک‌ها

امتیاز، دکمه و هر دسته‌بندی، گزارش کامل و تعاملی BuildingsScore را برای آن نقطه در یک تب جدید باز می‌کنند — بنابراین صفحه شما بازدیدکننده را نگه می‌دارد در حالی که نمای عمیق‌تری دریافت می‌کند. ما هرگز کوکی‌های شخص ثالث در ویجت تنظیم نمی‌کنیم و امتیاز روی سرورهای ما محاسبه می‌شود، بنابراین صفحه شما سریع می‌ماند.