Skip to content

Commit a0b6e18

Browse files
Add Plone 6.1 upgrade notes for plone.app.z3cform and mockup (#1750)
Thank you @petschki! This is awesome. * Add upgrading notes for `plone.app.z3cform` and `mockup` * Tidy up upgrade items for `z3c.form` and `plone.app.z3cform` and `mockup` new pattern `pat-contentbrowser` --------- Co-authored-by: Steve Piercy <web@stevepiercy.com>
1 parent 7c69118 commit a0b6e18

File tree

1 file changed

+27
-8
lines changed

1 file changed

+27
-8
lines changed

docs/backend/upgrading/version-specific-migration/upgrade-to-61.md

Lines changed: 27 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -64,16 +64,35 @@ To upgrade your plugin implementation to TinyMCE 7, see the [upgrade guides](htt
6464

6565
## `z3c.form` and `plone.app.z3cform`
6666

67-
````{todo}
68-
This is a placeholder.
67+
[`plone.app.z3cform`](https://github.com/plone/plone.app.z3cform) is the form widget integration package for [`z3c.form`](https://github.com/zopefoundation/z3c.form) in Plone.
68+
This adds [Bootstrap 5](https://getbootstrap.com/) styling and mockup pattern options to all widgets.
6969

70-
- Update deprecated imports
71-
- New widget templates
70+
In Plone 6.1 all Classic UI widget classes were moved to the module `plone.app.z3cform.widgets`.
71+
The previous paths are marked as deprecated and will be removed in Plone 7.
7272

73-
```{seealso}
74-
https://github.com/plone/plone.app.z3cform/pull/181
75-
```
76-
````
73+
The `BaseWidget` for patterns is refactored to the new `z3c.form` extendable attributes introduced in version 5.1 and doesn't use LXML anymore.
74+
See https://github.com/zopefoundation/z3c.form/pull/116.
75+
If you have customizations in your base pattern widget class, see the new implementation at https://github.com/plone/plone.app.z3cform/blob/e9d1ebf478e663d2da259cb9435927f7ad1ddb92/plone/app/z3cform/widgets/base.py.
76+
77+
`RelatedItemsWidget` is marked as deprecated.
78+
The implementation for selecting related items, internal links and images in TinyMCE, or internal paths for collection criteria is now done with the new `ContentBrowserWidget`.
79+
This introduces a new pattern `pat-contentbrowser` from mockup.
80+
See the next section for details.
81+
82+
83+
## `mockup` new pattern `pat-contentbrowser`
84+
85+
A new content browsing pattern [`pat-contentbrowser`](https://plone.github.io/mockup/pat/contenbrowser/) for Classic UI is now available.
86+
87+
This is a [Miller column browser](https://en.wikipedia.org/wiki/Miller_columns) implementation which replaces [`pat-relateditems`](https://plone.github.io/mockup/pat/relateditems/) seamlessly.
88+
All basic options from `pat-relateditems` are implemented and behave the same as before.
89+
90+
Additionally `pat-contentbrowser` comes with some new features.
91+
92+
- Keyboard navigation.
93+
- Multi-selection of items with {kbd}`Shift/Ctrl/CMD + click` combination.
94+
This comes in handy for selecting multiple related items in one step.
95+
- Uploading items to the current path.
7796

7897

7998
## `plone.app.multilingual` is a core add-on

0 commit comments

Comments
 (0)