[72005] New Administration for User Custom Fields and Custom Field Sections

[dfriquet]

Ticket

https://community.openproject.org/wp/72005

What are you trying to accomplish?

• For this, Administrators need to manage the layout of the user form
  • The user custom field management is moved as a menu item in the Users & Permissions section in the administration
  • "User custom fields" are renamed "User attributes" to match project attributes
  • User attributes are grouped into sections
  • Additionally to the custom fields, the built-in fields (first name, last name, email, department, etc) are listed there as well and can be re-arranged in the form.
• When editing or showing the user profile, the data/form is displayed as configured by the admin
• A user custom field also gets a boolean if that info should be shown in the user information card. If this is checked, the custom field is also shown whenever user details are displayed (see Figma for details)
• Hierarchy custom fields are also available for user custom fields
• For user custom fields, a new boolean setting is added, that defines if the field should be shown n the user information card
• User information card should include all custom fields that are marked to be shown there.

Screenshots

What approach did you choose and why?

• The first commit made the move from the flat-list user custom fields administration to user attributes within sections:
  • For the most parts a copy-paste from "Project attributes";
  • New admin area — dedicated UserCustomFieldsController + UserCustomFieldSectionsController with a new "User attributes" entry in the "Users & Permissions" menu;
  • UserCustomFieldSection model — new STI subclass of CustomFieldSection with full Create/Update/Delete service and contract layer;
  • Data migration: creates one untitled default UserCustomFieldSection and bulk-assigns all existing orphaned UserCustomField records to it;
  • Shared code: three small targeted edit to handle UserCustomField alongside ProjectCustomField.
• The second commit fixes a bug in the "Project attributes" found while working on the "User attributes";
• The third commit groups the input fields by section in the user form and profile.

Merge checklist

• Added/updated tests
• Added/updated documentation in Lookbook (patterns, previews, etc)
• Tested major browsers (Chrome, Firefox, Edge, ...)