Vikunja para Wordpress

This commit is contained in:
2025-09-20 19:19:00 -03:00
parent 65e3309266
commit a7cbbb7b47
7 changed files with 764 additions and 140 deletions

View File

@@ -1,59 +1,57 @@
# Sistema Arte
Plugin WordPress para gerenciamento de tarefas integrado à API Vikunja.
Plugin WordPress para gerenciamento de demandas de arte.
## Descrição
O **Sistema Arte** é um plugin para WordPress que permite a criação e acompanhamento de demandas de artes gráficas, integrando-se diretamente à API Vikunja para gerenciamento de tarefas. O plugin oferece um formulário customizado para solicitação de demandas e exibe uma lista das tarefas pendentes do projeto configurado.
O **Sistema Arte** é um plugin para WordPress que cria um sistema autônomo para gerenciamento de demandas de arte dentro do painel de administração. Ele permite que usuários enviem solicitações através de um formulário e que os administradores gerenciem o fluxo de trabalho usando um quadro Kanban.
## Funcionalidades
- Formulário customizado para solicitação de artes, com campos obrigatórios:
- Título da arte
- Nome completo do solicitante
- Secretaria
- Telefone/WhatsApp
- Detalhes da solicitação
- Data de entrega (padrão: hoje + 7 dias às 17h)
- Prioridade
- Integração direta com a API Vikunja para criação e listagem de tarefas
- Exibição das demandas pendentes em tabela
- Validação de campos obrigatórios e feedback de sucesso/erro
- Interface moderna utilizando Tailwind CSS
- **Formulário de Solicitação:** Um formulário customizado para solicitação de artes, com campos para:
- Título, nome do solicitante, secretaria, contato.
- Detalhes da solicitação e anexo de arquivos.
- Data de entrega e nível de prioridade.
- **Gerenciamento no WordPress:**
- As demandas são salvas como um tipo de post personalizado ("Demandas de Arte").
- Utiliza uma taxonomia customizada ("Status") para controlar o fluxo.
- **Quadro Kanban:**
- Um painel de administração visual com as colunas: `Demanda`, `Fazer`, `Fazendo` e `Feito`.
- Funcionalidade de arrastar e soltar (drag-and-drop) para mover as demandas entre as colunas e atualizar seu status.
- **IDs Sequenciais:**
- Sistema de ID personalizado e sequencial (ex: A001, A002) para fácil identificação das demandas.
- **Lista de Demandas Pendentes:**
- O shortcode exibe uma tabela com todas as demandas que não estão com o status "Feito".
- **Interface Moderna:**
- Utiliza Tailwind CSS para o formulário e um design limpo para o quadro Kanban.
## Instalação
1. Faça upload da pasta `sistema-arte` para o diretório `wp-content/plugins/` do seu WordPress.
2. Ative o plugin no painel do WordPress.
3. Configure as variáveis de integração com a API Vikunja em `includes/config.php`:
- `$apiBase`: URL base da API
- `$token`: Token de acesso
- `$projectId`: ID do projeto no Vikunja
3. Após a ativação, o menu "Demandas de Arte" aparecerá no painel de administração.
## Uso
Adicione o shortcode `[Sistema-Arte]` em qualquer página ou post para exibir o formulário de solicitação e a lista de demandas.
## Estrutura dos Arquivos
- `sistema-arte.php`: Arquivo principal do plugin
- `includes/config.php`: Configurações da API
- `includes/api.php`: Funções de integração com a API Vikunja
- `includes/templates/form.php`: Template do formulário de solicitação
- `includes/templates/tasks.php`: Template da lista de tarefas
- `includes/assets/script.js`: Scripts JS para manipulação do formulário
- `includes/assets/script.js`: Scripts JS para o formulário (máscara de telefone)
- `includes/assets/kanban-board.js`: Scripts JS para a funcionalidade do quadro Kanban
- `includes/assets/kanban-style.css`: Estilos CSS para o quadro Kanban
## Dependências
- [Tailwind CSS](https://tailwindcss.com/) (via CDN)
- jQuery (WordPress padrão)
- jQuery UI Sortable (WordPress padrão, para o Kanban)
- jQuery Mask Plugin (via CDN, para o campo de telefone)
## Segurança
- Utiliza `wp_nonce_field` para proteção contra CSRF
- Sanitização e validação de todos os campos do formulário
- Escapando de todas as saídas para evitar XSS
## Observações
- O plugin depende de um projeto e token válidos na API Vikunja.
- O usuário do token precisa de permissão de escrita no projeto configurado.
- Em caso de erro de permissão, dados inválidos ou projeto não encontrado, mensagens detalhadas são exibidas ao usuário.
## Autor
Marco Antonio Vivas
---
Plugin desenvolvido para integração com o sistema Vikunja, facilitando a gestão de demandas de artes no WordPress.
Plugin desenvolvido para facilitar a gestão de demandas de artes diretamente no WordPress.