Skip to content

Commit 1df1ee1

Browse files
eshanrnhgitbook-bot
eshanrnh
authored and
gitbook-bot
committed
GITBOOK-3: Fixed broken links
1 parent 9ed8db2 commit 1df1ee1

File tree

6 files changed

+107
-108
lines changed

6 files changed

+107
-108
lines changed

‎15/umbraco-forms/README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ description: >-
1010
This is the documentation for the **Umbraco Forms 15 Release Candidate**.
1111

1212
This version of the Umbraco Forms documentation is currently slimmed down to contain only new and updated material related to the upcoming release.
13+
14+
:bangbang: Due to the above, some links might reference the GitHub file instead of the GitBook article.
1315
{% endhint %}
1416

1517
Umbraco Forms is a tool that lets you build forms of all shapes and sizes and put them on your Umbraco websites. Build forms using a long list of elements like multiple choice, dropdowns, text areas and checkboxes. Choose between a series of different workflow and control what happens once a form has been submitted.

‎15/umbraco-forms/SUMMARY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@
6565
* [Apply keys and indexes for forms in the database](developer/healthchecks/forms-in-the-database-apply-keys.md)
6666
* [Localization](developer/localization.md)
6767
* [Headless/AJAX Forms](developer/ajaxforms.md)
68-
* [Block List Labels](developer/blocklistfilters.md)
68+
* [Block List Labels](developer/block-list-labels.md)
6969
* [Field Types](developer/field-types.md)
7070
* [Storing Prevalue Text Files With IPreValueTextFileStorage](developer/iprevaluetextfilestorage.md)
7171

‎15/umbraco-forms/developer/block-list-labels.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Block List Labels
2+

