volto-searchblocks 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -8,6 +8,18 @@
 
 <!-- towncrier release notes start -->
 
+## 0.4.0 (2026-10-20)
+
+### Bugfix
+
+- Show a translated label ("Empty block (placeholder)") for the `empty` block type, the placeholder Volto gives to unfilled cells of container blocks such as the grid, instead of the raw type name. @cekk 
+
+## 0.3.1 (2026-10-07)
+
+### Feature
+
+- Reach the search blocks page from the user menu of the toolbar instead of the site control panel, where the "Search blocks" entry is gone. The link is shown only to the users the backend lists the `collective-searchblocks` user action for, and its label is that action's title, so it reads in the site's language. The back button of the page now leads to the site home rather than to the control panel. 
+
 ## 0.3.0 (2026-06-19)
 
 ## 0.3.0-alpha.7 (2026-04-21)

package/locales/de/LC_MESSAGES/volto.po

@@ -11,11 +11,6 @@ msgstr ""
 "Content-Transfer-Encoding: \n"
 "Plural-Forms: \n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr ""
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -31,6 +26,16 @@ msgstr ""
 msgid "Created"
 msgstr ""
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr ""
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr ""
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -63,7 +68,6 @@ msgstr ""
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr ""
 

package/locales/en/LC_MESSAGES/volto.po

@@ -11,11 +11,6 @@ msgstr ""
 "Content-Transfer-Encoding: \n"
 "Plural-Forms: \n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr ""
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -31,6 +26,16 @@ msgstr ""
 msgid "Created"
 msgstr ""
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr ""
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr ""
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -63,7 +68,6 @@ msgstr ""
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr ""
 

package/locales/es/LC_MESSAGES/volto.po

@@ -18,11 +18,6 @@ msgstr ""
 "X-Is-Fallback-For: es-ar es-bo es-cl es-co es-cr es-do es-ec es-es es-sv es-gt es-hn es-mx es-ni es-pa es-py es-pe es-pr es-us es-uy es-ve\n"
 "X-Generator: Poedit 2.2.1\n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr ""
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -38,6 +33,16 @@ msgstr ""
 msgid "Created"
 msgstr ""
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr ""
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr ""
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -70,7 +75,6 @@ msgstr ""
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr ""
 

package/locales/it/LC_MESSAGES/volto.po

@@ -12,11 +12,6 @@ msgstr ""
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "MIME-Version: 1.0\n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr "Torna al Pannello di Controllo"
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -32,6 +27,16 @@ msgstr "Scegli un tipo di blocco"
 msgid "Created"
 msgstr "Creato"
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr "Blocco vuoto (segnaposto)"
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr "Home"
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -64,7 +69,6 @@ msgstr "Stato di Revisione"
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr "Ricerca blocchi"
 

package/locales/pt_BR/LC_MESSAGES/volto.po

@@ -16,11 +16,6 @@ msgstr ""
 "Preferred-Encodings: utf-8\n"
 "Domain: volto\n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr ""
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -36,6 +31,16 @@ msgstr ""
 msgid "Created"
 msgstr ""
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr ""
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr ""
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -68,7 +73,6 @@ msgstr ""
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr ""
 

package/locales/volto.pot

@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: Plone\n"
-"POT-Creation-Date: 2026-04-21T10:14:53.092Z\n"
+"POT-Creation-Date: 2026-10-20T09:28:08.400Z\n"
 "Last-Translator: Plone i18n <plone-i18n@lists.sourceforge.net>\n"
 "Language-Team: Plone i18n <plone-i18n@lists.sourceforge.net>\n"
 "Content-Type: text/plain; charset=utf-8\n"
@@ -13,11 +13,6 @@ msgstr ""
 "Preferred-Encodings: utf-8\n"
 "Domain: volto\n"
 
-#. Default: "Back to Control Panel"
-#: components/SearchBlocks/SearchBlocks
-msgid "Back to Control Panel"
-msgstr ""
-
 #. Default: "Block Type"
 #: components/SearchBlocks/SearchBlocks
 msgid "Block Type"
@@ -33,6 +28,16 @@ msgstr ""
 msgid "Created"
 msgstr ""
 
