rinvex/laravel-forms

This package is abandoned and no longer maintained. No replacement package was suggested.

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.

v5.0.1 2020-12-25 01:42 UTC

README

This package is NOT actively maintained! Want to jump in as a maintainer? Ping me @omranic

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.

Packagist Scrutinizer Code Quality Travis StyleCI License

Installation

  1. Install the package via composer:

    composer require rinvex/laravel-forms
  2. Publish resources (migrations and config files):

    php artisan rinvex:publish:forms
  3. Execute migrations via the following command:

    php artisan rinvex:migrate:forms
  4. 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.