not showing up

[hjanuschka]

most likely its my own fault.

but i followed the setup guid for neoscms here -> https://docs.neos.io/guide/installation-development-setup/manual-setup/mac-os-linux-using-the-embedded-web-server

and installed form-builder using

composer require neos/form-builder

and i cannot see a form "node" as shown in the screenshot on the README.md any hints on where to further debug this ?

[bwaidelich]

You mean, you can't find the "Form" element in the "Create Node Wizard" as shown here: ?

Maybe try:

• Flushing caches (./flow flow:cache:flush)
• Rescanning installed packages (./flow flow:package:rescan)
• Check whether nodes of the type Neos.Form.Builder:NodeBasedForm are allowed at the place where you wanted to insert the form (see https://docs.neos.io/guide/manual/content-repository/nodetype/node-constraints)

[hjanuschka]

tried all of it, tbh not yet fully aware of node constraints, such a painfull xp. installed the demo site package.

and tried inserting a node ("+") on each of this levels.

is it the demo site? do you have any other suggestion? in fact i just wan't to build a custom form field - and that is my first touchpoint with neos.

[bwaidelich]

not yet fully aware of node constraints, such a painfull xp

It might be painful to get to know the concepts, but node constraints actually provide great flexibility and XP to the editors because they don't have to think of impossible content element combinations.

is it the demo site?

I don't know, you should know :) But judging from the node title, it looks like it is.

and tried inserting a node ("+") on each of this levels.

The form builder is a content element so you want to add it in one of the Content Collections. But you won't have to use the Structure tree for that. Instead in your content area you should see placeholders that allow you to insert new content elements directly inline.

[hjanuschka]

demosite sorry that might have been miss communicated, i have the demo site, meant if it could be related to the use of the demo site.

ok it does not show up :( added a new blank page - and think that should be the right place where it should be available

nodetype:list

shows the ones that look like are the right ones.:

[hjanuschka]

other question, do you have some sort of testing repo that could be used as a starter? (maybe something you use in CI ?)

[bwaidelich]

nodetype:list

Returns a list of all configured node types, ignoring their constraints.

The Neos.Demo site comes with quite some restrictive constraints to demonstrate the concept, but frankly that is not very helpful when trying to get something up and running.

other question, do you have some sort of testing repo that could be used as a starter?

Not really. For CI we use the demo site in order to test common use cases. But to get started, I would suggest, you start with a blank site, which won't have any NodeType constraints predefined.

With the demo site installed, you first have to explicitly allow new content element, for example within multi-column containers:

https://github.com/neos/form-builder/assets/307571/41db421e-ae93-4817-a6a1-73f0752583d5

Excuse the bad quality, github wouldn't let me upload the original screen recording.

The trick was to add

'Neos.Form.Builder:NodeBasedForm': true

to the constraints of Neos.Demo:Collection.Content.Column.

Alternatively, you can create a custom NodeTypes.yaml file underneath /Configuration with:

'Neos.Form.Builder:NodeBasedForm':
  superTypes:
    'Neos.Demo:Constraint.Content.Column': true

HTH

[hjanuschka]

awesome, that works! many thanks for your effort, even doing a video, and sorry for me asking stupid questions!

[bwaidelich]

Don't worry, there are no stupid questions and you're absolutely right, that the initial XP could be improved