+#. Default: "Empty block (placeholder)"
+#: components/SearchBlocks/SearchBlocks
+msgid "Empty block (placeholder)"
+msgstr ""
+
+#. Default: "Home"
+#: components/SearchBlocks/SearchBlocks
+msgid "Home"
+msgstr ""
+
 #. Default: "Loading..."
 #: components/SearchBlocks/SearchBlocks
 msgid "Loading"
@@ -65,7 +70,6 @@ msgstr ""
 
 #. Default: "Search blocks"
 #: components/SearchBlocks/SearchBlocks
-#: config/settings
 msgid "Search blocks"
 msgstr ""
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volto-searchblocks",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Additional control-panel that allow users to search which contents using a specific block",
   "main": "src/index.ts",
   "license": "MIT",
@@ -20,6 +20,13 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "scripts": {
+    "i18n": "rm -rf build/messages && NODE_ENV=production i18n --addon",
+    "dry-release": "release-it --dry-run",
+    "release": "release-it",
+    "release-major-alpha": "release-it major --preRelease=alpha",
+    "release-alpha": "release-it --preRelease=alpha"
+  },
   "addons": [],
   "theme": "",
   "peerDependencies": {
@@ -32,12 +39,5 @@
     "release-it": "^19.0.5",
     "typescript": "^5.7.3",
     "@plone/scripts": "^3.10.3"
-  },
-  "scripts": {
-    "i18n": "rm -rf build/messages && NODE_ENV=production i18n --addon",
-    "dry-release": "release-it --dry-run",
-    "release": "release-it",
-    "release-major-alpha": "release-it major --preRelease=alpha",
-    "release-alpha": "release-it --preRelease=alpha"
   }
-}
+}

package/src/components/SearchBlocks/SearchBlocks.jsx

