In addition to creating custom modules, developers can also define custom fields for use in settings forms using their own HTML.
You do not need to wrap your template in
with an ID. Beaver Builder will handle that for you.
Inside your field file you will have access to the following properties on the
The config that you defined for this field in your module's PHP file.
The global settings object for Beaver Builder.
The name (or key) for this field as it will be stored on the settings object when saved.
The saved settings for the form this field is a part of.
The saved value for this field.
Using those properties, you can create any type of field markup that you wish.
Just make sure something is using the
so it can be properly saved. Here is an example of a simple text field file.
Once you have created your custom field files, you'll need to register them
fl_builder_custom_fields filter. That filter will pass a
array to your callback function with the array keys being the field types and
the array values being the paths to the fields. The field type you enter will
be what you need to use in your module's form config to use that field.
Your field type should be prefixed so it doesn't clash with core
field types or other custom fields. For example, if you have a field type
toggle, it should be
my-toggle in case the core plugin ever introduces a
toggle field type.
Register your custom fields to be autoloaded by Beaver Builder, as shown below.
After you have registered your custom field file, it can be used in your module settings as follows.