@search-filters

Questo endpoint serve al frontend di Volto, per popolare il menu e i filtri per la ricerca:

> curl -i http://localhost:8080/Plone/@search-filters -H 'Accept: application/json'

Ritorna un json con le sezioni principali, la lista degli argomenti e i tipi di contenuto ricercabili (tradotti):

{
    "sections":{
        "amministrazione":{
            "@id": "",
            "path": "",
            "title": "",
            "items": [
                {
                    "@id": "",
                    "path": "",
                    "title": "",
                },
                ...
            ]
        }
        "documenti-e-dati": {...}
        "novita": {...}
        "servizi": {...}
    },
    "topics": [
        {
            "@id": "",
            "path": "",
            "title": "",
        },
        ...
    ],
    "portal_types": [
        ...
        {
          "label": "Document",
          "id": "Page"
        }
        ...
    ]
}

@search-bandi-filters

Questo endpoint serve al frontend di Volto, per popolare il menu e i filtri per la ricerca dei bandi:

> curl -i http://localhost:8080/Plone/@search-bandi-filters -H 'Accept: application/json'

Ritorna un json con la lista degli uffici (UO) referenziati da almeno un Bando e la lista delle parole chiave utilizzate dai Bandi:

{
  "offices": [
    {
      "key": "87bb96d90b6e42ee9db01ab2ab7543d5",
      "label": "uo 1"
    }
  ],
  "subjects": [
    "bar",
    "foo"
  ]
}

@send-action-form

Questo endpoint va chiamato su un contesto con i blocchi abilitati e serve al frontend di Volto, per inviare via mail il form compilato:

> curl -i -X POST http://localhost:8080/Plone/document/@send-action-form -H 'Accept: application/json' -H 'Content-Type: application/json' --data-raw '{"from": "john@doe.com", "message": "Just want to say hi.", "block_id": "123456"}'

All’endpoint vanno passati i seguenti parametri:

• block_id [obbligatorio]: l’id del blocco di tipo “form” che è stato compilato

• message [obbligatorio]: il messaggio da inviare

• from: l’indirizzo email del mittente. Se non presente, viene utilizzato il campo default_from del blocco

• subject: l’oggetto della mail. Se non presente, viene utilizzato il campo default_subject del blocco

• attachments: eventuali allegati riferiti a campi “file upload” inseriti nel form.

La struttura degli attachments è la seguente:

{
    "block_id": "foo",
    ...
    "attachments": {
        "field_id": {
            "data": "the content of the file",
            "content-type": "application/pdf",
            "filename": "example.pdf"
        }
    }
}

Se l’invio va a buon fine, viene tornata una risposta con 204.

Forzare autenticazione

Se le richieste arrivano con un header X-ForceAuth Plone forza l’autenticazione per quelle richieste, il meccanismo è utile ad esempiop se si vuole fare accedere alla ZMI o alle interfacce Plone legacy senza però esporle pubblicamente.

Test con Volto standalone

Si può usare questo prodotto anche da solo, per fare delle demo veloci di Volto, senza dover per forza creare un nuovo progetto/buildout.

E’ presente un file buildout.cfg anche in questo prodotto, quindi basta lanciare il buildout ed avviare l’istanza.

Il sito Plone sarà esposto sulla porta standard (8080) ed è già configurato per accettare chiamate dalla porta 3000 (quindi Volto dovrà girare su quella porta, che poi è il suo default).

5.1.0 (2026-10-19)

• Clean disable_searchable_types in order to install design.plone.policy on Plone 6.1 and 6.2. [lucabel]

• Resize (max 1600px) and convert to WebP the base64 images stored inline in “testo_riquadro_immagine” and “alert” blocks, on save and with an upgrade step for existing contents, to reduce the page payload. [mamico]

5.0.21 (2026-05-21)

• “Descrizione” now translate to “Descrizione breve” in italian. [fedevancin]

5.0.20 (2026-01-29)

• Fix translation for unique values in form patch. [cekk]

• Remove collective.volto.formsupport patches and override restapi services instead. [cekk]

5.0.19 (2025-11-17)

• Refactoring patch per waiting list [mamico]

5.0.18 (2025-10-07)

• Fix formsupport 3.3.0 compatibility (in add patch). [cekk]

5.0.17 (2025-10-02)

• Install contactsblocks. [lucabel]

• formsupport 3.3.0 compatibility. [mamico]

5.0.16 (2025-07-04)

• Fix exclude_from_nav index value for initial setup contents. [folix-01]

5.0.15 (2025-03-07)

• Align formsupport patches with collective.volto.formsupport >= 3.2.0. [cekk]

5.0.14 (2025-02-06)

