Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/meysampg/yii2-formbuilder
A drag and drop form builder with jQuery for Yii2
https://github.com/meysampg/yii2-formbuilder
drog-drop-form-builder form-builder jquery yii yii2 yii2-extension yii2-formbuilder
Last synced: 3 months ago
JSON representation
A drag and drop form builder with jQuery for Yii2
- Host: GitHub
- URL: https://github.com/meysampg/yii2-formbuilder
- Owner: meysampg
- License: mit
- Archived: true
- Created: 2016-10-08T10:19:03.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-01T06:26:21.000Z (over 1 year ago)
- Last Synced: 2024-09-18T22:33:00.305Z (3 months ago)
- Topics: drog-drop-form-builder, form-builder, jquery, yii, yii2, yii2-extension, yii2-formbuilder
- Language: PHP
- Homepage: http://pourganji.ir/yii2-formbuilder
- Size: 1.68 MB
- Stars: 34
- Watchers: 7
- Forks: 27
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Yii2 Form Builder
=================
🟥⚠️ _THIS PACKAGE IS ABANDONED. PLEASE SELECT ANOTHER PACKAGE OR FORK THIS REPOSITORY AND INFORM ME ON p.g.meysam [at] Gmail [dot] com TO REFER TO YOUR PACKAGE IN PACKAGIST_ ⚠️🟥
A drag and drop form builder with jQuery for Yii2 which built upon to [jQuery FormBuilder](https://github.com/kevinchappell/formBuilder) plugin.
Installation
------------
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```
composer.phar require meysampg/yii2-formbuilder "*"
```
or add
```
"meysampg/yii2-formbuilder": "*"
```
to the require section of your `composer.json` file.
Usage
-----
Once the extension is installed, simply use it in your code by:
```php
use meysampg\formbuilder\FormBuilder;
```
and use it as a widget:
```php
= FormBuilder::widget(); ?>
```
Configurations
--------------
There are some properties that let you to easily control over form builder.
| Property | Type | Description | Default Value |
|-----|--------|----------------|---------------|
|accessVariableName| string|JavaScript variable name for accessing to formbuilder contents in JS codes | `'formBuilderJsVariable'` |
|data | array | list of elements for rendering as default elements of form builder| |
|dataType| string| indicates that input and output data must be XML or JSON| `'xml'` |
|elementType| string | HTML tag for form builder constructor | `'div'` |
|messages| array | list of label strings on a desired language | |
|language| string| Desired language for showing form builder (See translation section)| |
| options | array | list of plugin options, see [FormBuilder Documentations](http://formbuilder.readthedocs.io/en/latest/) | |
|showActionButtons| boolean | indicates that control buttons be showed or not | `false` |
Examples
-------------
```php
= FormBuilder::widget([
'data' => [
[
"type" => "header",
"subtype" => "h1",
"label" => "Header",
"class" => "header",
],
[
"type" => "button",
"label" => "Button",
"subtype" => "button",
"class" => "button-input btn btn-warning",
"name" => "button-1475845417456",
"style" => "warning",
],
],
]); ?>
```
----
```php
= FormBuilder::widget([
'dataType' => 'json'
]); ?>
```
---
```php
= FormBuilder::widget([
'messages' => [
"autocomplete" => "Autocomplete 23",
],
]); ?>
```
---
```php
= FormBuilder::widget([
'language' => 'fa-IR',
]); ?>
```
Translation
-----------
Simply copy `en.php` file in `messages` folder and rename it to your language (e.g. `ar`, `fr`, `fa`, `fa-IR` ...), translate strings, commit your changes and send a pull request.