Skip to content

Support the @blocks-schema endpoint (Volto 19.6) - #30

Merged
ericof merged 1 commit into
mainfrom
issue-29
Nov 12, 2026
Merged

ericof merged 1 commit into
mainfrom
issue-29

Conversation

@ericof

@ericof ericof commented Nov 12, 2026

Copy link
Copy Markdown
Member

This adds support for the @blocks-schema endpoint of Volto 19.6 to the form block (schemaForm), so agents and generated reference documentation can read how its data is written.

  • docs.block.md documents the data the block stores: the form's own settings and the JSON schema of its fields, with a complete example of a working form.
  • The settings schema now takes only intl, and the fields that depend on the block's own settings are applied in the editor, so the endpoint can build the schema.
  • The development setup moves from Volto 19.1.4 to 19.7.0. The add-on still declares no Volto requirement; the README notes that @blocks-schema support needs Volto 19.6 or later, and older versions ignore the file.

The settings-dependent visibility and requirements moved from the schema into applySchemaFormConditions, which the editor uses, so the editor behaves as before. The email defaults still come from the registry when a site sets them. Unit tests cover the schema called with only intl and the editor conditions; the endpoint tests fail on the previous schema.

Closes #29

The settings schema of the schemaForm block takes only intl, so the
@blocks-schema endpoint of Volto can build it outside the editor. The
fields that depend on the block's own settings are now applied in the
editor by applySchemaFormConditions. A registry override of the email
defaults still takes precedence over the block defaults.

Adds docs.block.md with the stored settings, the schema of the fields
and a complete example. Moves the development setup from Volto 19.1.4
to 19.7.0 and adds the webpack catalog override. The README notes that
the endpoint needs Volto 19.6 or later.

Refs #29
@ericof
ericof requested a review from sneridagh November 12, 2026 16:52
@ericof
ericof merged commit e5d610e into main Nov 12, 2026
14 checks passed
@ericof
ericof deleted the issue-29 branch November 12, 2026 20:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation to be used by the new @blocks-schema endpoint

2 participants