Tidy up Settings UI

Created on 27 August 2023, about 1 year ago
Updated 7 September 2023, about 1 year ago

Problem/Motivation

The settings UI has been added to over time, gaining more settings and complexity all written in different styles with different expectations of knowledge. Going from never having installed the module before, the learning curve is quite steep, and the settings are not particularly clear on when and where they apply.

There are situations where this module is not involved in the generation of passwords, and those situations are not clearly stated, giving the impression that it is always used to generate a password. Drupal Core DefaultPasswordGenerator is actually used in any situation where the password field is not included in the form itself, which is only known by looking at the $form array contents.

Steps to reproduce

Install the module and navigate to Configuration -> People -> Account Settings

Proposed resolution

Re-organise, re-group and re-word all of the settings used by this module to explain how to use it no matter the experience level.

Remaining tasks

  • ✅ File an issue
  • ➖ Addition/Change/Update/Fix
  • ➖ Testing to ensure no regression
  • ➖ Automated unit testing coverage
  • ➖ UX/UI designer responsibilities
  • ➖ Readability
  • ➖ Accessibility
  • ➖ Documentation
  • ➖ Code review by maintainers
  • ➖ Full testing and approval
  • ➖ Credit contributors

User interface changes

  • Create additional groups for Genpass settings
  • Add clarifying information to each group
  • Homogenise all of the settings names
  • Clarify each of the settings by providing extensive details about what it does
  • Add explanatory labels to every schema defined setting

API changes

  • N/A

Data model changes

  • No settings machine names are to be changed.

Release notes snippet

  • Include as part of 2.0.0 release.

ISSUE FORKS ARE WRECKED. DO NOT USE. Sorry.

📌 Task
Status

Fixed

Version

2.0

Component

User interface

Created by

🇦🇺Australia elc

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.71.5 2024