You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**djangocms-form-builder** supports rendering of styled forms. The objective is
8
-
to tightly integrate forms in the website design. **djangocms-form-builder**
9
-
allows as many forms as you wish on one page. All forms are **ajax/xhr-based**.
10
-
To this end, **djangocms-form-builder** extends the django CMS plugin model
11
-
allowing a form plugin to receive ajax post requests.
7
+
**djangocms-form-builder** supports rendering of styled forms. The objective is to tightly integrate forms in the website design. **djangocms-form-builder** allows as many forms as you wish on one page. All forms are **xhr-based**. To this end, **djangocms-form-builder** extends the django CMS plugin model allowing a form plugin to receive xhr post requests.
12
8
13
9
There are two different ways to manage forms with **djangocms-form-builder**:
14
10
15
-
1. **Building a form with django CMS' powerful structure board.** This is
16
-
fast an easy. It integrates smoothly with other design elements, especially
17
-
the grid elements allowing to design simple responsive forms.
11
+
1. **Building a form with django CMS' powerful structure board.** This is fast an easy. It integrates smoothly with other design elements, especially the grid elements allowing to design simple responsive forms.
18
12
19
-
Form actions can be configured by form. Built in actions include saving the
20
-
results in the database for later evaluation and mailing submitted forms to
21
-
the site admins. Other form actions can be registered.
13
+
Form actions can be configured by form. Built in actions include saving the results in the database for later evaluation and mailing submitted forms to the site admins. Other form actions can be registered.
22
14
23
-
2. Works with **django CMS v4** and **djangocms-alias** to manage your forms centrally.
24
-
Djangocms-alias becomes your form editor and forms can be placed on pages by
25
-
refering to them with their alias.
15
+
2. Works with **django CMS v4** and **djangocms-alias** to manage your forms centrally. Djangocms-alias becomes your form editor and forms can be placed on pages by referring to them with their alias.
26
16
27
-
3. **Registering an application-specific form with djangocms-form-builder.** If you
28
-
already have forms you may register them with djangocms-form-builder and allow
29
-
editors to use them in the form plugin. If you only have simpler design
30
-
requirements, **djangocms-form-builder** allows you to use fieldsets as with
31
-
admin forms.
17
+
3. **Registering an application-specific form with djangocms-form-builder.** If you already have forms you may register them with djangocms-form-builder and allow editors to use them in the form plugin. If you only have simpler design requirements, **djangocms-form-builder** allows you to use fieldsets as with admin forms.
32
18
33
19
**************
34
20
Key features
@@ -40,44 +26,43 @@ There are two different ways to manage forms with **djangocms-form-builder**:
40
26
41
27
- Integrates with `django-crispy-forms <https://github.com/django-crispy-forms/django-crispy-forms>`_
42
28
29
+
- Integrates with `djangocms-frontend <https://github.com/django-cms/djangocms-frontend>`_
30
+
43
31
44
32
Feedback
45
33
========
46
34
47
-
This project is in a early stage. All feedback is welcome! Please
48
-
mail me at fsbraun(at)gmx.de
35
+
This project is in a early stage. All feedback is welcome! Please mail me at fsbraun(at)gmx.de
49
36
50
37
Also, all contributions are welcome.
51
38
52
39
Contributing
53
40
============
54
41
55
-
This is a an open-source project. We'll be delighted to receive your
56
-
feedback in the form of issues and pull requests. Before submitting your
This is a an open-source project. We'll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our `contribution guidelines <http://docs.django-cms.org/en/latest/contributing/index.html>`_.
64
43
44
+
We're grateful to all contributors who have helped create and maintain this package. Contributors are listed at the `contributors <https://github.com/fsbraun/djangocms-form-builder/graphs/contributors>`_ section.
65
45
66
46
47
+
************
67
48
Installation
68
-
============
49
+
************
69
50
70
51
For a manual install:
71
52
53
+
- run ``pip install djangocms-form-builder``, **or**
54
+
72
55
- run ``pip install git+https://github.com/fsbraun/djangocms-form-builder@master#egg=djangocms-form-builder``
73
56
74
-
- add ``djangocms_form_builder`` to your ``INSTALLED_APPS``:
57
+
- add ``djangocms_form_builder`` to your ``INSTALLED_APPS``. (If you are using both djangocms-frontend and djangocms-form-builder, add it **after** djangocms-frontend
75
58
76
59
- run ``python manage.py migrate``
77
60
78
-
To use the **djangocms-form-builder** you will have to have
79
-
jQuery installed in your project. ``djangocms-form-builder`` does not include
0 commit comments