‎15/umbraco-forms/developer/configuration/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -224,7 +224,7 @@ Here an organization-approved reCAPTCHA score threshold is defined, that can't b
224224
}
225225
```
226226

227-
In order to configure this setting, you will need to know the GUID or alias for the type and the property name for each setting. You can find [these values for the built-in Forms types here](type-details.md).
227+
In order to configure this setting, you will need to know the GUID or alias for the type and the property name for each setting. You can find [these values for the built-in Forms types her](type-details.md)e.
228228

229229
Take care to not hide any settings that are required for the particular field or workflow type (for example, the `Subject` field for email workflows). If you do that, the item will fail validation when an editor tries to create it.
230230

@@ -414,7 +414,7 @@ If recording IPs and your site is behind a proxy, load balancer or CDN, we recom
414414

415415
In Forms 12.1 amends were made to the default theme for Forms that improved accessibility. Specifically we provide the option to use alternative markup for rendering checkbox and radio button lists. These use the more semantically correct `fieldset` and `legend` elements, instead of the previously used `div` and `label`.
416416

417-
Although this semantic markup is preferred, it could be a presentational breaking change for those styling the default theme. As such we have made this markup improvement optional. You can opt into using it by setting this configuration value to `true`.
417+
Although this semantic markup is preferred, it could be a presentational breaking change for those styling the default theme. As such we have made this markup improvement optional. You can opt into using it by setting this configuration value to `true`.
418418

419419
In Umbraco 13 this configuration option will be removed and the semantic rendering made the only option.
420420

@@ -434,7 +434,7 @@ If you would like to enable this feature, you can set the value of this setting
434434

435435
## TrackRenderedFormsStorageMethod
436436

437-
Forms tracks the forms rendered on a page in order that the associated scripts can be placed in a different location within the HTML. Usually this is used to [render the scripts](../rendering-scripts.md)) at the bottom of the page.
437+
Forms tracks the forms rendered on a page in order that the associated scripts can be placed in a different location within the HTML. Usually this is used to [render the scripts](../rendering-scripts.md) at the bottom of the page.
438438

439439
By default, `HttpContext.Items` is used as the storage mechanism for this tracking.
440440

‎15/umbraco-forms/tutorials/creating-a-contact-form.md‎

Lines changed: 59 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,16 @@ To create a Composition, follow these steps:
2323
1. Go to **Settings** in the Umbraco Backoffice.
2424
2. Expand the **Document Types** folder in the **Settings** tree.
2525
3. Select **...** next to the **Compositions** folder.
26-
4. Click **Create**.
26+
4. Click **Create**.
2727
5. Select **Document Type**.
2828
6. Enter a **Name** for the **Composition**- let's call it _Title Box_.
29-
7. Add the following fields with the respective specifications:
29+
7. Add the following fields with the respective specifications:
3030

3131
| Group | Field Name | Alias | Data Type |
32-
|-----------|------------|----------|------------|
32+
| --------- | ---------- | -------- | ---------- |
3333
| Title Box | Title | title | Textstring |
3434
| Title Box | Subtitle | subtitle | Textarea |
35-
36-
8. Click **Save** to save the Composition.
35+
8. Click **Save** to save the Composition.
3736

3837
![Add Composition Properties](images/composition-properties-v14.png)
3938

@@ -46,18 +45,17 @@ To create a **Contact Us** Document Type, follow these steps:
4645
1. Go to **Settings** in the Umbraco Backoffice.
4746
2. Select **...** next to the **Document Types** folder.
4847
3. Click **Create**.
49-
4. Select **Document Type with Template**.
48+
4. Select **Document Type with Template**.
5049
5. Enter a **Name** for the **Document Type**- let's call it _Contact Us_.
5150
6. Select **Compositions** in the top-right corner.
5251
7. Select **Title Box**.
5352
8. Click **Submit**.
54-
9. Add the following fields with the respective specifications:
53+
9. Add the following fields with the respective specifications:
5554

5655
| Group | Field Name | Alias | Data Type |
57-
|---------|--------------|-------------|-----------------|
56+
| ------- | ------------ | ----------- | --------------- |
5857
| Form | Contact Form | contactForm | Form Picker |
5958
| Content | Body Text | bodyText | Richtext Editor |
60-
6159
10. Click **Save**.
6260

6361
![Contact Us Document Type Properties](images/contact-us-doc-type-properties-v14.png)
@@ -71,10 +69,9 @@ To update the **Contact Us** Document Type permissions, follow these steps:
7169
1. Navigate to the Document Type used for the root content node on your website, in this case **Home** page.
7270
2. Go to the **Structure** tab.
7371
3. Select **Choose** in the **Allowed child node types** section.
74-
4. Select the **Contact Us** page.
72+
4. Select the **Contact Us** page.
7573

7674
![Update Home Page Document Type Properties](images/update-doc-type-permissions-v14.png)
77-
7875
5. Click **Choose**.
7976
6. Click **Save**.
8077

@@ -89,10 +86,9 @@ To add the content node, follow these steps:
8986
3. Click **Create**.
9087
4. Select **Contact Us**.
9188
5. Enter the name for the content node. let's call it _Contact Us_.
92-
6. Enter a **Title**, **Subtitle**, and **Body Text** value. These can always be updated at a later point.
89+
6. Enter a **Title**, **Subtitle**, and **Body Text** value. These can always be updated at a later point.
9390

9491
![Enter values in Contact Us Content node](images/fill-contact-us-node-v14.png)
95-
9692
7. Click **Save** or **Save and Publish**.
9793

9894
## Step 3: Creating the Contact Form
@@ -106,41 +102,39 @@ To create a form, follow these steps:
106102
3. Click Create.
107103
4. Select **New Form...**.
108104
5. Enter a **Name** for the Form. Let's call it _Contact Us_.
109-
6. _[Optional]_ Enter a **Page Name** and **Group Name** for the Data Consent statement. Let's call it _Data Consent_.
105+
6. _\[Optional]_ Enter a **Page Name** and **Group Name** for the Data Consent statement. Let's call it _Data Consent_.
110106
7. Click **Add new group**. Let's call it _Information_.
111107
8. Select **Add Question** to add a new field.
112-
9. Enter the following details:
113-
114-
| Field Name | Value |
115-
| ------------------ | -------------------- |
116-
| Enter question | **Name** |
117-
| Alias | fullName |
118-
| Choose answer type | Short answer |
119-
| Field Type | text |
120-
| Mandatory | On |
121-
108+
9. Enter the following details:
109+
110+
| Field Name | Value |
111+
| ------------------ | ------------ |
112+
| Enter question | **Name** |
113+
| Alias | fullName |
114+
| Choose answer type | Short answer |
115+
| Field Type | text |
116+
| Mandatory | On |
122117
10. Click **Submit**.
123118
11. Repeat **steps 8-10** to add the following fields:
124119

125-
| Field Name | Value |
126-
| ------------------ | -------------------- |
127-
| Enter question | **Company Name** |
128-
| Choose answer type | Short answer |
120+
| Field Name | Value |
121+
| ------------------ | ---------------- |
122+
| Enter question | **Company Name** |
123+
| Choose answer type | Short answer |
129124

130-
| Field Name | Value |
131-
|--------------------|----------------------------|
125+
| Field Name | Value |
126+
| ------------------ | ------------------------------ |
132127
| Enter question | **How should we contact you?** |
133-
| Choose answer type | Single choice |
134-
| Prevalues Items | phone, email |
135-
| Mandatory | On |
136-
137-
| Field Name | Value |
138-
|--------------------|----------------------------|
139-
| Enter question | **Enter your phone number**|
140-
| Choose answer type | Short answer |
141-
| Field Type | tel |
142-
| Validation | Validate as a number |
143-
128+
| Choose answer type | Single choice |
129+
| Prevalues Items | phone, email |
130+
| Mandatory | On |
131+
132+
| Field Name | Value |
133+
| ------------------ | --------------------------- |
134+
| Enter question | **Enter your phone number** |
135+
| Choose answer type | Short answer |
136+
| Field Type | tel |
137+
| Validation | Validate as a number |
144138
12. Enable **Conditions** in the _Enter your phone number_ field.
145139
13. Click **Add Condition**.
146140
14. Select **How should we contact you?** from the dropwdown.
@@ -149,41 +143,39 @@ To create a form, follow these steps:
149143
17. Repeat **steps 8-10** to add the following field:
150144

151145
| Field Name | Value |
152-
|--------------------|------------------------------|
146+
| ------------------ | ---------------------------- |
153147
| Enter question | **Enter your email address** |
154148
| Choose answer type | Short answer |
155149
| Field Type | email |
156150
| Validation | Validate as an email address |
157-
158151
18. Enable **Conditions** in the _Enter your email address_ field.
159152
19. Click **Add Condition**.
160-
20. Select **How should we contact you?** from the dropwdown.
153+
20. Select **How should we contact you?** from the dropwdown.
161154
21. Select **email** in the value field.
162155
22. Click **Submit**.
163156
23. Repeat **steps 8-10** to add the following field:
164157

165158
| Field Name | Value |
166-
|--------------------|----------------------------------------------------------|
159+
| ------------------ | -------------------------------------------------------- |
167160
| Enter question | **What is your role?** |
168161
| Choose answer type | Dropdown |
169162
| Prevalues Items | manager, developer, tester, writer, marketing specialist |
170163

171-
| Field Name | Value |
172-
|--------------------------------|--------------------------|
173-
| Enter question | **Attachments (if any)** |
174-
| Choose answer type | File upload |
175-
| Predefined allowed file types | pdf, png, jpg, gif, txt |
164+
| Field Name | Value |
165+
| ----------------------------- | ------------------------ |
166+
| Enter question | **Attachments (if any)** |
167+
| Choose answer type | File upload |
168+
| Predefined allowed file types | pdf, png, jpg, gif, txt |
176169

177-
| Field Name | Value |
178-
|--------------------|---------------------|
179-
| Enter question | **Are you a Robot?**|
180-
| Choose answer type | reCAPTCHAv2 |
181-
| Theme | light |
182-
| Size | normal |
183-
| Mandatory | On |
170+
| Field Name | Value |
171+
| ------------------ | -------------------- |
172+
| Enter question | **Are you a Robot?** |
173+
| Choose answer type | reCAPTCHAv2 |
174+
| Theme | light |
175+
| Size | normal |
176+
| Mandatory | On |
184177

185178
![Add questions](images/contact-us-form-add-questions-v14.png)
186-
187179
24. Select the **Reorder** option.
188180
25. Drag the **Data consent** group below the **Information** group.
189181
26. Click **I am done reordering**.
@@ -231,10 +223,9 @@ To add the Contact Form to the Content Node, follow these steps:
231223
3. Select **Choose** in the **Contact Form** field.
232224
4. Select the **Insert Form with Theme** option.
233225
5. Select the **Contact Us** Form.
234-
6. Click **Choose**.
226+
6. Click **Choose**.
235227

236228
![Adding the Contact Us Form](images/select-form-v14.png)
237-
238229
7. Click **Save** or **Save and Publish**.
239230

240231
## Step 5: Additional configuration
@@ -245,7 +236,7 @@ In the next couple of steps, we will add some additional configuration required
245236

246237
You need to update the configuration to include a value in the `appsettings.json` file.
247238

248-
To configure the reCAPTCHA value, see the [reCAPTCHA configuration](../developer/configuration/README.md#recaptcha-v2-field-type-configuration) article.
239+
To configure the reCAPTCHA value, see the [reCAPTCHA configuration](../developer/configuration/#recaptcha-v2-field-type-configuration) article.
249240

250241
### Configuring Simple Mail Transfer Protocol (SMTP)
251242

@@ -261,16 +252,18 @@ To render the Contact Form, follow these steps:
261252

262253
1. Go to the **Settings** section in the Umbraco Backoffice.
263254
2. Open the **Contact Us** template in the **Templates** folder.
264-
3. Enter the following code to render the form:
255+
3. Enter the following code to render the form:
265256

266257
```cs
267258
@using Umbraco.Forms.Web.Helpers;
268259
@await Component.InvokeAsync("RenderForm", new { formId = Guid.Parse("<form guid>"), FormTheme = "bootstrap3-horizontal", ExcludeScripts = "1" })
269260
```
270261

271-
{% hint style="info" %}
272-
Replace **<form guid>** with the ID of your form. You can find the ID in the Form's **Info** tab.
273-
{% endhint %}
262+
{% hint style="info" %}
263+
```
264+
Replace **<form guid>** with the ID of your form. You can find the ID in the Form's **Info** tab.
265+
```
266+
{% endhint %}
274267
275268
4. Select **Insert**.
276269
5. Click **Value**.
@@ -282,7 +275,7 @@ To render the Contact Form, follow these steps:
282275
11. Click **Save**.
283276
284277
{% hint style="info" %}
285-
For Umbraco Forms to work correctly, you need to include some client dependencies. For more information, see the [Preparing Your Frontend](https://docs.umbraco.com/umbraco-forms/developer/prepping-frontend) article.
278+
For Umbraco Forms to work correctly, you need to include some client dependencies. For more information, see the [Preparing Your Frontend](../developer/prepping-frontend.md) article.
286279
{% endhint %}
287280
288281
## The final result

0 commit comments

Comments
 (0)