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.