xStore.sitemap
Nguồn dữ liệu dựng sitemap.xml: các phân khu và từng trang đường dẫn của mỗi phân khu.
Phương thức
| Phương thức | Cú pháp | Mô tả | Từ phiên bản |
|---|---|---|---|
sections |
xStore.sitemap.sections(): Promise<CursorPaginatedResponse<SitemapSection>> |
Các phân khu sitemap (products, categories, articles, pages) kèm số lượng. | 2.1 |
section |
xStore.sitemap.section(section, { limit, cursor }): Promise<CursorPaginatedResponse<SitemapEntry>> |
Một trang đường dẫn của phân khu. items[].path là ĐƯỜNG DẪN, không phải URL tuyệt đối — tự ghép tên miền. | 2.1 |
Ví dụ đầy đủ
<script>
// Bước 1: các phân khu và số lượng — dựng sitemap index từ đây.
async function buildSitemap() {
const pk = await xStore.sitemap.sections();
for (const s of pk.items) {
console.log(s.section, s.count);
// Bước 2: duyệt HẾT các trang con trỏ của một phân khu.
// Đừng nâng limit để lấy một lần — hãy đi theo next_cursor.
let cursor = null;
do {
const trang = await xStore.sitemap.section(s.section, { cursor, limit: 500 });
trang.items.forEach((e) => console.log(e.path, e.lastmod)); // path, KHÔNG phải URL tuyệt đối
cursor = trang.has_more ? trang.next_cursor : null;
} while (cursor);
}
}
</script>
Thư viện gọi tới /api/... trên chính tên miền cửa hàng, nên không cần khai báo địa chỉ máy chủ ở bất kỳ đâu.
Xem thêm Sự kiện để giao diện tự cập nhật sau mỗi thao tác.