You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: proposed/form-admin-meta.md
+25-16Lines changed: 25 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,42 +2,51 @@
2
2
3
3
## 1. Summary
4
4
5
-
Joomla uses forms based on XML and rendered with the help of the Form class.
5
+
Joomla uses forms that are defined in XML and rendered using the Form class.
6
6
7
-
While this is a flexible way and the forms can be changed with plugins, it is limited and in some way hard coded. Database constraints are implemented through business logic within the models and not on the database level.
8
-
9
-
This specification aims to define an extension of the form building process. After implementation it allows site builder the change the core forms. Adding and removing fields should be possible and core form building and custom fields are merged.
7
+
Although this is a flexible way and the forms can be changed using plugins, it is limited and hard-coded in some ways.
8
+
9
+
This specification aims to define an extension to the form creation process. This form editor shall allow modifying
10
+
forms, add or remove predefined fields and custom fields and change their order.
10
11
11
12
## 2. Why Bother?
12
13
13
-
Hard coded forms are not state of the art. Joomla! allows today a lot of flexibility but it is up to developers to implement. If we can change the way we are creating forms we would allow site builders to change Joomla that it fulfils the needs of clients better.
14
+
Hard-coded forms are no longer state of the art. Joomla today offers a lot of flexibility, but it needs developers to
15
+
implement changes. If we can change the way we create forms, we would allow website creators to adapt Joomla to better
16
+
meet users' needs.
14
17
15
18
## 3. Scope
16
19
17
-
Planned feature for Joomla5.
18
-
19
20
### 3.1 Goals
20
21
21
-
Having a core component that allows configuration of forms and views. This includes custom fields and a migration from Joomla4.
22
+
The goal is to provide a graphical user interface for creating and editing forms and views as a core component. Standard
23
+
fields and user-defined fields are to be equally supported.
22
24
23
-
Respect versioning for custom fields.
25
+
When saved, user-defined fields must be included in versioning, provided the underlying table supports versioning.
24
26
25
-
Creating a API for 3rd part components to use the functionality.
27
+
The functionality shall also be available for extensions.
28
+
29
+
In the course of the
30
+
implementation, [accessibility requirements and recommendations](https://accessibilitycluster.com/main-results/forms-editor)
31
+
should be taken into account for the form renderer.
26
32
27
33
### 3.2 Non-Goals
28
34
29
-
Migration of 3rd part components to the new way of form rendering.
35
+
It is not the goal of this component to force changes to 3rd party extensions.
30
36
31
37
## 4. Approaches
32
38
39
+
The component will consist of a Visual Editor and a Form Preprocessor. The preprocessor splits the form content so that
40
+
the handler of the original form gets the data it expects and ensures the correct handling of the remaining form
41
+
content.
42
+
43
+
Database constraints are implemented through business logic within the models and not at the database level. In the
44
+
course of revising the database, this should be corrected if possible.
0 commit comments