https://github.com/novactive/novaformbuilderbundle
A bundle to create dynamic symfony form
https://github.com/novactive/novaformbuilderbundle
Last synced: 11 months ago
JSON representation
A bundle to create dynamic symfony form
- Host: GitHub
- URL: https://github.com/novactive/novaformbuilderbundle
- Owner: Novactive
- Created: 2018-06-01T13:01:43.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-23T09:26:46.000Z (about 2 years ago)
- Last Synced: 2025-04-10T07:57:55.987Z (12 months ago)
- Language: PHP
- Size: 502 KB
- Stars: 1
- Watchers: 21
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Novactive Form Builder
| Branch | Travis build status |
|:--------:|:-------------------:|
| master | [](https://travis-ci.org/Novactive/NovaFormBuilderBundle)
A bundle to create dynamic symfony form.
This bundle aims to provide a _lib_ to help generating dynamic form in a symfony app.
It provides 2 bundles:
- `bundle` the symfony bundle
- `ezbundle` the bridge to use bundle in eZ Platform
> Note that eZ Platform is a pure symfony app then the bridge is just about wiring the IHM
# Installation
### Requirements
* eZ Platform 2+
* PHP 7.1+
* MySQL 5.7.8+ / Maria DB 10.1+
### Installation steps
Run `composer require novactive/formbuilder` to install the bundle and its dependencies:
### Register the bundles
Activate the bundle in `app\AppKernel.php` file.
```php
// app\AppKernel.php
public function registerBundles()
{
...
$bundles = array(
new FrameworkBundle(),
...
// FormBuilder bundles
new Novactive\Bundle\FormBuilderBundle\FormBuilderBundle(),
new Novactive\Bundle\eZFormBuilderBundle\NovaeZFormBuilderBundle()
);
...
}
```
### Add routes
```yaml
_novaezformbuilder_routes:
resource: '@NovaeZFormBuilderBundle/Resources/config/routing.yml'
```
### Install the database schema
```bash
bin/console novaformbuilder:install
```
### Troubleshooting
If the bundle web assets (css, js etc.) are missing in the public directory it can be fixed by running the following commands:
```bash
bin/console assets:install --symlink --relative
bin/console assetic:dump
```
That will install bundles web assets under a public directory and dump them to the filesystem.
Also if the **translations** are not loaded at once clearing the Symfony cache folder must help.
# Migrate DB from Ez Survey
The database of the old **Ez Survey Bundle** can be migrated to this **Novactive Form Builder Bundle**.
To do that run the following commands inside _ezplatform_ folder:
php bin/console novaformbuilder:migrate --export
php bin/console novaformbuilder:migrate --import
The first one exports the data from the old database to json files.
The second one imports the data from json files to the new database.
After that the dumped data is still in the json files inside web/var/site/storage/files/forms folder.
They can be removed manually if they are not needed anymore.
What the migration script does is:
It takes all surveys to convert them into forms. Each of them is related to particular _Ez content_.
If more than one record have the same content_id the script takes the latest one due to the _ID_ value.
Then it takes all questions to convert into fields and results + questions results to convert into submissions.
There is also the option to truncate the current **Novactive Form Builder Bundle**
tables in the database:
php bin/console novaformbuilder:migrate --clean
After running the Migrate scripts you might need to clear the **Redis Cache**
if it's used on the project to apply the changes that have been made to the database.
The migration doesn't support the cases if there are more than one **ezsurvey** fields
in any particular Content Type.
To apply the custom Form design on the Front End the bundle template
**fields/ezcustomform_show_front.html.twig** should be overridden
with another template inside _Ez Platform_.
Contributing
----------------
[Contributing](CONTRIBUTING.md)
Change and License
------------------
[License](LICENSE)
----
Made with <3 by novactive.