Skip to content

Commit e59418c

Browse files
authored
Forms/extending settings (#6755)
* Clarified documentation on creating a custom setting type * Updated version reference * Fixes
1 parent ca3e21a commit e59418c

File tree

3 files changed

+15
-19
lines changed

3 files changed

+15
-19
lines changed

14/umbraco-forms/developer/extending/setting-types.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,20 +46,18 @@ Some are defined with the Umbraco CMS and some ship with the Forms package.
4646
| Forms.PropertyEditorUi.StandardFieldMapper | Forms | Used to map system fields from a form to required aliases | The "Send to URL" workflow |
4747
| Forms.PropertyEditorUi.TextWithFieldPicker | Forms | Uses a single-line textbox/form field list for entry | Not used in core types |
4848

49-
All of the above setting types are used in one or more field, prevalue source and workflow types available with Umbraco Forms. For the less common ones, a usage has been indicated in the table.
49+
Most of the above setting types are used in one or more field, prevalue source and workflow types available with Umbraco Forms. For the less common ones, a usage has been indicated in the table.
5050

51-
The one exception is `Forms.PropertyEditorUi.TextWithFieldPicker`. This one we don't use within the package, but we make it available for developers to use when creating their own types.
51+
## Additional setting types
5252

53-
It offers the option of text field entry or the selection of a field from the form. This can be useful in workflows where you need to reference the value of a specific field.
53+
Some types we don't use within the package, but we make available for developers to use when creating their own types.
54+
55+
For example `Forms.PropertyEditorUi.TextWithFieldPicker`. This offers the option of text field entry or the selection of a field from the form. This can be useful in workflows where you need to reference the value of a specific field.
5456

5557
![Text with field picker](./images/text-with-field-picker.png)
5658

5759
## Creating a setting type
5860

59-
To create a custom setting type you will need an AngularJS view and controller in the following location: `/App_Plugins/MyPlugin/`.
60-
61-
{% hint style="info" %}
62-
Your plugin folder path must be outside of the `/App_Plugins/UmbracoForms/` folder if you use a custom Angular controller and Package.manifest.
63-
{% endhint %}
61+
It's also possible to define your own setting type using a combination of server and client-side code.
6462

65-
You then add the name of the view as the `View` property on the `Setting` attribute defined on the type.
63+
Read how do this in the article on [adding a custom field type](./adding-a-fieldtype.md#field-settings).

15/umbraco-forms/developer/extending/adding-a-fieldtype.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,7 @@ All setting properties for the Forms provider types are marked as `virtual`, so
162162

163163
## Umbraco Backoffice Components
164164

165-
With Forms 14, aspects of the presentation and functionality of the custom field are handled by client-side components, registered via manifests:
165+
With Forms 14+, aspects of the presentation and functionality of the custom field are handled by client-side components, registered via manifests:
166166

167167
* The preview, displayed on the form definition editor.
168168
* The property editor UI used for editing the the submitted values via the backoffice.

15/umbraco-forms/developer/extending/setting-types.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,20 +46,18 @@ Some are defined with the Umbraco CMS and some ship with the Forms package.
4646
| Forms.PropertyEditorUi.StandardFieldMapper | Forms | Used to map system fields from a form to required aliases | The "Send to URL" workflow |
4747
| Forms.PropertyEditorUi.TextWithFieldPicker | Forms | Uses a single-line textbox/form field list for entry | Not used in core types |
4848

49-
All of the above setting types are used in one or more field, prevalue source and workflow types available with Umbraco Forms. For the less common ones, a usage has been indicated in the table.
49+
Most of the above setting types are used in one or more field, prevalue source and workflow types available with Umbraco Forms. For the less common ones, a usage has been indicated in the table.
5050

51-
The one exception is `Forms.PropertyEditorUi.TextWithFieldPicker`. This one we don't use within the package, but we make it available for developers to use when creating their own types.
51+
## Additional setting types
5252

53-
It offers the option of text field entry or the selection of a field from the form. This can be useful in workflows where you need to reference the value of a specific field.
53+
Some types we don't use within the package, but we make available for developers to use when creating their own types.
54+
55+
For example `Forms.PropertyEditorUi.TextWithFieldPicker`. This offers the option of text field entry or the selection of a field from the form. This can be useful in workflows where you need to reference the value of a specific field.
5456

5557
![Text with field picker](./images/text-with-field-picker.png)
5658

5759
## Creating a setting type
5860

59-
To create a custom setting type you will need an AngularJS view and controller in the following location: `/App_Plugins/MyPlugin/`.
60-
61-
{% hint style="info" %}
62-
Your plugin folder path must be outside of the `/App_Plugins/UmbracoForms/` folder if you use a custom Angular controller and Package.manifest.
63-
{% endhint %}
61+
It's also possible to define your own setting type using a combination of server and client-side code.
6462

65-
You then add the name of the view as the `View` property on the `Setting` attribute defined on the type.
63+
Read how do this in the article on [adding a field type](./adding-a-fieldtype.md#field-settings).

0 commit comments

Comments
 (0)