PLIP: Remove `pat-relateditems` in Plone 7

[petschki]

PLIP (Plone Improvement Proposal)

Responsible Persons

Proposer: Peter M. / petschki

Seconder: add your name here

Abstract

The mockup pattern pat-relateditems depends on an old and customized version of select2 (https://github.com/ivaynberg/select2.git#3.5.4 with mockup patch https://github.com/plone/mockup/blob/master/patches/select2.patch).

Since pat-relateditems gets replaced by the new pat-contentbrowser I propose to remove it completely in Plone 7.

Motivation

Get rid of the old select2 and keep the Classic-UI stack up to date.

Proposal & Implementation

The new pattern pat-contentbrowser has the same features as pat-relateditems so it should be easy to switch for addon developers but of course we need a migration documentation for this.

Deliverables

• mockup: Contentbrowser pattern is already there so the deliverable is documentation on how to migrate from Relateditems pattern to Contentbrowser pattern. Basic example is already available here: https://github.com/plone/plone.app.relationfield/pull/51/files#diff-ca7062ca2dfc3c97d4491cf6724591e4dd8b3320ac92815b3fcd6a720166dc2c

• plone.app.z3cform: Show deprecation warnings in RelatedItemsWidget to use ContentBrowserWidget instead.

Risks

Possible breakage of addons which still depend on pat-relateditems -> mininmize risks with deprecation warnings in plone.app.z3cform.widgets.relateditems.RelatedItemsWidget

Participants

• petschki
• add your name here

@plone/classicui-team