https://github.com/eea/volto-group-block
A volto block to group blocks
https://github.com/eea/volto-group-block
plone react volto volto-addon volto-block volto-group volto-layout
Last synced: 2 months ago
JSON representation
A volto block to group blocks
- Host: GitHub
- URL: https://github.com/eea/volto-group-block
- Owner: eea
- License: mit
- Created: 2020-09-22T10:52:56.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-07-03T08:36:13.000Z (12 months ago)
- Last Synced: 2025-10-13T19:50:09.380Z (8 months ago)
- Topics: plone, react, volto, volto-addon, volto-block, volto-group, volto-layout
- Language: JavaScript
- Homepage:
- Size: 39.1 MB
- Stars: 3
- Watchers: 38
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-volto - volto-group-block - Group blocks in sections and filter available blocks per content-type per section (Add-ons / Layout add-ons)
README
# volto-group-block
[](https://github.com/eea/volto-group-block/releases)
[](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-group-block/job/master/display/redirect)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block)
[](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-group-block/job/develop/display/redirect)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block&branch=develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block&branch=develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block&branch=develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-group-block&branch=develop)
[Volto](https://github.com/plone/volto) add-on to group blocks in sections and filter available blocks per content-type per section
## Features
## Upgrade
### Upgrading to 10.x
> This version requires `Volto >= 17.18` or `Volto 18+`. It removes the custom `EditBlockWrapper` and uses Volto's built-in block chrome provided by `BlocksForm`.
#### Breaking changes
- **Removed `EditBlockWrapper.jsx`.** Any code importing `EditBlockWrapper` from `@eeacms/volto-group-block` will break. Use Volto's built-in `EditBlockWrapper` from `@plone/volto/components/manage/Blocks/Block/EditBlockWrapper` if you need a custom wrapper.
- **Removed the "Section help" button.** The `?` icon that appeared in the inner block toolbar and opened the sidebar to display editing instructions has been removed. The `instructions` field is still available in the group block schema and still rendered in the sidebar panel, but there is no longer a per-block shortcut button to reveal it.
- **`disableInnerButtons`** is now implemented via a CSS class (`.disable-inner-buttons`) instead of a JS-level `disabled` prop on the removed wrapper.
## Getting started
### Try volto-group-block with Docker
git clone https://github.com/eea/volto-group-block.gits
cd volto-group-block
make
make start
Go to http://localhost:3000
`make start` now defaults to Volto 18. To run the same setup against Volto 17, use:
VOLTO_VERSION=17 make
VOLTO_VERSION=17 make start
### Add volto-group-block to your Volto project
1. Make sure you have a [Plone backend](https://plone.org/download) up-and-running at http://localhost:8080/Plone
```Bash
docker compose up backend
```
1. Start Volto frontend
* If you already have a volto project, just update `package.json`:
```JSON
"dependencies": {
"@eeacms/volto-group-block": "*"
}
```
and `volto.config.js`:
```JavaScript
const addons = ['@eeacms/volto-group-block'];
```
* If not, create one with Cookieplone, as recommended by the official Plone documentation for Volto 18+:
```
uvx cookieplone project
cd project-title
```
1. Install or update dependencies, then start the project:
```
make install
```
For a Cookieplone project, start the backend and frontend in separate terminals:
```
make backend-start
make frontend-start
```
For a legacy Volto 17 project, install the package with `yarn` and restart the frontend as usual.
1. Go to http://localhost:3000
1. Happy editing!
## Release
See [RELEASE.md](https://github.com/eea/volto-group-block/blob/master/RELEASE.md).
## How to contribute
See [DEVELOP.md](https://github.com/eea/volto-group-block/blob/master/DEVELOP.md).
## Copyright and license
The Initial Owner of the Original Code is European Environment Agency (EEA).
All Rights Reserved.
See [LICENSE.md](https://github.com/eea/volto-group-block/blob/master/LICENSE.md) for details.
## Funding
[European Environment Agency (EU)](http://eea.europa.eu)