#108936LocalizationWizard Refactoring
Description
Initial Situation
The current LocalizationWizard contains not only business-specific logic but also generic functionality for controlling the wizard workflow. This implementation is tightly coupled to the concrete use case and cannot be reused by other wizards.
Objective
The goal of the refactoring is to create a reusable base implementation for wizards. A generic abstract base class should be extracted from the existing LocalizationWizard, providing common functionality that can be reused by other wizard implementations.
Proposed Solution
As part of the refactoring, a new generic component will be introduced. This component will be responsible for:
- General logic for handling wizard configuration/steps
- Management and control of individual wizard steps
- Unified display and update of progress information
- Provision of generic methods for navigation and status management
- This base class will serve as a common technical foundation for future wizards.
Configuration-from-Outside via Wrapper
const steps = [new ModeStep(context), new NameStep(context)]
return `html
<typo3-backend-wizard .steps=${steps}></typo3-backend-wizard>
`;
✅ Pros
- Any component using a wizard can provide different steps without creating a new subclass.
- Easier to maintain/more robust as there are no child classes which might break on changes
❌ Cons
- May appear more complex due to the nesting of components.
- API more complex: Devs must understand the steps configuration
=> better maintainability
Next Steps
In a subsequent step, the new generic wizard implementation should replace the existing wizard used in the form extension.
Currently, this implementation still relies on the Bootstrap Carousel component for step navigation.
As part of the migration to the new base implementation, the Bootstrap Carousel will be removed entirely and replaced by the unified wizard logic.
In order for this to work with the FormWizard, reactive behavior must also be added for the Next button. Currently, the evaluation of whether a step is valid
only takes place during the initial rendering.
This will ensure a consistent technical foundation for all wizards and eliminate the dependency on outdated UI components.
Expected Benefits
- Increased code reusability
- Consistent architecture for all wizards
- Reduction of code duplication
- Improved maintainability and extensibility
- Clear separation between generic and domain-specific logic
Result
After completion of the refactoring, a robust and generic wizard base implementation will be available, which can be used by any other wizards. The LocalizationWizard will be simplified and reduced to its specific functionality, resulting in a cleaner and more maintainable structure.
Reviews 1
Subtasks 1
History 433
Show 28 earlier messages
-
Tobias Wojtylak changed description <span data-processor="relativetime" data-value="2026-02-12T13:34:06+00:00" > 02/12/26, 13:34 </span>
-
Gerrit Code Review pushed patch set 2 for main to change 92821 status
NewUnder Review <span data-processor="relativetime" data-value="2026-02-12T13:43:14+00:00" > 02/12/26, 13:43 </span> -
Tobias Wojtylak changed subtask #108968 <span data-processor="relativetime" data-value="2026-02-12T16:34:20+00:00" > 02/12/26, 16:34 </span>
-
Gerrit Code Review pushed patch set 3 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T14:29:41+00:00" > 02/16/26, 14:29 </span>
-
Gerrit Code Review pushed patch set 4 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T14:48:32+00:00" > 02/16/26, 14:48 </span>
-
Gerrit Code Review pushed patch set 5 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T14:55:57+00:00" > 02/16/26, 14:55 </span>
-
Gerrit Code Review pushed patch set 6 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T15:11:33+00:00" > 02/16/26, 15:11 </span>
-
Gerrit Code Review pushed patch set 7 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T15:30:56+00:00" > 02/16/26, 15:30 </span>
-
Gerrit Code Review pushed patch set 8 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-16T15:50:07+00:00" > 02/16/26, 15:50 </span>
-
Gerrit Code Review pushed patch set 9 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T08:14:57+00:00" > 02/17/26, 08:14 </span>
-
Gerrit Code Review pushed patch set 10 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T10:39:24+00:00" > 02/17/26, 10:39 </span>
-
Gerrit Code Review pushed patch set 11 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T10:51:47+00:00" > 02/17/26, 10:51 </span>
-
Gerrit Code Review pushed patch set 12 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:00:00+00:00" > 02/17/26, 11:00 </span>
-
Gerrit Code Review pushed patch set 13 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:04:01+00:00" > 02/17/26, 11:04 </span>
-
Gerrit Code Review pushed patch set 14 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:09:28+00:00" > 02/17/26, 11:09 </span>
-
Gerrit Code Review pushed patch set 15 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:13:38+00:00" > 02/17/26, 11:13 </span>
-
Gerrit Code Review pushed patch set 16 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:17:08+00:00" > 02/17/26, 11:17 </span>
-
Gerrit Code Review pushed patch set 17 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:42:47+00:00" > 02/17/26, 11:42 </span>
-
Gerrit Code Review pushed patch set 18 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T11:57:12+00:00" > 02/17/26, 11:57 </span>
-
Gerrit Code Review pushed patch set 19 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T13:17:26+00:00" > 02/17/26, 13:17 </span>
-
Gerrit Code Review pushed patch set 20 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T13:21:08+00:00" > 02/17/26, 13:21 </span>
-
Gerrit Code Review pushed patch set 21 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-17T13:22:18+00:00" > 02/17/26, 13:22 </span>
-
Gerrit Code Review pushed patch set 22 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-18T10:06:53+00:00" > 02/18/26, 10:06 </span>
-
Gerrit Code Review pushed patch set 23 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-18T11:56:38+00:00" > 02/18/26, 11:56 </span>
-
Gerrit Code Review pushed patch set 24 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-18T13:40:54+00:00" > 02/18/26, 13:40 </span>
-
Gerrit Code Review pushed patch set 25 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-19T09:02:23+00:00" > 02/19/26, 09:02 </span>
-
Gerrit Code Review pushed patch set 26 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-19T14:43:20+00:00" > 02/19/26, 14:43 </span>
-
Gerrit Code Review pushed patch set 27 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-20T11:16:11+00:00" > 02/20/26, 11:16 </span>
-
Gerrit Code Review pushed patch set 28 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-20T11:17:32+00:00" > 02/20/26, 11:17 </span>
-
Gerrit Code Review pushed patch set 29 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-20T11:20:46+00:00" > 02/20/26, 11:20 </span>
-
Gerrit Code Review pushed patch set 30 for main to change 92821 <span data-processor="relativetime" data-value="2026-02-20T12:41:10+00:00" > 02/20/26, 12:41 </span>
-
Tobias Wojtylak commented and changed status
Under ReviewResolved done0 %100 % <span data-processor="relativetime" data-value="2026-02-20T16:25:10+00:00" > 02/20/26, 16:25 </span> -
Benni Mack changed status
ResolvedClosed <span data-processor="relativetime" data-value="2026-03-31T08:10:57+00:00" > 03/31/26, 08:10 </span>
Applied in changeset commit:414789aea6f6e3a503d91908a7672fb0aa7c812d.