✨ Voting Booth: Security confirmation checkbox support

[markgrafd]

Preflight checklist

• I could not find a solution in the existing issues, docs, nor discussions.

Suggestion

Our customers request a verification under oath or a security confirmation before the ballot can be filled out. The check mark should activate the "Start voting" button.

Text: I hereby certify that I have read and understood the instructions for voting, and I affirm to the election administration in lieu of oath that I personally fill out the ballot or that I mark the ballot as an auxiliary person in accordance with the will of the voter.

Suggested Implementation

The addition of the following election level fields:

• mandatory_acceptance_tos_html containing the basic-html text to be displayed.
• mandatory_acceptance_tos_html_i18n to support translations of the previous field.

If mandatory_acceptance_tos_html is set, then a checkbox will appear containing the configured text, and the Start votingbutton will be disabled unless that checkbox is checked.

Important: Please note that in this suggested implementation this checkbox is implemented in the javascript client of the voting booth. This means that the fact that the voter clicked in this checkbox is not reflected in any manner to the data received in the backend from the voter.

Implementation details

This is how it looks when set:

And when checkbox checked:

In mobile:

Additionally, the text supports basic html and translations using the mandatory_acceptance_tos_html_i18n parameter.

Tasks

Tasks

Beta Give feedback

1. suggested-implementation: identify requirements and produce a suggested implementation
2. client-approval: Receive client approval for the suggested implementation
3. implementation: Develop the suggested implementation
4. documentation repo: Write the documentation related to the suggested implementation
5. final-client-approval-request: document the actual implementation and request final implementation approval
6. final-client-approval: obtain final implementation approval

Master PRs

Beta Give feedback

1. ✨ Voting Booth: Security confirmation checkbox support documentation#140
   enhancement +1
2. ✨ Security confirmation (#181) ballot-box#184
   enhancement +1
3. ✨ Security confirmation (#411) voting-booth#417
   enhancement +1
4. ✨ Voting Booth: Security confirmation checkbox support (#370) common-ui#372
   enhancement +1

Stable PRs

Beta Give feedback

1. ✨ Security confirmation ballot-box#181
   enhancement +1
2. ✨ Security confirmation voting-booth#411
   enhancement +1
3. ✨ Voting Booth: Security confirmation checkbox support common-ui#370
   enhancement +1

Additional context

No response

[ElectricPaperInformationssystemeGmbH]

Logical check would be ok

[edulix]

@ElectricPaperInformationssystemeGmbH please review implementation details and confirm approval or request changes or any other information

[ElectricPaperInformationssystemeGmbH]

@edulix strange border is around the check box

[ElectricPaperInformationssystemeGmbH]

@edulix button mouse hover and click effect (shadow) is there if the check box deactivated

[ElectricPaperInformationssystemeGmbH]

@edulix one line text not in the middle

[edulix]

I've fixed the issues.

This is how the text looks when it's small (one line) and the checkbox is unchecked:

This how it looks when the text is multiline and checkbox is checked:

This is the highlight and mouse-hover process. Doesn't have a mouse-over shadow when the button is disabled, and when clicked and disabled it highlights the mandatory security checkbox elements (input + text) in red:

Screen.Recording.2023-11-16.at.06.08.05.mov

[ElectricPaperInformationssystemeGmbH]

looks good, thank you