• Fix volto.formsupport path to not alter returned data on POST (#74). [cekk]

5.0.13 (2024-12-05)

• Remove eea.api.taxonomy dependendency (it’s needed in contenttypes, not here). [cekk]

5.0.12 (2024-10-23)

• Fix a test for translations [mamico]

• Fix tests: do not import collective.volto.cookieconsent. [cekk]

5.0.11 (2024-09-05)

• fixed translate on form block patch

• fixed check on saved value [eikichi18]

5.0.10 (2024-09-04)

• search_sections in IDesignPloneSettings has a new filed in each section: expandItems that is a boolean to decide if the items of the section should be expanded or not (default is True). [mamico]

• Add a profile to limit addables on site root [lucabel]

• Patch for collective.volto.formsupport [eikichi18]

5.0.9 (2024-04-12)

• Fix test [lucabel]

5.0.8 (2024-04-11)

• Add collective.volto.slimheader dependency and profile requirement. [folix-01]

5.0.7 (2023-12-13)

• Update list of non searchable type in io-Comune [lucabel]

• Do not return section children in @search-filters endpoint if they are types omitted from search results. [cekk]

5.0.6 (2023-08-29)

• Fix to 3001 upgrade step. [folix-01]

5.0.5 (2023-08-16)

• Fix bad upgrade step (remove blocks with twitter feed) [folix-01]

• Set plone.base.interfaces.syndication.ISiteSyndicationSettings.show_author_info to False by default. [folix-01]

5.0.4 (2023-07-04)

• Add “Credits” with href https://www.io-comune.it. [lucabel]

• Remove twitter feeds. [folix-01]

5.0.3 (2023-06-13)

• Fix creation script: now set default blocks and blocks_layout. [cekk]

• Upgrade-step to fix all contents with broken blocks_layout. [cekk]

5.0.2 (2023-05-09)

• Fix setuphandlers’ utils for robotframework [mamico]

5.0.1 (2023-05-04)

• Add X-ForceAuth header and iw.rejectanonymous [mamico]

• Customize Access inactive portal content permission to allow access these contents also for not manager users. [cekk]

5.0.0 (2023-03-24)

• Fix test dependencies. [cekk]

5.0.0a5 (2023-03-01)

• Update upgrade scripts to call design.plone.contenttypes upgrade steps to version 7008 Install collective.feedback when install design.plone.policy [lucabel]

5.0.0a4 (2023-02-20)

• Upgrade script to generate first and second level menu due to a couple of typo [lucabel]

5.0.0a3 (2023-02-16)

• Upgrade footer initialization [lucabel]

• Add collective.feedback to setup.py [eikichi18]

5.0.0a2 (2023-01-13)

• Upgrades for new AGID AI [lucabel]

5.0.0a1 (2023-01-12)

• remove collective.dexteritytextindexer dependency. [cekk]

• adjustments to the pnrr. [deodorhunter, lucabek, eikichi18]

4.0.2 (2023-01-30)

• Aggiunto ordinamento per il filtro “Argomenti” nella pagina di ricerca. [lucabel]

4.0.1 (2022-12-07)

• Add “data-element” to custom attributes in html filters. [cekk]

4.0.0 (2022-11-07)

• Fix formsupport dependency to use honeypot and upgrade-step to set it in forms. [cekk]

3.0.0 (2022-08-16)

• Remove unused dependency in tests. [cekk]

2.12.0 (2022-07-05)

• scrub sensitive information for sentry [mamico]

• Improve @bandi-search-filters speed. [cekk]

2.11.3 (2022-01-27)

• Fix upgrade-step. [cekk]

2.11.2 (2022-01-27)

• Fix image miniature with 65536. [cekk]

2.11.1 (2022-01-27)

• Add new image miniature (midi). [cekk]

2.11.0 (2021-12-27)

• Add default blocks to automatically created pages. [cekk]

2.10.0 (2021-12-01)

• Remove enabled_vocabularies implementation because in recent plone.restapi (>8.15.2) there is a standard way. [cekk]

2.9.1 (2021-11-04)

• Install redturtle.faq by default. [cekk]

2.9.0 (2021-11-03)

• Add redturtle.faq dependency (it will not be installed by default). [cekk]

2.8.0 (2021-10-22)

• Add rer.customersatisfaction dependency. [cekk]

2.7.0 (2021-10-11)

• p.a.caching rules for rest api services. [cekk]

2.6.1 (2021-10-01)

• Updated blocks generation for “crea_area_trasparenza” view. [daniele]

2.6.0 (2021-09-29)

• Remove limited content-types in initial structure creation. [cekk]

2.5.0 (2021-09-20)

• Refactored search filters endpoints to be more efficient. [cekk]

• Can also add “Persona” in Politici folder. [cekk]

• Add collective.volto.subfooter as dependency. [cekk]

2.4.0 (2021-08-24)

• Add list of available vocabularies for Anonymous. [cekk]

2.3.0 (2021-07-07)

• Install collective.volto.subsites by default and add a set of colors. [cekk]

2.2.0 (2021-06-08)

• [new] @search-bandi-filters endpoint. [cekk]

2.1.2 (2021-05-14)

• [new] Content type ‘Bando’ is admitted by default in ‘Documenti e dati’ folder. [arsenico13]

2.1.1 (2021-05-04)

• Fix upgrade-step. [cekk]

2.1.0 (2021-05-04)

• Handle multiple twitter accounts in twitter endpoint. [cekk]

• Change twitter token field in registry (now is managed with interface). [cekk]

2.0.0 (2021-04-30)

• Update with new settings values from design.plone.contenttypes (version 3.0.0). [cekk]

• [dev] Fix CI [arsenico13]

• Add custom image scales [nzambello]

• search-filters endpoint now return also a list of searchable portal_types. [cekk]

• Disable some types from types_not_searched. [cekk]

1.1.0 (2021-03-24)

• Remove form route and add collective.volto.formsupport dependency. [cekk]

1.0.8 (2021-02-25)

• On install, set default search sections. [cekk]

1.0.7 (2021-02-19)

• Fix typo. [cekk]

1.0.6 (2021-02-19)

• Do not run dependencies when upgrading plone.app.registry. [cekk]

1.0.5 (2021-02-11)

• Install collective.volto.socialsettings by default. [cekk]

1.0.4 (2021-02-05)

• Add collective.volto.secondarymenu dependency. [cekk]

• Enable sitemap by default. [cekk]

1.0.3 (2021-01-28)

• Handle Unauthorized in search-filters endpoint. [cekk]

1.0.2 (2021-01-11)

• Manage also attachments in @send-action-form endpoint. [cekk]

1.0.1 (2020-12-18)

• Added view to create trasparenza structure. [daniele]

• Fixed folders creation when installing. [daniele]

• Add twitter-feed endpoint. [cekk]

1.0.0 (2020-12-07)

• Initial release. [cekk]