Skip to content

Commit 18912a5

Browse files
committed
WIP forms
1 parent 58b4b7d commit 18912a5

File tree

1 file changed

+2
-17
lines changed

1 file changed

+2
-17
lines changed

docs/classic-ui/forms.md

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -11,28 +11,15 @@ myst:
1111

1212
# Forms
1313

14-
15-
16-
17-
18-
19-
20-
21-
2214
```{todo}
2315
Describe how create forms with Plone's default form framework z3c.form.
2416
Fields, Widgets, Vocabularies aso are descripted in detail in there own chapter and will be referenced from examples here.
2517
```
2618

27-
2819
Plone uses the [z3c.form](http://pythonhosted.org/z3c.form) library to build its web-forms.
29-
The package responsible for integrating with Plone is [plone.z3cform](https://github.com/plone//plone.z3cform).
30-
31-
To simplify the process of organizing a form and specifying its widgets and fields, Plone utilizes [plone.autoform](https://github.com/plone/plone.autoform), in particular its `AutoExtensibleForm` base class.
32-
It is responsible for handling form hints and configuring z3c.form widgets and groups (fieldsets).
20+
The packages responsible for integrating with Plone are [plone.z3cform](https://github.com/plone//plone.z3cform) and [plone.app.z3cform](https://github.com/plone/plone.app.z3cform) which contains most of the widgets and default templates. To simplify the process of organizing a form and specifying its widgets and fields, Plone utilizes [plone.autoform](https://github.com/plone/plone.autoform), in particular its `AutoExtensibleForm` base class. It is responsible for handling form hints and configuring z3c.form widgets and groups (fieldsets).
3321

3422
A form is a view that utilizes these libraries.
35-
plone.autoform offers useful base classes for views that simplify the process of creating forms based on either the form schema or {ref}`Dexterity behaviors <backend-behaviors-label>`.
3623

3724

3825
(classic-ui-forms-general-forms-label)=
@@ -46,7 +33,7 @@ cd collective.awesomeaddon
4633
plonecli add form
4734
```
4835

49-
After using the {term}`plonecli` to add a form, there is a new sub folder `forms` in your package.
36+
After using the {term}`plonecli` to add a form, you'll have a new sub folder `forms` in your package.
5037
Here you will find a `configure.zcml` containing the registration of the form,
5138

5239
```xml
@@ -118,8 +105,6 @@ You can build custom add and edit forms to adjust there behavior.
118105
The implementation of the default edit and add forms is in [plone.dexterity.browser.edit.py](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/edit.py) and [plone.dexterity.browser.add.py](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/add.py).
119106

120107

121-
122-
123108
```{todo}
124109
Describe Add/Edit forms here and how to customize them.
125110
Provide mutiple examples.

0 commit comments

Comments
 (0)