@eeacms/volto-hero-block
Enhanced Hero Block Volto add-on
Features

Upgrade
Upgrading to 10.x
This version requires
Volto 18orVolto 19and Node.js 22.
The block, its schema and its blocksWithFootnotesSupport configuration keep the same names and defaults, so upgrading from 9.x on Volto 18 needs no content changes. The release adds Volto 19 support and moves the repository to the Volto 19 layout, where the published package lives in packages/volto-hero-block.
Breaking changes
- Node.js 22 or newer is required (
engines.node >= 22), 9.x declared no engine. - React 18 is required. The package declares
reactandreact-domas^18.2.0peers, 9.x declared no peers. - The package no longer ships the Jest setup.
jest-addon.config.jswas removed andjest.setup.jsbecamevitest.setup.jsx, so a Volto 18 project that still runs the Jest harness has to keep its own copy.
The link rendered by the remix-icon field now carries rel="noopener noreferrer" instead of rel="noopener".
Upgrading to 9.x
This version requires
Volto >= 17.18orVolto 18+. It removes the customEditBlockWrapperusage in favor of Volto's built-in block chrome provided byBlocksForm.
Breaking changes
- Removed
EditBlockWrapperrender prop fromBlocksForm. TheBlocksFormchildren render prop that wrapped each inner block in<EditBlockWrapper>has been removed.BlocksFormnow handles block chrome internally via Volto core'sEditBlockWrapper. Any code that relied on the children render prop pattern in the hero block'sEditcomponent will need to be updated. disableInnerButtonscontinues to work via the existing CSS rules inedit.cssrather than the previously useddisabledprop onEditBlockWrapper.
Upgrading to 2.x
This version requires: @plone/volto >= 16.0.0.alpha.46 (schemaEnhancer / addStyling).
Upgrading to 6.x
Starting with version 6.0.0 we have the following breaking changes from version 5.x.x:
- Removed inner
divthat was used to addquoted-wrapperclass. Thisclassis now added on the maindivalongside the otherblockoptions. - Block is using
BlocksFormto add more than oneSlateblocks. This is useful in case you have to add some sub titles or extra paragraphs inside theHero block. The defaultSlatetag is stillh2but you can change it using the rich text options toolbar.
Requirements
Backend
Frontend
- Node.js:
>=22.0.0
Installation
Make sure you have a Plone backend up-and-running at http://localhost:8080/Plone
docker compose up backendStart Volto frontend
If you already have a volto project, just update
package.json:"dependencies": { "@eeacms/volto-hero-block": "*" }and
volto.config.js:const addons = ['@eeacms/volto-hero-block'];If not, create one with Cookieplone, as recommended by the official Plone documentation for Volto 18+:
uvx cookieplone project cd project-title
Install or update dependencies, then start the project:
make installFor a Cookieplone project, start the backend and frontend in separate terminals:
make backend-start make frontend-startGo to http://localhost:3000
Happy editing!
License
See LICENSE.md for details.