Widgets personalizados

Se nenhum dos widgets pré-construídos cobre o que você está tentando ver, construa o seu próprio. Widgets personalizados são o mesmo cartão de arrastar e soltar que tudo o mais no painel, mas a consulta que os alimenta é sua para desenhar.

Abra Painel → Editar → Adicionar widget → Personalizado, ou vá em Configurações → Widgets personalizados para o construtor completo.

Quando construir um widget personalizado

O catálogo cobre as visões comuns para toda a igreja. Recorra a um widget personalizado quando quiser algo mais específico:

• "Membros que entraram este ano e não completaram a escola Fundamentos"
• "Células sem presença nas últimas 4 semanas"
• "Doações ao fundo de construção por sede neste trimestre"
• "Aniversariantes desta semana, agrupados por ministério"

Se você se pega rodando o mesmo filtro no módulo membros toda segunda-feira, isso é um widget personalizado.

O construtor, passo a passo

1. Nome e descrição — o que aparece no cabeçalho do widget.
2. Fonte de dados — escolha entre membros, presenças, doações, grupos, escolas, ministérios ou eventos. Cada fonte já faz join com as tabelas relacionadas para você.
3. Agregação — contagem de linhas, soma de uma coluna, média, mín, máx. Para doações, geralmente é SUM(amount).
4. Agrupar por — nenhum (um número grande), por mês/semana, por unidade organizacional, por ministério, por tipo de membro.
5. Tipo de gráfico — número KPI, barra, linha, área, pizza. O construtor escolhe um padrão mas você pode sobrescrever.
6. Filtros — qualquer coluna na tabela fonte. Adicione quantas condições AND quiser.

O painel de prévia atualiza ao vivo. Salve quando estiver bom.

O que é suportado

Fonte	Agregações comuns	Notas
Membros	count, count distinct member_type	Filtro de ativo vs excluído é automático; membros perdidos incluídos a menos que excluídos
Presenças	count, count distinct member_id	Faz join com meetings para agrupar por tipo de reunião
Doações	sum(amount), avg(amount), count	Só conta linhas amount_redacted = false para sum/avg
Escolas	count enrolments, taxa de conclusão	Em join com school_enrolments
Grupos	count members	Apenas grupos ativos
Ministérios	count members	Apenas ministérios ativos
Eventos	count occurrences, sum of attendance	Inclui expansões recorrentes

Somas de doações ocultam linhas privadas

A fonte doações aplica o mesmo filtro amount_redacted que os gráficos de doações. Um widget que diz "doações deste trimestre" omite qualquer doação que um admin marcou como privada. O widget de contagem (número de doações) não aplica esse filtro — apenas os widgets em dinheiro. Veja Registrando uma doação.

O que não é suportado (ainda)

• Joins entre fontes além das pré-construídas. Você não pode, por exemplo, construir "membros que doaram E foram à reunião na mesma semana" sem um workflow ao nível de receita.
• SQL personalizado. Se você não consegue expressar a consulta na UI do construtor, fale com o suporte — eles podem adicionar uma fonte ou um pré-join.
• Alertas em tempo real. Widgets personalizados atualizam ao carregar o painel, não em um cronograma de push. Para tempo real, use workflows com um gatilho.

Compartilhar um widget personalizado

Cada widget personalizado é com escopo de organização, não de usuário — no momento em que você salva, todo usuário na sua organização pode adicionar o widget ao seu painel a partir da aba Personalizado no seletor Adicionar widget. Edições na consulta do widget se propagam para todos que o usam.

Próximos passos

1. Gráficos — o catálogo de gráficos integrado.
2. Personalizando seu painel — solte seu widget personalizado no layout.
3. Relatórios — para extrações pontuais que não são um item permanente do painel.