Pular para o conteúdo principal

Introdução

Construa navegação e filtragem facetada a partir de uma única árvore de filtros de conteúdo localizada.

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/category/filters

🎯 O que este módulo faz?​

O módulo Filters permite que você recupere um filtro de conteúdo pelo seu marcador. Um filtro de conteúdo é uma árvore de itens curada e localizada - pode misturar páginas, produtos, atributos, descontos, bônus, métodos de pagamento e entradas personalizadas em uma única estrutura.

Pense nisso como um menu configurável de "coisas para filtrar" - você define a árvore uma vez no painel de administração do OneEntry e a puxa para seu aplicativo para renderizar navegação, filtros facetados ou listas curadas.

📖 Explicação Simples​

Um filtro de conteúdo é uma árvore onde cada nó aponta para algo em seu projeto:

  • 📄 página - um link para uma página (tem um url)
  • 🛍️ produto - uma entrada de produto
  • 🏷️ atributo - um atributo para filtrar
  • 💸 desconto / desconto-pessoal - uma entrada de desconto
  • 🎁 bônus - uma entrada de bônus
  • 💳 método-de-pagamento - um método de pagamento
  • ✏️ personalizado - uma entrada personalizada que você definiu

Cada nó carrega informações localizadas e pode conter children aninhados, permitindo que você renderize filtros e menus de múltiplos níveis diretamente da resposta.

✨ Conceitos Chave​

Marcador​

Cada filtro tem um marcador único (por exemplo, main). Você solicita um filtro pelo marcador, e a resposta é localizada para o código de idioma solicitado.

Árvore de Itens​

O array items é uma árvore: itens regulares e personalizados vivem no mesmo array, e cada nó pode ter children. Percorra a árvore para renderizar sua interface.

📋 O que você precisa saber​

  • Passe um langCode para obter o filtro localizado em um idioma específico (o padrão é en_US).
  • Nós de página (type: "page") expõem um url; outros tipos de nó usam marker para referenciar sua entidade.
  • O campo value carrega um valor de nó unificado (por exemplo, um valor de desconto ou um título de atributo) quando aplicável.

📊 Tabela de Referência Rápida​

MétodoDescrição
getFilterByMarker()Obter um filtro de conteúdo pelo seu marcador

❓ Perguntas Comuns (FAQ)​

De onde vêm os filtros de conteúdo?​

Os filtros de conteúdo são configurados no painel de administração do OneEntry. O SDK os recupera em modo somente leitura pelo marcador.

Como renderizo um filtro de múltiplos níveis?​

Percorra recursivamente o array items - cada nó pode conter um array children com a mesma forma de nó.

🎓 Melhores Práticas​

  • Referencie filtros pelo marcador, nunca por um título de exibição.
  • Solicite o filtro no idioma atual do usuário via langCode.
  • Armazene em cache os filtros - eles mudam raramente.

Definição do módulo Filters​


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

🔗 Documentação Relacionada​