WP Manifestindependent plugin directory
manifest / events / cultos-de-primicias

Gestão Culto de Primícias

Sistema para gerenciar a escolha de dias pelos pastores no culto de primícias (01-12 de janeiro)

by Alessandro Melo · github.com/alessandromeloqa/cultos-de-primicias

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/alessandromeloqa/cultos-de-primicias/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/alessandromeloqa/cultos-de-primicias ↗

Plugin WordPress para gerenciar a escolha de dias pelos pastores no Culto de Primícias (01-12 de janeiro).

📋 Descrição

Sistema completo de inscrição e gerenciamento para o Culto de Primícias da Igreja Batista A Vida Só em Jesus. Permite que pastores escolham seus dias de ministração de forma organizada e automatizada.

✨ Funcionalidades

Painel Público

  • ✅ Formulário de inscrição com seleção visual de dias
  • ✅ Exibição em tempo real dos dias disponíveis e reservados
  • ✅ Mostra nome do pastor nos dias já reservados
  • ✅ Interface responsiva e intuitiva
  • ✅ Validação automática de dias duplicados

Painel Administrativo

  • ✅ CRUD completo (Criar, Ler, Atualizar, Deletar)
  • ✅ Calendário visual com status dos dias
  • ✅ Exportação para PDF com relatório completo
  • ✅ Resetar todos os registros (para novo ano)
  • ✅ Visualização de data/hora de cada registro

Recursos Técnicos

  • ✅ Sistema dinâmico - calcula automaticamente o ano do próximo culto
  • ✅ Banco de dados com constraint UNIQUE para evitar duplicatas
  • ✅ AJAX para carregamento assíncrono
  • ✅ Sanitização e validação de dados
  • ✅ Geração de PDF com FPDF

🚀 Instalação

  1. Faça upload da pasta culto-primicias para /wp-content/plugins/
  2. Ative o plugin no painel do WordPress
  3. Acesse o menu "Primícias" no admin

📖 Uso

Exibir Formulário Público

Adicione o shortcode em qualquer página ou post:

[formulario_primicias]

Painel Administrativo

Acesse Primícias no menu lateral do WordPress para:

  • Visualizar dias reservados
  • Adicionar/editar/excluir registros
  • Exportar relatório em PDF
  • Resetar sistema para novo ano

🗄️ Estrutura do Banco de Dados

Tabela: wp_culto_primicias

Campo Tipo Descrição
id mediumint(9) ID único (auto increment)
dia int(2) Dia do mês (1-12) - UNIQUE
nome_pastor varchar(255) Nome do pastor
data_registro datetime Data/hora do registro

🎨 Personalização

Cores do Tema

As cores principais estão definidas no CSS:

  • Azul primário: #0088CC
  • Azul escuro: #005A8C

Logo

Substitua o arquivo logo-ibac.png pela logo da sua igreja (recomendado: 200x200px, fundo transparente).

📅 Sistema de Ano Dinâmico

O plugin calcula automaticamente o ano do próximo culto:

  • Durante 2024: Mostra "Culto de Primícias 2025"
  • Durante 2025: Mostra "Culto de Primícias 2026"
  • E assim sucessivamente...

Não é necessário alterar código para usar em anos futuros.

🔧 Requisitos

  • WordPress 5.0 ou superior
  • PHP 7.0 ou superior
  • MySQL 5.6 ou superior

📦 Arquivos Incluídos

culto-primicias/
├── culto-primicias.php    # Arquivo principal do plugin
├── logo-ibac.png          # Logo da igreja
├── fpdf/                  # Biblioteca para geração de PDF
│   ├── fpdf.php
│   └── font/              # Fontes para PDF
└── README.md              # Este arquivo

🔒 Segurança

  • Sanitização de todos os inputs
  • Prepared statements para queries SQL
  • Verificação de permissões (manage_options)
  • Nonce para ações administrativas
  • Escape de outputs

🐛 Solução de Problemas

Dias não aparecem no formulário

  • Verifique se o jQuery está carregado
  • Confirme que o shortcode está correto
  • Verifique o console do navegador para erros JavaScript

PDF não gera

  • Confirme que a pasta fpdf/ está completa
  • Verifique permissões de escrita
  • Teste com poucos registros primeiro

Ano errado aparece

  • O sistema usa date('Y') + 1 automaticamente
  • Verifique a timezone do servidor PHP

📝 Changelog

Versão 1.2 (Atual)

  • Sistema de ano dinâmico implementado
  • Exibição de nomes dos pastores nos dias reservados
  • Status alterado de "Ocupado" para "Reservada"
  • CRUD completo no painel admin
  • Melhorias de interface e UX

👨‍💻 Autor

Alessandro Melo

📄 Licença

Este plugin é de uso livre para igrejas e organizações religiosas.

🤝 Contribuindo

Para reportar bugs ou sugerir melhorias, entre em contato com o desenvolvedor.

Igreja Batista A Vida Só em Jesus
Sistema desenvolvido com ❤️ para facilitar a organização do Culto de Primícias