Initial commit

README.md

@@ -0,0 +1,67 @@
+# Gerenciador de Eventos (eventos-manager)
+
+Plugin WordPress para cadastro, gerenciamento e exibição de eventos com calendário interativo, lista de próximos eventos e integração via shortcodes e widget.
+
+## Funcionalidades
+
+- Cadastro de eventos personalizados (CPT: `evento`)
+- Metabox para data, hora e local do evento
+- Taxonomia personalizada para tipos de evento
+- Calendário interativo (FullCalendar.js) com AJAX
+- Lista de próximos eventos filtrável por tipo e limite
+- Shortcodes para exibição do calendário, lista e widget
+- Página única customizada para eventos (`single-evento.php`)
+- Widget para exibir próximos eventos na sidebar
+- Página de ajuda no admin
+
+## Instalação
+
+1. Faça upload da pasta `eventos-manager` para o diretório `wp-content/plugins/`.
+2. Ative o plugin no painel do WordPress.
+3. O tipo de post "Evento" estará disponível no menu lateral.
+
+## Shortcodes Disponíveis
+
+- `[mostra-calendario]` — Exibe o calendário de eventos.
+- `[mostra-prox-eventos limit="5" tipo=""]` — Lista os próximos eventos. Parâmetros:
+  - `limit`: número de eventos (padrão: 5)
+  - `tipo`: slug do tipo de evento (opcional)
+- `[eventos-completo]` — Exibe calendário e lista de próximos eventos juntos.
+- `[mostra-calendario-widget]` — Exibe um calendário compacto para sidebar ou widgets.
+
+## Widget
+
+- Vá em **Aparência > Widgets** e adicione o widget "Próximos Eventos" à sua sidebar.
+- Configure o título e o limite de eventos a exibir.
+
+## Custom Post Type e Taxonomia
+
+- **Post Type:** `evento`
+- **Taxonomia:** `tipo_evento` (hierárquica)
+
+## Templates
+
+- O plugin inclui o template `single-evento.php` para exibição individual dos eventos.
+
+## Scripts e Estilos
+
+- FullCalendar.js e Moment.js são carregados automaticamente.
+- Estilos customizados para admin e frontend em `/assets/css/`.
+
+## AJAX
+
+- Os eventos do calendário são carregados via AJAX para melhor performance.
+
+## Página de Ajuda
+
+- Acesse em **Eventos > Ajuda** para instruções e exemplos de uso dos shortcodes.
+
+## Autor
+
+Marco Antonio Vivas
+
+---
+
+**Observação:**
+- Para personalizações avançadas, edite os arquivos em `includes/` e os templates conforme necessário.
+- Compatível com WordPress 5.0+.