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/raabesmps/mes-certo/archive/refs/heads/v1.0.0.zipPlugin WordPress para agências de viagem: o cliente digita um destino e recebe o melhor mês para ir, o que fazer, um mapa e um roteiro pronto por dia. Funciona em qualquer página com um shortcode.
[mes_certo destino="Paraty, RJ"]
Status: em desenvolvimento, Checkpoint 0 (fundação). Ainda não busca dados reais; o shortcode monta um app React de teste.
O que vai ter
- Busca de destino com autocomplete e escolha do tipo de viagem (praia, trilha, cultura, frio) e dos dias.
- Gráfico de 12 meses com nota, chuva e temperatura.
- Cards de atrações com foto e crédito, mapa com rotas por dia e roteiro Manhã/Tarde.
- Painel no WordPress para ocultar e reordenar blocos, trocar as 4 cores principais (padrão: cores do tema) e configurar as APIs.
- Marca configurável em
config/brand.php(nome, logo, selo opcional) para licenciamento. - Sem menu nem rodapé por padrão.
Instalação (desenvolvimento)
Requer WordPress 6.2+, PHP 8.0+ e Node 20+.
git clone <este-repositorio> wp-content/plugins/mes-certo
cd wp-content/plugins/mes-certo
npm install
npm run build # ou: npm start, para recompilar ao salvar
Ative o plugin em Plugins e coloque [mes_certo] em uma página.
Fontes de dados
Veja docs/providers.md para provedores, limites e termos.
Estrutura
mes-certo.php bootstrap e autoload
config/brand.php variáveis globais de marca
includes/ classes PHP (Plugin, Brand, Shortcode, Assets)
src/front/ app React do front
build/ saída do wp-scripts (versionada só em releases)
docs/ documentação
Convenção de commits
Conventional Commits (feat:, fix:, docs:, chore:...), um commit por mudança lógica. Cada checkpoint termina com uma tag v0.N.0.
Linha do tempo
| Checkpoint | Entrega | Tag |
|---|---|---|
| 0 Fundação | repositório, plugin base, React montando, marca, docs de APIs | v0.1.0 |
| 1 Cidade e clima | busca e clima mensal com cache | v0.2.0 |
| 2 Locais e motor | atrações, fotos, notas e roteiro | v0.3.0 |
| 3 Front | 6 blocos portados do protótipo | v0.4.0 |
| 4 Admin | blocos, cores, APIs, marca | v0.5.0 |
| 5 Release | robustez, i18n, README final | v1.0.0 |
Licença
GPL-2.0-or-later. Veja LICENSE.