Pular para o conteúdo principal
O sistema de temas da Área de Membros Kiwify segue uma arquitetura modular inspirada no Shopify. Este documento fornece uma visão geral de como os componentes trabalham juntos para criar uma experiência de aprendizado personalizável.

Estrutura de Diretórios

nome-do-tema/
├── templates/
│   ├── index.json
│   └── login.json
├── sections/
│   └── [...].liquid
├── locales/
│   ├── en.default.json
│   ├── es.default.json
│   ├── pt.default.json
│   ├── en.schema.json
│   ├── es.schema.json
│   └── pt.schema.json
└── snippets/
    └──[...].liquid

Componentes Principais

Templates

Arquivos JSON que definem a estrutura e conteúdo da página

Sections

Componentes .liquid reutilizáveis para conteúdo da página

Locales

Arquivos de tradução para múltiplos idiomas

Snippets

Fragmentos de código reutilizáveis compartilhados entre seções

Como Estes Componentes Funcionam Juntos

1

Templates Definem a Estrutura

Templates são arquivos JSON que definem quais seções aparecem em uma página e sua ordem. Eles também armazenam dados de configuração para cada seção.
2

Sections Fornecem Conteúdo

Sections são arquivos Liquid que renderizam o conteúdo real na página. Eles podem ser personalizados através das configurações do editor de tema definidas em seu schema.
3

Snippets Adicionam Reutilização

Snippets são fragmentos de código reutilizáveis que podem ser incluídos em seções para manter consistência e reduzir duplicação.
4

Locales Permitem Tradução

Locales fornecem capacidades de tradução, permitindo que seu tema suporte múltiplos idiomas.

Fluxo de Dados

  1. A Área de Membros carrega o arquivo JSON de template apropriado (index.json ou login.json)
  2. Ela lê as seções e sua ordem do template
  3. Para cada seção, ela:
    • Carrega o arquivo Liquid da seção
    • Passa as configurações da seção do template para a seção
    • Renderiza a seção com seus dados
  4. Dentro das seções, você pode:
    • Acessar objetos globais como all_courses
    • Renderizar snippets para componentes de UI reutilizáveis
    • Usar traduções através do filtro t

Objetos Globais Disponíveis

Confira Visão Geral dos Objetos para uma lista completa e mais detalhes.

all_courses

Acesso a todos os cursos que o usuário tem permissão para visualizar

all_modules

Acesso a todos os módulos em todos os cursos

all_lessons

Acesso a todas as aulas em todos os módulos

last_watched_lessons

Array de IDs de aulas visualizadas recentemente

Estilização

Os temas Kiwify usam TailwindCSS para estilização, um framework CSS utility-first que permite estilizar elementos diretamente em sua marcação HTML/Liquid.

Bibliotecas Disponíveis

O ambiente de execução dos temas conta com as seguintes bibliotecas disponíveis para uso: Para mais informações, consulte a documentação das respectivas bibliotecas. O tema padrão da Kiwify contém exemplos de uso.

Limitações

  • JavaScript não é suportado atualmente em arquivos de tema
  • Apenas duas páginas podem ser personalizadas (index e login)
  • Máximo de 25 seções por template
  • Máximo de 50 blocos por seção

Saiba Mais

Para informações detalhadas sobre cada componente, visite as páginas de documentação dedicadas: