Estrutura de Diretórios
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
Como os Dados Fluem Através do Seu Tema
Como os Dados Fluem Através do Seu Tema
- A Área de Membros carrega o arquivo JSON de template apropriado (index.json ou login.json)
- Ela lê as seções e sua ordem do template
- 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
- 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
- Acessar objetos globais como
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:- Embla Carousel: para a criação de carrosseis
- Microtip: para a exibição de tooltips
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