اعرض تقييم صلاحية سكن حياً لأي عنوان على صفحاتك الخاصة — مجاناً، متجاوباً مع جميع الشاشات، ودون أي خطوة بناء. مثالي لقوائم العقارات، وأدلة الأحياء، وأدوات الانتقال، وصفحات المدن. يصل الزوار الذين يضغطون على التقييم إلى تقرير BuildingsScore الكامل.
أضف عنصراً نائباً في المكان الذي تريد ظهور التقييم فيه، ثم حمّل السكريبت مرة واحدة لكل صفحة. حدد إحداثيات المكان الذي تريد تقييمه:
<div data-buildingsscore data-lat="48.8584" data-lng="2.2945"></div> <script async src="https://buildingsscore.com/embed.js"></script>
هذا كل شيء. يستبدل السكريبت العنصر النائب ببطاقة تقييم ويضبط حجمها تلقائياً.
هذه هي الأداة التي ينتجها الكود أعلاه بالضبط:
شكلان عبر data-layout — vertical
(الشكل الافتراضي المعروض أعلاه، مثالي للأشرطة الجانبية والبطاقات) و
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-layout | vertical (افتراضي، بطاقة طويلة) أو horizontal (بانر عريض — التقييم بجانب شبكة أبعاد مدمجة من عمودين). |
data-theme | auto (افتراضي، يتبع إعدادات نظام تشغيل الزائر)، أو light، أو dark. |
data-ref | وسم موقعك أو حملتك للإسناد. يعتمد افتراضياً على نطاقك. |
data-height | الارتفاع الأولي بالبكسل قبل أن تقيس البطاقة نفسها (الافتراضي 440). |
data-cta | اضبطه على 0 لإخفاء زر "عرض التقرير الكامل". |
هل تعرض القوائم بصورة ديناميكية (تمرير لا نهائي، تطبيق SPA، نتائج AJAX)؟ بعد إدراج العناصر النائبة الجديدة، استدعِ:
BuildingsScore.render();
تخطَّ السكريبت وضمّن الأداة مباشرةً:
<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 التفاعلي الكامل لذلك المكان في تبويب جديد — وبذلك تحتفظ صفحتك بالزائر بينما يطّلع على العرض التفصيلي. نحن لا نضع أبداً ملفات تعريف ارتباط تابعة لجهات خارجية في الأداة، ويُحسب التقييم على خوادمنا، لذا تبقى صفحتك سريعة.