Feature Wiki
Tabs
Recurrence Form to Kitchensink
Page Overview
[Hide]- 1 Initial Problem
- 2 Conceptual Summary
- 3 User Interface Modifications
- 4 Additional Information
- 4.1 Involved Authorities
- 4.2 Technical Aspects
- 4.3 Privacy
- 4.4 Security
- 4.5 Contact
- 4.6 Funding
- 5 Discussion
- 6 Implementation
- 6.1 Description and Screenshots
- 6.2 Test Cases
- 6.3 Privacy
- 6.4 Approval
1 Initial Problem
Creating recurring appointments uses unique interface elements. The current implementation cannot trivially be replaced by KS-Inputs. The current form needs some re-arranging to fit the KS-Elements available in 11.
2 Conceptual Summary
Adding recurring appointments is moved to KS by splitting up the previously dynamically changing input elements over radio groups. See below for details.
3 User Interface Modifications
3.1 List of Affected Views
- Personal Workspace > Calendar > Agenda > Create Appointment
3.2 User Interface Details
Apart from the recurrence input, most of the appointment creation form can be moved to the KS as is. The only other significant difference is that 'Full Day Appointment' is not a dynamical toggle anymore. Instead it is realized via radio buttons leading to duration inputs with and without time, respectively.
Defaults are kept as they are currently: 'All Day Event' is selected, and the current data (and time) is pre-filled in both duration inputs.
Six different ways to set recurrences are offered:
- Daily: e.g. every four days
- Weekly: e.g. every third Wednesday
- Monthly by Day: e.g. the first Friday every second month
- Monthly by Date: e.g. on the 19th of every third month
- Yearly by Day: e.g. on the last Tuesday of March every second year
- Yearly by Date: e.g. on the 31st of October every third year
Each option contains a different combination of five different inputs as appropriate (see below).
'Every x Day(s)/Month(s)/Year(s)' are numerical inputs that accept only positive numbers. 'Month' is a dropdown of all months in the year, and 'Day' a multi-select of all days. 'Day of the Month' is a numerical input accepting all numbers between 1 and 31. Lastly, 'Week' is a dropdown consisting of 'First' through 'Fifth' and 'Last'.
'Recurrence End' is always offered in the form, but only has an effect if a recurrence was selected.
'Fixed Number of Occurences' offers a numeric input (negative numbers or 0 are excluded), and 'Repeat Until End Date' offers a date input.
3.3 New User Interface Concepts
No new KS elements.
3.4 Accessibility Implications
No issues forseeable.
4 Additional Information
4.1 Involved Authorities
- Authority to Sign off on Conceptual Changes: Meyer, Stefan [smeyer]
- Authority to Sign off Code Changes: Meyer, Stefan [smeyer]
If this request is related to multiple components, please list both authorities for all related components.
4.2 Technical Aspects
While this feature only concerns forms in Calendar, the KS recurrence input section will be made available to other components.
4.3 Privacy
No privacy implications.
4.4 Security
No foreseeable security implications.
4.5 Contact
Person to be contacted in case of questions about the feature or for funding offers: Schmitz, Tim [tschmitz]
4.6 Funding
Funding status and funding parties are listed in the block 'Status of Feature' in the right column of this page.
If you are interested to give funding for this feature, please get into contact with the person mentioned above as 'Contact'.
5 Discussion
Kunkel, Matthias [mkunkel], 30 JUN 2025: Thanks for this feature request. Two questions:
- The current implementation has a default entry when creating a new event. It is today and an 'All Day Event'. Will you keep that? Or will the inputs be empty?
- And if they are empty and I enter a date for an 'All Day Event', will the end date be autocompleted (same day, like now)? Or do I need to add the date twice? Same with 'Date/Time' – is there an autocomplete for the end time, e.g. two hours after start?
Schmitz, Tim [tschmitz], 03 JUL 2025:
- Keeping the defaults as they are currently definitely makes sense, I'll add that to the article. Probably would be better then to put the 'All Day Event' radio on top.
- There is currently no such autocomplete implemented for the KS duration input, and we don't plan to do so with this feature. Both dates have to be entered manually.
JourFixe, ILIAS [jourfixe], 07 JUL 2025: We highly appreciate this suggestion and accept the feature for trunk. Please add a short notice to the byline of the 'end date' input to clarify if this end date is the last possible recurrence date or the first one after the recurrences. And adding the info about the technical availability of the feature to chap 4.2 would be great.
JourFixe, ILIAS [jourfixe]: We accept the suggested exception for nesting two radio inputs for this feature request.
6 Implementation
Feature has been implemented by Schmitz, Tim [tschmitz]
6.1 Description and Screenshots
Mostly implemented as described above. As described below in Approval, appointments are mostly not created as full day appointments, so the more important option was moved to the top slot. Further, the default when clicking the 'Create Appointment' button is now 'Date and Time', with the current hour pre-filled as the start time (and the end time set to one hour later).
Additionally, as decided on 4 AUG 2025 in the JF, the 'Recurrence End' input was moved into the radio groups of the individual recurrences (except for 'No Recurrence'). This way, 'Recurrence End' is only offered when it is relevant.
6.2 Test Cases
Test cases completed at {date} by {user}
- {Test case number linked to Testrail} : {test case title}
6.3 Privacy
no change required
6.4 Approval
Approved at 07/23/2025 by Solzbacher, Bettina [BettinaSolzbacher].
Schmitz, Tim [tschmitz], 5 AUG 2025: Note that both issues have been taken care of in the meantime, see implementation.
During the approval process, two issues were noted that urgently require revision.
The initial setting for creating an appointment is set to all day.
This confuses users, as they typically want to create a single appointment (date and time). It's rare for them to regularly create all-day appointments. In addition, creating a single appointment requires an additional click.
It would be much better here if the date and time were selected as the initial setting, thus swapping the order.
This forces users to actively select an all-day appointment.
For recurring appointments, nonsensical values can be selected because the concept doesn't provide any options.
Under the first option, "No Recurrences," the Recurrence End can still be selected (as shown above). This is nonsensical, as this cannot be the case with the selected option. This can lead to problems (even if ignored programmatically) for the user to enter a value without first specifying the type of repetition. This can lead to user-input errors.
We propose a checkbox option to enable repetitions.
However, this is conceptually excluded, so there should be no radio buttons with subgroups within them.
The concept should define this as a legitimate exception, otherwise input fields would be displayed which have no relevance to the result.
Last edited: 5. Aug 2025, 10:34, Schmitz, Tim [tschmitz]