Hướng dẫn nhúng widget
Đưa bảng tỷ số trực tiếp và các khối chi tiết trận đấu lên website của bạn bằng một đoạn mã. Không cần React hay framework nào; dữ liệu tự cập nhật trong khi trận diễn ra.
Bắt đầu nhanh
- Gửi cho chúng tôi tên miền website sẽ nhúng widget (ví dụ https://www.example.com) để được mở quyền truy cập dữ liệu.
- Thêm thẻ script vào trang, một lần cho mỗi trang, ở bất kỳ vị trí nào.
- Đặt thẻ div có thuộc tính data-sportx-widget ở nơi muốn hiển thị. Có thể đặt nhiều widget trên cùng một trang.
<script type="module" src="https://bbidt.name/widgets/v1/embed.js"></script>
<div data-sportx-widget="livescore" data-match-url="/tran-dau/{id}"></div>Script và giao diện được tải từ máy chủ của chúng tôi và tự cập nhật khi có phiên bản mới; trình duyệt có thể giữ bản cũ tối đa 4 giờ.
Kết nối bảng tỷ số với trang trận đấu
Cách thường dùng là bảng tỷ số ở trang chủ và các khối chi tiết ở trang trận đấu của bạn:
- Trên bảng tỷ số, đặt data-match-url theo cấu trúc trang trận đấu của bạn, ví dụ /tran-dau/{id}.
- Khi người xem bấm một trận, trình duyệt mở /tran-dau/fm_… trên website của bạn.
- Trang trận đấu lấy mã trận từ đường dẫn và đặt vào data-match-id của các khối.
<!-- /tran-dau/fm_xxxxxxxxxxxx -->
<div data-sportx-widget="match" data-block="scoreboard"></div>
<div data-sportx-widget="match" data-block="timeline"></div>
<div data-sportx-widget="match" data-block="lineups"></div>
<script>
const id = location.pathname.split("/").pop();
for (const el of document.querySelectorAll('[data-sportx-widget="match"]')) {
el.dataset.matchId = id;
}
</script>
<script type="module" src="https://bbidt.name/widgets/v1/embed.js"></script>Tài liệu
- Bảng tỷ số trực tiếp →
Danh sách trận trong ngày, dẫn tới trang trận đấu của bạn.
- Khối chi tiết trận →
Từng khối của trang trận đấu: tỷ số, tóm tắt, diễn biến, thống kê, bản đồ cú sút, đội hình, chỉ số cầu thủ, bảng xếp hạng, đối đầu, phong độ, so sánh đội, tỷ lệ cược.
- Trang quốc gia →
Giải đấu và trận trong ngày của một quốc gia hoặc châu lục, giống trang quốc gia trên website.
- Tuỳ biến giao diện →
Màu sắc, phông chữ, bo góc và ghi đè CSS.
- Tích hợp nâng cao →
Ứng dụng một trang, JavaScript API và Content-Security-Policy.
- Khắc phục sự cố →
Các lỗi thường gặp và cách xử lý.