Skip to content

Commit 7073c0a

Browse files
MariaAnfgitbook-bot
authored andcommitted
GITBOOK-3597: No subject
1 parent 0d269f9 commit 7073c0a

File tree

3 files changed

+59
-10
lines changed

3 files changed

+59
-10
lines changed

SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -413,7 +413,7 @@
413413
* [Components](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/components.md)
414414
* [Rules](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/rules.md)
415415
* [Versioning](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/versioning.md)
416-
* [Form customisation](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/form-customisation.md)
416+
* [Form customisation in Theme Editor](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/form-customisation.md)
417417
* [Form signature](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/form-signature.md)
418418
* [How-to guides](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/how-to-guides/README.md)
419419
* [How to: populate forms with data](modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/how-to-guides/how-to.md)

modules-1/aidbox-forms/aidbox-ui-builder-alpha/form-creation/form-customisation.md

Lines changed: 50 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,59 @@ description: >-
44
guidelines
55
---
66

7-
# Form customisation
7+
# Form customisation in Theme Editor
88

9-
### Theming
9+
## Theme Editor
1010

11-
You can choose ready-made themes from the UI Builder interface or create your own. 
11+
The Theme Editor allows you to customize the appearance of your forms by applying pre-designed themes or creating your own.
1212

13-
For now, the option to create your own custom themes is available through the configuration project. Go to this[ page](../../aidbox-code-editor/how-to-customize-form-appearance.md) for implementation details.
13+
### **Accessing the Theme Editor:**
14+
15+
In the UI Form Builder, the toolbar at the top contains a **palette** icon. Clicking on this icon opens the Theme Editor, where you can either select a ready-made theme for your form or create a new one.
16+
17+
When selecting or creating a theme, you can instantly preview how your form will look with the applied theme.
18+
19+
### **Theme Storage and Reusability:**
20+
21+
Themes are stored in the database in a custom resource called **QuestionnaireTheme**. This setup allows flexibility in form design:
22+
23+
* You can apply the same theme to multiple forms.
24+
* You can use different themes with the same form without needing to duplicate the form. This is particularly useful if you want to provide tailored designs for different clients. Simply create one form and assign a set of themes based on client needs.
25+
26+
### **How to Use a Theme:**
27+
28+
* You can set a **default theme** in the configuration, and it will be applied to all forms. More details can be found [here](../configuration.md).
29+
* You can also pass a theme as a **parameter** when generating a link to a specific form. More details can be found [here](../../../../reference/aidbox-forms/aidbox-sdc-api.md#parameters).
30+
31+
### **How to Create a New Theme:**
32+
33+
To create a new theme, select the **Add New Theme** option. This opens the theme editor, which consists of the following sections:
34+
35+
1. **General Settings:**
36+
* **Theme Name:** Assign a name to your theme.
37+
* **Default Language:** Set the default language if you’re creating a theme for multilingual forms. When a language is selected, an additional **translation** icon will appear. Clicking on this icon opens a separate window where you can provide translations for the buttons used on the multilingual form.
38+
2. **Colors:**
39+
40+
In this section, you can customize the color scheme of your form:
41+
42+
* **Primary Color:** The main color used across the form.
43+
* **Page Color:** The background color for the page where the form is displayed.
44+
* **Form Color:** The background color for the form itself.
45+
* **Toolbar Color:** The color for the form's toolbar.
46+
47+
48+
3. **Brand Image:**
49+
50+
You can add a brand image to your form in two possible locations:
51+
52+
* **Top-right corner** of the form.
53+
* **Bottom-left corner** of the form.
54+
55+
To include the image, provide a publicly available URL for the image file.
56+
4. **Inputs**
57+
5. **Buttons**
58+
59+
After creating the theme, you need to click the save button.
1460

15-
### Disable SDC operations
1661

17-
In case you have conflicts with your own implementation, you can easily disable SDC operations by setting environment variable:
1862

19-
```
20-
AIDBOX_SDC_ENABLED=false
21-
```

modules-1/aidbox-forms/getting-started.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -112,3 +112,11 @@ Learn more about Audit logs:
112112
{% content-ref url="../audit/" %}
113113
[audit](../audit/)
114114
{% endcontent-ref %}
115+
116+
## Disable SDC operations
117+
118+
In case you have conflicts with your own implementation, you can easily disable SDC operations by setting environment variable:
119+
120+
```
121+
AIDBOX_SDC_ENABLED=false
122+
```

0 commit comments

Comments
 (0)