@plone/volto 16.2.0 → 16.4.0

package/.changelog.draft

@@ -0,0 +1,28 @@
+## 16.4.0 (2022-12-12)
+
+### Feature
+
+- Update Traefik version and make volume mount (docker-compose) read-only [#4067](https://github.com/plone/volto/issues/4067)
+- Allow addons to provide an `eslint.extend.js` file that customizez eslint configuration @tiberiuichim [#4072](https://github.com/plone/volto/issues/4072)
+
+### Bugfix
+
+- Update Chinese translation @adam139 [#4009](https://github.com/plone/volto/issues/4009)
+- Reset value of search field after submit. [@MAX-786] [#4028](https://github.com/plone/volto/issues/4028)
+- Don't crash the view page when dealing with unknown blocks @tiberiuichim [#4070](https://github.com/plone/volto/issues/4070)
+- Bump version for plone-backend version used in Makefile @tiberiuichim [#4071](https://github.com/plone/volto/issues/4071)
+- Properly handle whitespace in HTML (richtext) slate-based widget @tiberiuichim [#4082](https://github.com/plone/volto/issues/4082)
+- Add Finnish translation (contributed by @rioksane)
+  [erral] [#4084](https://github.com/plone/volto/issues/4084)
+- Fix typo in english translation and add missing french translation
+  [mpeeters, jchandelle] [#4085](https://github.com/plone/volto/issues/4085)
+
+### Internal
+
+- Make Volto compatible with pnpm as package manager [#4023](https://github.com/plone/volto/issues/4023)
+
+### Documentation
+
+- Add content for user-manual of Volto, Plone 6 frontend. [@MAX-786] [#3827](https://github.com/plone/volto/issues/3827)
+- Remove duplicate `H1`-level page title, and inherit from Volto's `CHANGELOG.md`. @stevepiercy [#4048](https://github.com/plone/volto/issues/4048)
+

package/.storybook/static/previewImage.svg

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 13.0.1, SVG Export Plug-In . SVG Version: 6.00 Build 14948)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="158.253px" height="40.686px" viewBox="0 0 158.253 40.686" enable-background="new 0 0 158.253 40.686"
+	 xml:space="preserve">
+<g>
+	<path fill="#0095D3" d="M65.327,23.208h-6.589v11.388h-4.393V5.638h10.981c5.653,0,9.271,3.742,9.271,8.785
+		S70.979,23.208,65.327,23.208z M65.082,9.583h-6.345v9.639h6.345c3.05,0,5.124-1.749,5.124-4.799
+		C70.206,11.372,68.132,9.583,65.082,9.583z"/>
+	<path fill="#0095D3" d="M83.969,34.596c-3.904,0-5.652-2.644-5.652-5.693V5.638h4.148v23.021c0,1.587,0.567,2.399,2.235,2.399h1.83
+		v3.538H83.969z"/>
+	<path fill="#0095D3" d="M104.762,32.399c-1.344,1.384-3.377,2.44-6.184,2.44c-2.805,0-4.799-1.058-6.141-2.44
+		c-1.951-2.032-2.439-4.637-2.439-8.134c0-3.457,0.488-6.061,2.439-8.094c1.342-1.383,3.336-2.44,6.141-2.44
+		c2.807,0,4.84,1.059,6.184,2.44c1.951,2.033,2.439,4.637,2.439,8.094C107.203,27.763,106.713,30.366,104.762,32.399z
+		 M101.629,18.613c-0.773-0.773-1.83-1.181-3.051-1.181c-1.219,0-2.236,0.406-3.01,1.181c-1.26,1.261-1.422,3.416-1.422,5.652
+		s0.162,4.393,1.422,5.653c0.773,0.771,1.791,1.22,3.01,1.22c1.221,0,2.277-0.447,3.051-1.22c1.262-1.262,1.424-3.417,1.424-5.653
+		S102.891,19.873,101.629,18.613z"/>
+	<path fill="#0095D3" d="M123.643,34.596V22.029c0-3.214-1.83-4.597-4.147-4.597s-4.271,1.423-4.271,4.597v12.566h-4.147v-20.62
+		h4.065v2.074c1.425-1.546,3.416-2.318,5.49-2.318c2.115,0,3.865,0.691,5.084,1.871c1.586,1.545,2.074,3.497,2.074,5.815v13.178
+		L123.643,34.596L123.643,34.596z"/>
+	<path fill="#0095D3" d="M135.772,25.486c0,3.537,1.871,5.774,5.246,5.774c2.317,0,3.539-0.649,5.004-2.115l2.643,2.481
+		c-2.115,2.114-4.107,3.213-7.727,3.213c-5.166,0-9.273-2.725-9.273-10.574c0-6.671,3.457-10.534,8.744-10.534
+		c5.531,0,8.744,4.067,8.744,9.925v1.83H135.772z M144.475,19.791c-0.65-1.545-2.113-2.604-4.066-2.604
+		c-1.951,0-3.457,1.059-4.107,2.604c-0.406,0.936-0.488,1.546-0.529,2.807h9.273C145.003,21.337,144.883,20.726,144.475,19.791z"/>
+	<circle fill="#0095D3" cx="17.815" cy="11.516" r="4.402"/>
+	<path fill="#0095D3" d="M31.167,20.311c0,2.433-1.969,4.401-4.403,4.401c-2.427,0-4.401-1.97-4.401-4.401
+		c0-2.433,1.975-4.401,4.401-4.401C29.2,15.909,31.167,17.879,31.167,20.311z"/>
+	<circle fill="#0095D3" cx="17.801" cy="29.131" r="4.402"/>
+	<g>
+		<path fill="#0095D3" d="M20.441-0.045C9.207-0.044,0.1,9.063,0.099,20.298C0.1,31.532,9.207,40.639,20.441,40.641
+			c11.235-0.002,20.341-9.107,20.343-20.343C40.783,9.063,31.677-0.044,20.441-0.045z M31.891,31.747
+			c-2.937,2.934-6.972,4.742-11.45,4.743c-4.478-0.001-8.513-1.811-11.45-4.743C6.058,28.81,4.25,24.775,4.249,20.298
+			c0.001-4.478,1.809-8.513,4.743-11.45c2.937-2.934,6.972-4.742,11.45-4.743c4.478,0.001,8.513,1.81,11.45,4.743
+			c2.934,2.938,4.742,6.973,4.743,11.45C36.633,24.775,34.825,28.81,31.891,31.747z"/>
+	</g>
+	<g>
+		<path fill="#0095D3" d="M153.985,9.95c-1.195,0-2.164,0.971-2.164,2.168c0.002,1.197,0.969,2.168,2.164,2.168
+			c1.199,0,2.172-0.971,2.172-2.168S155.184,9.95,153.985,9.95z M153.985,13.968c-1.021-0.002-1.846-0.827-1.846-1.85
+			c0.002-1.021,0.825-1.849,1.846-1.851c1.023,0.002,1.852,0.828,1.854,1.851C155.836,13.141,155.008,13.966,153.985,13.968z"/>
+	</g>
+	<g>
+		<path fill="#0095D3" d="M154.507,13.409l-0.54-1.08h-0.486v1.08h-0.389v-2.564h0.994c0.484,0,0.796,0.313,0.796,0.75
+			c0,0.367-0.224,0.602-0.513,0.68l0.592,1.136L154.507,13.409L154.507,13.409z M154.056,11.195h-0.575v0.803h0.575
+			c0.261,0,0.437-0.147,0.437-0.399S154.317,11.195,154.056,11.195z"/>
+	</g>
+</g>
+</svg>

package/CHANGELOG.md

@@ -1,4 +1,75 @@
-# Change Log
+# Volto Release Notes
+
+<!-- You should *NOT* be adding new change log entries to this file.
+     You should create a file in the news directory instead.
+     For helpful instructions, please see:
+     https://6.dev-docs.plone.org/volto/developer-guidelines/contributing.html#create-a-pull-request
+-->
+
+<!-- towncrier release notes start -->
+
+## 16.4.0 (2022-12-12)
+
+### Feature
+
+- Update Traefik version and make volume mount (docker-compose) read-only [#4067](https://github.com/plone/volto/issues/4067)
+- Allow addons to provide an `eslint.extend.js` file that customizez eslint configuration @tiberiuichim [#4072](https://github.com/plone/volto/issues/4072)
+
+### Bugfix
+
+- Update Chinese translation @adam139 [#4009](https://github.com/plone/volto/issues/4009)
+- Reset value of search field after submit. [@MAX-786] [#4028](https://github.com/plone/volto/issues/4028)
+- Don't crash the view page when dealing with unknown blocks @tiberiuichim [#4070](https://github.com/plone/volto/issues/4070)
+- Bump version for plone-backend version used in Makefile @tiberiuichim [#4071](https://github.com/plone/volto/issues/4071)
+- Properly handle whitespace in HTML (richtext) slate-based widget @tiberiuichim [#4082](https://github.com/plone/volto/issues/4082)
+- Add Finnish translation (contributed by @rioksane)
+  [erral] [#4084](https://github.com/plone/volto/issues/4084)
+- Fix typo in english translation and add missing french translation
+  [mpeeters, jchandelle] [#4085](https://github.com/plone/volto/issues/4085)
+
+### Internal
+
+- Make Volto compatible with pnpm as package manager [#4023](https://github.com/plone/volto/issues/4023)
+
+### Documentation
+
+- Add content for user-manual of Volto, Plone 6 frontend. [@MAX-786] [#3827](https://github.com/plone/volto/issues/3827)
+- Remove duplicate `H1`-level page title, and inherit from Volto's `CHANGELOG.md`. @stevepiercy [#4048](https://github.com/plone/volto/issues/4048)
+
+
+## 16.3.0 (2022-12-05)
+
+### Feature
+
+- Add towncrier support. Create RELEASING.md and move and update Releasing section from README.md into it. @sneridagh @stevepiercy [#3985](https://github.com/plone/volto/issues/3985)
+- Translation of roles in user and group control panel. Fix https://github.com/plone/volto/issues/4002 @wesleybl [#4002](https://github.com/plone/volto/issues/4002)
+- Use the component registry for `Container` component in DefaultView @sneridagh [#4032](https://github.com/plone/volto/issues/4032)
+- Update missing german translations @steffenri
+
+### Bugfix
+
+- Fix GitHub release notes in new Towncrier release config @sneridagh [#3989](https://github.com/plone/volto/issues/3989)
+- Clear error message when canceling user add. Fix https://github.com/plone/volto/issues/4006 @wesleybl [#4006](https://github.com/plone/volto/issues/4006)
+- Fix subscript and supscript active at same time. @iFlameing [#4011](https://github.com/plone/volto/issues/4011)
+- Complete eu translation
+  [erral] [#4015](https://github.com/plone/volto/issues/4015)
+- Complete es translation
+  [erral] [#4016](https://github.com/plone/volto/issues/4016)
+- Add `cypress.config.js` to generator templates @sneridagh [#4021](https://github.com/plone/volto/issues/4021)
+- Bump Volto core packages with the current Volto version on Volto release @sneridagh [#4025](https://github.com/plone/volto/issues/4025)
+
+### Internal
+
+- Remove unused dangling root appExtras from configuration registry @sneridagh [#4024](https://github.com/plone/volto/issues/4024)
+
+### Documentation
+
+- Rewrite "Upgraded core to use Cypress 11" section. @stevepiercy [#3979](https://github.com/plone/volto/issues/3979)
+- Include `CHANGELOG.md` at the correct path, depending on context of entire Plone 6 documentation or only Volto documentation. @stevepiercy [#3992](https://github.com/plone/volto/issues/3992)
+- Close the open Glossary list. @stevepiercy [#3995](https://github.com/plone/volto/issues/3995)
+- Added docs for proper usage of draftjs for richtext widgets. @pnicolli [#4001](https://github.com/plone/volto/issues/4001)
+- Document how to change the base font and the font for headings. Describe how to host the font. @ksuess [#4013](https://github.com/plone/volto/issues/4013)
+
 
 ## 16.2.0 (2022-11-25)
 
@@ -13,6 +84,7 @@
 - Improve collapsing of whitespace when pasting to slate text block @tiberiuichim
 - Avoid warning for missing value in NumberWidget @tiberiuichim
 - Fix crash in Slate link editing in a dexterity field @tiberiuichim
+- Fix select widget loosing focus when the value has changed @reebalazs
 
 ## 16.1.0 (2022-11-23)
 
@@ -414,6 +486,8 @@ See https://6.dev-docs.plone.org/volto/upgrade-guide/index.html for more informa
 - Remove `sentryOptions` from settings reference. Clean up `deploying/sentry.md`. @stevepiercy
 - Tidy up `upgrade-guide/index.md`. @stevepiercy
 - Fix some MyST syntax and English grammar. @stevepiercy
+- Add contributing branch policy information @sneridagh @stevepiercy
+- Add component to storybook @danalvrz
 
 ## 16.0.0-rc.1 (2022-11-18)
 
@@ -4488,7 +4562,7 @@ https://docs.voltocms.com/upgrade-guide/
 - Added item type as a tooltip in contents @nzambello
 - Added Italian translations and translated array, token and select widget. @giuliaghisini
 - Added uploading image preview in FileWidget @iFlameing
-- Allow custom express middleware declared with `settings.expressMiddleware`. See [Customizing Express](docs/source/customizing/express.md) @tiberiuichim
+- Allow custom express middleware declared with `settings.expressMiddleware`. See [Custom Express middleware](https://6.dev-docs.plone.org/volto/recipes/express.html) @tiberiuichim
 
 ### Bugfix
 

package/README.md

@@ -314,37 +314,6 @@ Browse to [http://localhost:3000](http://localhost:3000) in your browser.
 yarn test
 ```
 
-### Releasing
-
-For ease the release process, we use `release-it` utility that helps with the process.
-
-https://www.npmjs.com/package/release-it
-
-For using it and start a release you need to fulfill the requirements:
-
-- Have permissions to push on master branch
-- Have permissions on the @plone org on npmjs.com
-- Have a environment variable (`GITHUB_TOKEN`) with a GitHub personal token with permissions to
-  write the Volto Release page on GitHub (https://www.npmjs.com/package/release-it#github-releases)
-
-Then the command for release:
-
-```shell
-yarn release
-```
-
-a dry-release command for testing the output is also available:
-
-```shell
-yarn dry-release
-```
-
-and alpha release can also be cut using:
-
-```shell
-yarn release-alpha
-```
-
 ## Acceptance testing
 
 Here you can find a guide on how acceptance testing is done in Volto:

package/RELEASING.md

@@ -0,0 +1,73 @@
+# Releasing
+
+To ease the release process, we use the utility [`release-it`](https://www.npmjs.com/package/release-it) which helps with the process, and [`towncrier`](https://towncrier.readthedocs.io) for creating and maintaining change logs.
+
+## Release requirements
+
+To start a release, you must fulfill the following requirements:
+
+- Have permission to push to `master` branch
+- Have permission on the [`@plone` organization on npm](https://www.npmjs.com/org/plone).
+- Have an environment variable `GITHUB_TOKEN` with a GitHub personal token with permissions to write to the [Volto Release page on GitHub](https://github.com/plone/volto/releases).
+- Install [`pipx`](https://pypa.github.io/pipx/) in your system.
+
+To request these permissions, on GitHub tag `@plone/release-team`, or in Discord post to the [`release-team` channel](https://discord.com/channels/786421998426521600/897549410521714760).
+
+### Permission to push to `master` branch
+
+The release process involves pushing directly to the `master` branch.
+Volto's `master` branch is protected, so the releaser needs to have permission for pushing to it.
+At the moment of this writing, members of the GitHub group `@plone/volto-team` have permission to push to `master`.
+
+### Permission to release Volto to npm registry
+
+We push Volto's releases to the npm registry.
+The releaser has to have permissions for pushing a release in the [`@plone` organization on npm](https://www.npmjs.com/org/plone).
+Only the current Owners of this organization can grant permissions to the releaser.
+
+### Have a GitHub personal token with permissions to write the Volto's Releases
+
+The `release-it` library takes care of creating and pushing a GitHub Release for each release.
+It requires you to get a GitHub personal token with permission to write to the Volto's Releases.
+This can be acquired in your GitHub profile page.
+When making a release, export the environment variable `GITHUB_TOKEN` in your shell session.
+
+```shell
+export GITHUB_TOKEN="my_looooong_github_token"
+```
+
+See `release-it` documentation of [GitHub releases](https://www.npmjs.com/package/release-it#github-releases) and GitHub documentation [About releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases).
+
+### Install `pipx` in your system
+
+The release process calls `towncrier`.
+It is a Python library that uses the Python utility `pipx`.
+This utility allows you to call and execute Python modules without installing them as a prerequisite in your system.
+It works similar to the NodeJS `npx` utility.
+On macOS, you can install `pipx` into your system:
+
+```shell
+brew install pipx
+```
+
+Or follow detailed instructions in the `pipx` documentation for [Installation](https://pypa.github.io/pipx/installation/).
+
+## Running the release process
+
+These are the commands to make a Volto release:
+
+```shell
+yarn release
+```
+
+A dry-release command for testing the output is also available:
+
+```shell
+yarn dry-release
+```
+
+An alpha release can be cut using:
+
+```shell
+yarn release-alpha
+```

package/addon-registry.js

@@ -148,7 +148,7 @@ class AddonConfigurationRegistry {
       },
     );
 
-    this.initRazzleExtenders();
+    this.initAddonExtenders();
   }
 
   /**
@@ -310,18 +310,26 @@ class AddonConfigurationRegistry {
   }
 
   /**
-   * Allow addons to provide razzle.config extenders. These extenders
-   * modules (named razzle.extend.js) need to provide two functions:
+   * Allow addons to provide various extenders.
+   *
+   * The razzle.extend.js modules (named razzle.extend.js) needs to provide
+   * two functions:
    * `plugins(defaultPlugins) => plugins` and
    * `modify(...) => config`
+   *
+   * The eslint.extend.js
    */
-  initRazzleExtenders() {
+  initAddonExtenders() {
     this.getAddons().forEach((addon) => {
       const base = path.dirname(addon.packageJson);
       const razzlePath = path.resolve(`${base}/razzle.extend.js`);
       if (fs.existsSync(razzlePath)) {
         addon.razzleExtender = razzlePath;
       }
+      const eslintPath = path.resolve(`${base}/eslint.extend.js`);
+      if (fs.existsSync(eslintPath)) {
+        addon.eslintExtender = eslintPath;
+      }
     });
   }
 
@@ -340,6 +348,12 @@ class AddonConfigurationRegistry {
       .filter((e) => e);
   }
 
+  getEslintExtenders() {
+    return this.getAddons()
+      .map((o) => o.eslintExtender)
+      .filter((e) => e);
+  }
+
   /**
    * Returns a mapping name:diskpath to be uses in webpack's resolve aliases
    */

package/cypress/support/commands.js

@@ -49,6 +49,7 @@ Cypress.Commands.add(
     path = '',
     allow_discussion = false,
     transition = '',
+    bodyModifier = (body) => body,
   }) => {
     let api_url, auth;
     if (Cypress.env('API') === 'guillotina') {
@@ -69,7 +70,7 @@ Cypress.Commands.add(
           Accept: 'application/json',
         },
         auth: auth,
-        body: {
+        body: bodyModifier({
           '@type': contentType,
           id: contentId,
           title: contentTitle,
@@ -80,7 +81,7 @@ Cypress.Commands.add(
             'content-type': 'text/plain',
           },
           allow_discussion: allow_discussion,
-        },
+        }),
       });
     }
     if (contentType === 'Image') {
@@ -91,7 +92,7 @@ Cypress.Commands.add(
           Accept: 'application/json',
         },
         auth: auth,
-        body: {
+        body: bodyModifier({
           '@type': contentType,
           id: contentId,
           title: contentTitle,
@@ -102,7 +103,7 @@ Cypress.Commands.add(
             filename: 'image.png',
             'content-type': 'image/png',
           },
-        },
+        }),
       });
     }
     if (
@@ -116,7 +117,7 @@ Cypress.Commands.add(
             Accept: 'application/json',
           },
           auth: auth,
-          body: {
+          body: bodyModifier({
             '@type': contentType,
             id: contentId,
             title: contentTitle,
@@ -131,7 +132,7 @@ Cypress.Commands.add(
               ],
             },
             allow_discussion: allow_discussion,
-          },
+          }),
         })
         .then(() => {
           if (transition) {
@@ -151,12 +152,12 @@ Cypress.Commands.add(
             Accept: 'application/json',
           },
           auth: auth,
-          body: {
+          body: bodyModifier({
             '@type': contentType,
             id: contentId,
             title: contentTitle,
             allow_discussion: allow_discussion,
-          },
+          }),
         })
         .then(() => {
           if (transition) {

package/docker-compose.yml

@@ -47,7 +47,7 @@ services:
 
   reverse-proxy:
     # The official v2 Traefik docker image
-    image: traefik:v2.8
+    image: traefik:v2.9
     # Enables the web UI and tells Traefik to listen to docker
     command: --api.insecure=true --providers.docker
     ports:
@@ -57,7 +57,7 @@ services:
       - "8888:8080"
     volumes:
       # So that Traefik can listen to the Docker events
-      - /var/run/docker.sock:/var/run/docker.sock
+      - /var/run/docker.sock:/var/run/docker.sock:ro
     labels:
       - traefik.http.middlewares.gzip.compress=true
       - traefik.http.middlewares.gzip.compress.excludedcontenttypes=image/png, image/jpeg, font/woff2

package/locales/ca/LC_MESSAGES/volto.po

@@ -1639,7 +1639,7 @@ msgid "Image view"
 msgstr "Imatge"
 
 #: components/manage/Widgets/RecurrenceWidget/Occurences
-# defaultMessage: Include this occurence
+# defaultMessage: Include this occurrence
 msgid "Include this occurence"
 msgstr "Incloeu aquesta ocurrència"
 
@@ -1738,7 +1738,7 @@ msgid "Item batch size"
 msgstr "Mida del lot d'articles"
 
 #: components/manage/Contents/Contents
-# defaultMessage: Item succesfully moved.
+# defaultMessage: Item successfully moved.
 msgid "Item succesfully moved."
 msgstr "L'element s'ha mogut correctament."