Install
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/paulommaeda/atividades/archive/refs/heads/main.zipPlugin WordPress 1.1.3. WordPress 6.4+, PHP 8.0+.
Instalação e atualização
Instale o ZIP com a pasta journey-atividades pelo painel do WordPress e substitua a versão anterior, sem desinstalar. A versão 1.1.0 não tem atualizador: essa primeira troca é manual.
Após instalar a 1.1.1, o WordPress consulta este repositório público (branch main) e oferece versões superiores em Plugins e Painel → Atualizações. Na linha do plugin, Verificar atualizações força uma consulta. Permissão update_plugins e nonce são exigidos. A consulta tem cache de uma hora; falhas têm espera de cinco minutos. Autoatualização só ocorre se habilitada pelo administrador no WordPress.
Para publicar uma próxima versão, aumente Version e JAO_VERSION em journey-atividades.php, valide as alterações e envie para main. Commits sem aumento de versão não geram atualização. O arquivo principal deve continuar na raiz do repositório. O download fica fixado no commit que forneceu a versão; a pasta instalada é preservada. Não é necessário criar Release nem configurar token enquanto o repositório for público. Se ficar privado, este atualizador deixará de funcionar.
O servidor precisa acessar api.github.com, raw.githubusercontent.com e os destinos HTTPS de download do GitHub (incluindo codeload.github.com). Erros de rede ou limite de API não oferecem um pacote inválido. O link manual informa falha ao consultar.
Consulte LEIA-ME.md para instalação, integrações, shortcodes e homologação.
Mapa do código
| Arquivo/módulo | Responsabilidade |
|---|---|
journey-atividades.php |
Inicialização, conflitos com plugins antigos, instalação e cron |
includes/core.php |
Tabelas, configurações, travas e despacho AJAX |
includes/totvs.php |
Consulta DADOSREMAT.2 e sincronização transacional do espelho local |
includes/auth.php |
CPF, WhatsApp opcional, sessão, limites e vínculo com alunos |
includes/checkout.php |
Catálogo por turma, reservas, cobrança K8 e consulta de pagamentos |
includes/dashboard.php |
Sessão própria, filtros, indicadores e exportação CSV |
includes/admin.php |
Cadastro de atividades, integrações e conferência de cobranças |
includes/front.php, assets/ |
Shortcodes e interface pública |
includes/updater.php |
Atualização nativa do WordPress a partir do GitHub |
financeiro/ |
Cliente K8, tabelas financeiras, sincronização Cobranças/Pay e painéis |
Fluxo: TOTVS → tabelas locais de alunos/responsáveis → CPF → WhatsApp (se ligado) → aluno → atividades autorizadas por turma → reserva local e pedido → cobrança K8 → checkout hospedado → consulta de situação e dashboard.
Os valores são armazenados em centavos. O pedido preserva os dados e valores da compra. Reservas impedem a compra duplicada de uma atividade pelo mesmo aluno. Uma resposta inconclusiva do K8 mantém o pedido em conferência, sem repetição automática de cobrança. Remoções no espelho não apagam o histórico financeiro.
Escopo de 1.1.3
Adiciona Exigir validação pelo WhatsApp em Atividades Journey → Integrações → Acesso dos responsáveis:
- Ligado (padrão): CPF → confirmação do telefone → código WhatsApp → alunos.
- Desligado: CPF → alunos, sem envio de mensagem nem exigência de telefone.
Os campos ID e token NX retornam à tela; valores anteriores são preservados. Ao mudar o modo, as sessões de inscrição anteriores são invalidadas. O modo é aplicado no servidor, inclusive no catálogo e checkout. Sem preferência salva, a atualização da 1.1.2 restaura o padrão ligado; escolha a preferência e salve. Com o modo desligado, basta conhecer o CPF cadastrado para abrir os alunos vinculados.
Mantêm-se as regras de preço/reserva, o financeiro e a senha do dashboard. Não há alteração de schema ou exclusão de dados. A versão 1.1.1 introduziu o atualizador do WordPress mantido nesta versão. Consulte VALIDACAO.md para as verificações executadas e seus limites.