@@ -70,9 +70,9 @@ const messages = defineMessages({
     id: 'No results found for',
     defaultMessage: 'No results found for',
   },
-  backToControlPanel: {
-    id: 'Back to Control Panel',
-    defaultMessage: 'Back to Control Panel',
+  backToHome: {
+    id: 'Home',
+    defaultMessage: 'Home',
   },
   private: {
     id: 'private',
@@ -94,6 +94,10 @@ const messages = defineMessages({
     id: 'draft',
     defaultMessage: 'Draft',
   },
+  emptyBlock: {
+    id: 'Empty block (placeholder)',
+    defaultMessage: 'Empty block (placeholder)',
+  },
 });
 
 const SearchBlocks = (props) => {
@@ -125,6 +129,13 @@ const SearchBlocks = (props) => {
     return <Error error={error} />;
   }
 
+  // 'empty' is the placeholder @type Volto gives to unfilled container
+  // (e.g. grid) cells: it has no blocksConfig entry, so translate it here.
+  const getBlockTitle = (type) =>
+    type === 'empty'
+      ? intl.formatMessage(messages.emptyBlock)
+      : config.blocks.blocksConfig[type]?.title || type;
+
   const handleSelect = (key) => {
     setSelectedBlockType(key);
     setCurrentPage(0);
@@ -185,10 +196,7 @@ const SearchBlocks = (props) => {
               value={selectedBlockType || ''}
               onChange={(id, value) => handleSelect(value)}
               choices={
-                block_types?.map((type) => [
-                  type,
-                  config.blocks.blocksConfig[type]?.title || type,
-                ]) || []
+                block_types?.map((type) => [type, getBlockTitle(type)]) || []
               }
               wrapped={false}
               isClearable={false}
@@ -286,9 +294,7 @@ const SearchBlocks = (props) => {
                   {...messages.noResults}
                   values={{ blockType: selectedBlockType }}
                 />{' '}
-                {config.blocks.blocksConfig[selectedBlockType]?.title ||
-                  selectedBlockType}
-                .
+                {getBlockTitle(selectedBlockType)}.
               </p>
             )}
           </div>
@@ -302,12 +308,12 @@ const SearchBlocks = (props) => {
             hideDefaultViewButtons
             inner={
               <>
-                <Link to="/controlpanel" className="item">
+                <Link to="/" className="item">
                   <Icon
                     name={backSVG}
                     className="contents circled"
                     size="30px"
-                    title={intl.formatMessage(messages.backToControlPanel)}
+                    title={intl.formatMessage(messages.backToHome)}
                   />
                 </Link>
               </>

package/src/components/manage/toolbar/ToolbarUserMenu.jsx

@@ -0,0 +1,31 @@
+import React from 'react';
+import { useSelector } from 'react-redux';
+import { Link } from 'react-router-dom';
+
+import { Icon } from '@plone/volto/components';
+import rightArrowSVG from '@plone/volto/icons/right-key.svg';
+import { Plug } from '@plone/volto/components/manage/Pluggable';
+
+export const ToolbarUserMenu = () => {
+  const searchBlocksAction = useSelector((state) =>
+    (state.actions?.actions?.user ?? []).find(
+      (action) => action.id === 'collective-searchblocks',
+    ),
+  );
+  return searchBlocksAction ? (
+    <Plug pluggable="toolbar-user-menu" id="collective-searchblocks-toolbar">
+      <li>
+        <Link
+          to="/controlpanel/search-blocks"
+          tabIndex={0}
+          className="deleteBlocks"
+          id="toolbar-search-blocks"
+        >
+          {searchBlocksAction.title} <Icon name={rightArrowSVG} size="24px" />
+        </Link>
+      </li>
+    </Plug>
+  ) : null;
+};
+
+export default ToolbarUserMenu;

package/src/index.ts

@@ -1,13 +1,11 @@
 import type { ConfigType } from '@plone/registry';
-import installSettings from './config/settings';
 
 import { searchBlocks } from './actions/searchBlocks';
 import searchBlocksReducer from './reducers/searchBlocks';
 import SearchBlocks from './components/SearchBlocks/SearchBlocks';
+import ToolbarUserMenu from './components/manage/toolbar/ToolbarUserMenu';
 
 function applyConfig(config: ConfigType) {
-  installSettings(config);
-
   config.addonReducers = {
     ...config.addonReducers,
     searchBlocks: searchBlocksReducer,
@@ -20,6 +18,14 @@ function applyConfig(config: ConfigType) {
       component: SearchBlocks,
     },
   ];
+  config.settings.appExtras = [
+    ...config.settings.appExtras,
+    {
+      match: '',
+      component: ToolbarUserMenu,
+      props: {},
+    },
+  ];
 
   return config;
 }

package/.changelog.draft

@@ -1,3 +0,0 @@
-## 0.3.0 (2026-06-19)
-
-

package/README.md

@@ -1,201 +0,0 @@
-# Search blocks (volto-searchblocks)
-
-A Volto add-on that provides a control panel for searching and managing content that uses specific blocks.
-
-[![npm](https://img.shields.io/npm/v/volto-searchblocks)](https://www.npmjs.com/package/volto-searchblocks)
-[![](https://img.shields.io/badge/-Storybook-ff4785?logo=Storybook&logoColor=white&style=flat-square)](https://collective.github.io/volto-searchblocks/)
-[![CI](https://github.com/collective/collective-searchblocks/actions/workflows/main.yml/badge.svg)](https://github.com/collective/collective-searchblocks/actions/workflows/main.yml)
-
-
-## Features ✨
-
-- **Search Blocks Control Panel**: Dedicated control panel view for searching content by block types
-- **Table Display**: Results displayed in a sortable table with key metadata
-- **Pagination**: Navigate through results with configurable page sizes (default, 50, or all)
-- **Block Type Selection**: Dropdown selector for choosing which block type to search for
-- **Multilingual Support**: Full i18n support with Italian translation included
-- **Error Handling**: Comprehensive error displays for API failures
-- **Semantic UI Integration**: Uses Volto's standard Semantic UI components for consistent styling
-
-## Installation
-
-To install your project, you must choose the method appropriate to your version of Volto.
-
-
-### Volto 18 and later
-
-Add `volto-searchblocks` to your `package.json`.
-
-```json
-"dependencies": {
-    "volto-searchblocks": "*"
-}
-```
-
-Add `volto-searchblocks` to your `volto.config.js`.
-
-```javascript
-const addons = ['volto-searchblocks'];
-```
-
-If this package provides a Volto theme, and you want to activate it, then add the following to your `volto.config.js`.
-
-```javascript
-const theme = 'volto-searchblocks';
-```
-
-### Volto 17 and earlier
-
-Create a new Volto project.
-You can skip this step if you already have one.
-
-```
-npm install -g yo @plone/generator-volto
-yo @plone/volto my-volto-project --addon volto-searchblocks
-cd my-volto-project
-```
-
-Add `volto-searchblocks` to your `package.json`.
-
-```JSON
-"addons": [
-    "volto-searchblocks"
-],
-
-"dependencies": {
-    "volto-searchblocks": "*"
-}
-```
-
-Download and install the new add-on.
-
-```
-yarn install
-```
-
-Start Volto.
-
-```
-yarn start
-```
-
-## Test installation
-
-Visit http://localhost:3000/ in a browser, login, and check the awesome new features.
-
-
-## Development
-
-The development of this add-on is done in isolation using pnpm workspaces, the latest `mrs-developer`, and other Volto core improvements.
-For these reasons, it only works with pnpm and Volto 18.
-
-
-### Prerequisites ✅
-
--   An [operating system](https://6.docs.plone.org/install/create-project-cookieplone.html#prerequisites-for-installation) that runs all the requirements mentioned.
--   [nvm](https://6.docs.plone.org/install/create-project-cookieplone.html#nvm)
--   [Node.js and pnpm](https://6.docs.plone.org/install/create-project.html#node-js) 22
--   [Make](https://6.docs.plone.org/install/create-project-cookieplone.html#make)
--   [Git](https://6.docs.plone.org/install/create-project-cookieplone.html#git)
--   [Docker](https://docs.docker.com/get-started/get-docker/) (optional)
-
-### Installation 🔧
-
-1.  Clone this repository, then change your working directory.
-
-    ```shell
-    git clone git@github.com:collective/collective-searchblocks.git
-    cd collective-searchblocks/frontend
-    ```
-
-2.  Install this code base.
-
-    ```shell
-    make install
-    ```
-
-
-### Make convenience commands
-
-Run `make help` to list the available Make commands.
-
-
-### Set up development environment
-
-Install package requirements.
-
-```shell
-make install
-```
-
-### Start developing
-
-Start the backend.
-
-```shell
-make backend-docker-start
-```
-
-In a separate terminal session, start the frontend.
-
-```shell
-make start
-```
-
-### Lint code
-
-Run ESlint, Prettier, and Stylelint in analyze mode.
-
-```shell
-make lint
-```
-
-### Format code
-
-Run ESlint, Prettier, and Stylelint in fix mode.
-
-```shell
-make format
-```
-
-### i18n
-
-Extract the i18n messages to locales.
-
-```shell
-make i18n
-```
-
-### Unit tests
-
-Run unit tests.
-
-```shell
-make test
-```
-
-### Run Cypress tests
-
-Run each of these steps in separate terminal sessions.
-
-In the first session, start the frontend in development mode.
-
-```shell
-make acceptance-frontend-dev-start
-```
-
-In the second session, start the backend acceptance server.
-
-```shell
-make acceptance-backend-start
-```
-
-In the third session, start the Cypress interactive test runner.
-
-```shell
-make acceptance-test
-```
-
-## License
-
-The project is licensed under the MIT license.

package/src/config/settings.ts

@@ -1,26 +0,0 @@
-import type { ConfigType } from '@plone/registry';
-import { defineMessages } from 'react-intl';
-import cardsSVG from '@plone/volto/icons/cards.svg';
-
-const messages = defineMessages({
-  controlPanelTitle: {
-    id: 'Search blocks',
-    defaultMessage: 'Search blocks',
-  },
-});
-
-export default function install(config: ConfigType) {
-  config.settings.controlpanels = [
-    ...config.settings.controlpanels,
-    {
-      '@id': '/search-blocks',
-      group: 'General',
-      title: messages.controlPanelTitle.defaultMessage,
-    },
-  ];
-  config.settings.controlPanelsIcons = {
-    ...config.settings.controlPanelsIcons,
-    'blocks-search': cardsSVG,
-  };
-  return config;
-}