Download the PHP package uspdev/forms without Composer
On this page you can find all versions of the php package uspdev/forms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package forms
Short Description Formulários dinâmicos com persistência
License GPL-2.0-or-later
Informations about the package forms
Forms
Forms é uma biblioteca uspdev que permite gerar formulários dinâmicos a partir de definições armazenadas em banco de dados e, opcionalmente, persiste os resultados.
Funcionalidades
- Gera formulários a partir de definições no BD;
- Processa a submissão dos formulários com validação e persistência;
- Mostra o resultado com views padrão;
- Possui crud completo para
admin
; - Suporta estilos em Bootstrap 4 e 5;
- Integra com aplicações Laravel 11 em diante.
Instalação
-
Instale a biblioteca via Composer e publique as migrations
- Menu na aplicação
No arquivo config/laravel-usp-theme.php
, adicione ou reposicione a chave uspdev-forms para mostrar o menu. Ele será visível apenas para administradores.
Configuração
Você pode personalizar as configurações do pacote modificando o arquivo config/uspdev-forms.php
.
php artisan vendor:publish --tag=forms-config
Uso
-
Crie uma entrada na tabela form_definitions
-
Nome do formulário: nome único que identifica o formulário
-
Grupo: serve para agrupar vários formulários em implementações mais complexas
-
Descrição: campo livre sem uso específico no sistema
- Campos: campos do formulário
-
texto de 1 linha
-
dois campos na mesma linha
-
select simples
-
textarea
-
file (upload de arquivo)
-
pessoa-usp
-
disciplina-usp
FormDefinition::create($form);
- Gere o formulário na sua view:
Use a classe FormGenerator para renderizar o formulário no seu template Blade:
- Trate as submissões do formulário:
No seu controller, trate a submissão do formulário salvando os dados no banco de dados:
-
Listar submissões Recupere todas as submissões em geral ou de um formulário específico:
- Obter submissão Recupere uma submissão específica pelo seu id:
Campos
Tipos
- pessoa-usp: campo tipo select que faz busca no replicado e retorna uma pessoa. nome do campo recomendado: codpes;
- text: texto simples
- email: valida campos email
- select: precisa passar
options
- textarea:
- file: pode passar
"accept" : ".pdf, image/*"
Contribuindo
Contribuições são bem-vindas! Siga estes passos para contribuir:
- Faça um fork do repositório.
- Crie um novo branch (git checkout -b feature/SuaFuncionalidade).
- Faça suas alterações e commit (git commit -m 'Adiciona nova funcionalidade').
- Envie para o branch (git push origin feature/SuaFuncionalidade).
- Crie um novo Pull Request.
Licença
Este pacote está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.
Resumo do Conteúdo
- Visão Geral do Pacote: Descreve o que o pacote faz.
- Funcionalidades: Destaca as principais funcionalidades.
- Passos de Instalação: Fornece instruções detalhadas de instalação.
- Detalhes de Configuração: Guia sobre como personalizar as configurações.
- Exemplos de Uso: Mostra como criar um formulário YAML e usá-lo na sua aplicação.
- Guia de Contribuição: Incentiva contribuições com passos claros.
- Informações de Licença: Indica a licença
All versions of forms with dependencies
illuminate/support Version ^11.0
uspdev/replicado Version ^1.25
spatie/laravel-activitylog Version ^4.10