rinvex / laravel-forms
Rinvex Forms is a dynamic form builder for Laravel, it's like the missing gem, the possibilities of using it are endless! With flexible API and powerful features you can build almost every kind of complex form with ease.
Requires
- php: ^7.4.0 || ^8.0.0
- illuminate/console: ^8.0.0 || ^9.0.0
- illuminate/database: ^8.0.0 || ^9.0.0
- illuminate/support: ^8.0.0 || ^9.0.0
- jackpopp/geodistance: ^1.2.0
- propaganistas/laravel-phone: ^4.2.0
- rinvex/countries: ^7.0.0
- rinvex/languages: ^5.0.0
- rinvex/laravel-support: ^5.0.0
Requires (Dev)
- codedungeon/phpunit-result-printer: ^0.30.0
- illuminate/container: ^8.0.0 || ^9.0.0
- phpunit/phpunit: ^9.5.0
README
⚠️ This package is abandoned and no longer maintained. No replacement package was suggested. ⚠️
👉 If you are interested to step on as the main maintainer of this package, please reach out to me!
Rinvex Forms is a dynamic form builder for Laravel, it's like the missing gem, the possibilities of using it are endless! With flexible API and powerful features you can build almost every kind of complex form with ease.
Installation
-
Install the package via composer:
composer require rinvex/laravel-forms
-
Publish resources (migrations and config files):
php artisan rinvex:publish:forms
-
Execute migrations via the following command:
php artisan rinvex:migrate:forms
-
Done!
Warning
⚠️ This documentation ins INCOMPLETE! Please use on your own, or wait until it's ready! ⚠️
Usage
To add forms to other entities, simply use \Rinvex\Forms\Traits\HasForms
trait in the model. Example: you may have Event
model, that requires registration form, then confirmation form, and every form fields differs from an event to another, in this case you can attach From
models to your Event
models using that trait.
To add form responses to users, simply use \Rinvex\Forms\Traits\HasFormResponses
trait in the model. Example: you most probably will allow your users to fill forms while signed in, in such case you need to attach their responses to their accounts for later retrieval, and you can do so using that trait. This will attach FormResponse
models to your user models User
.
Manage your forms
// Get instance of your parent model (ex. `Event`) $event = new \App\Models\Event::find(1); // Create multiple new forms $event->forms()->createMany([ [...], [...], [...], ]); // Find an existing form $form = app('rinvex.forms.form')->find(1); // Update an existing form $form->update([ 'name' => 'Contact Us', ]); // Delete form $form->delete(); // Alternative way of form deletion $event->forms()->where('id', 123)->first()->delete(); // Get attached forms collection $event->forms; // Get attached forms query builder $event->forms();
Changelog
Refer to the Changelog for a full history of the project.
Support
The following support channels are available at your fingertips:
Contributing & Protocols
Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.
Bug reports, feature requests, and pull requests are very welcome.
Security Vulnerabilities
If you discover a security vulnerability within this project, please send an e-mail to help@rinvex.com. All security vulnerabilities will be promptly formed.
About Rinvex
Rinvex is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Alexandria, Egypt since June 2016. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. That’s how we do our share of advancing humanity.
License
This software is released under The MIT License (MIT).
(c) 2016-2021 Rinvex LLC, Some rights reserved.