Nhảy đến nội dung

Giới thiệu

Xây dựng điều hướng và lọc theo nhiều tiêu chí từ một cây bộ lọc nội dung được địa phương hóa duy nhất.

Thông tin thêm về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/category/filters

🎯 Mô-đun này làm gì?​

Mô-đun Filters cho phép bạn lấy một bộ lọc nội dung theo dấu hiệu của nó. Một bộ lọc nội dung là một cây các mục được biên soạn và địa phương hóa - nó có thể kết hợp các trang, sản phẩm, thuộc tính, giảm giá, thưởng, phương thức thanh toán và các mục tùy chỉnh trong một cấu trúc duy nhất.

Hãy nghĩ về nó như một menu có thể cấu hình của "những thứ để lọc theo" - bạn định nghĩa cây một lần trong bảng điều khiển quản trị OneEntry và kéo nó vào ứng dụng của bạn để hiển thị điều hướng, bộ lọc theo nhiều tiêu chí hoặc danh sách được biên soạn.

📖 Giải thích đơn giản​

Một bộ lọc nội dung là một cây mà mỗi nút chỉ đến một cái gì đó trong dự án của bạn:

  • 📄 trang - một liên kết đến một trang (có url)
  • 🛍️ sản phẩm - một mục sản phẩm
  • 🏷️ thuộc tính - một thuộc tính để lọc theo
  • 💸 giảm giá / giảm giá cá nhân - một mục giảm giá
  • 🎁 thưởng - một mục thưởng
  • 💳 phương thức thanh toán - một phương thức thanh toán
  • ✏️ tùy chỉnh - một mục tùy chỉnh mà bạn đã định nghĩa

Mỗi nút mang thông tin địa phương hóa và có thể chứa các children lồng nhau, vì vậy bạn có thể hiển thị các bộ lọc và menu nhiều cấp trực tiếp từ phản hồi.

✨ Các khái niệm chính​

Dấu hiệu​

Mỗi bộ lọc có một dấu hiệu duy nhất (ví dụ main). Bạn yêu cầu một bộ lọc theo dấu hiệu, và phản hồi được địa phương hóa theo mã ngôn ngữ yêu cầu.

Cây các mục​

Mảng items là một cây: các mục thông thường và tùy chỉnh sống trong cùng một mảng, và mỗi nút có thể có children. Duyệt qua cây để hiển thị giao diện người dùng của bạn.

📋 Những điều bạn cần biết​

  • Truyền một langCode để nhận bộ lọc được địa phương hóa cho một ngôn ngữ cụ thể (mặc định là en_US).
  • Các nút trang (type: "page") cung cấp một url; các loại nút khác sử dụng marker để tham chiếu đến thực thể của chúng.
  • Trường value mang một giá trị nút thống nhất (ví dụ giá trị giảm giá hoặc tiêu đề thuộc tính) khi có thể.

📊 Bảng tham khảo nhanh​

Phương thứcMô tả
getFilterByMarker()Lấy một bộ lọc nội dung theo dấu hiệu của nó

❓ Câu hỏi thường gặp (FAQ)​

Bộ lọc nội dung đến từ đâu?​

Các bộ lọc nội dung được cấu hình trong bảng điều khiển quản trị OneEntry. SDK lấy chúng ở chế độ chỉ đọc theo dấu hiệu.

Làm thế nào để tôi hiển thị một bộ lọc nhiều cấp?​

Duyệt đệ quy qua mảng items - mỗi nút có thể chứa một mảng children với cùng hình dạng nút.

🎓 Các thực hành tốt nhất​

  • Tham chiếu các bộ lọc theo dấu hiệu, không bao giờ theo tiêu đề hiển thị.
  • Yêu cầu bộ lọc bằng ngôn ngữ hiện tại của người dùng qua langCode.
  • Lưu bộ lọc vào bộ nhớ cache - chúng hiếm khi thay đổi.

Định nghĩa của mô-đun Filters​


const { Filters } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Tài liệu liên quan​