Related to issue #366950: "Administer Users" permission should be separate from "Administer Account Settings".
The permission titles for "administer users" and "administer user settings" are way too similar. They also don't have descriptions and may be confusing when viewed at the Permissions admin page. Verbose descriptions should be added to document the differences and help users.
Possible description texts are already suggested in this comment in the original issue.
There is a similar issue to this one, which may be helpful as a reference:
#1365234: Add description to "access content overview" permission
Opening issue currently in postponed state, awaiting the original issue to be commited.
Also is suggested to tag issue with "needs text review" and "needs usability review" to attract UX wisemen when set to active.
| Comment | File | Size | Author |
|---|---|---|---|
| #32 | 1813488-32.png | 31.78 KB | quietone |
| #32 | interdiff-1813488-28-32.txt | 804 bytes | quietone |
| #32 | user-clarify_permissions-1813488-32.patch | 996 bytes | quietone |
| #28 | user-clarify_permissions-1813488-28.patch | 993 bytes | gugalamaciek |
| #25 | 1813488-before.png | 22.63 KB | quietone |
Comments
Comment #1
tstoecklerOver in #366950-64: "Administer Users" permission should be separate from "Administer Account Settings" I proposed:
Administer users
Manage all user accounts. This includes editing all user information, including e-mail addresses and passwords, issuing e-mails to users and blocking and deleting user accounts.
Administer user settings
Manager user settings, such as the registration and cancellation methods, the text of user e-mails, and fields attached to users.
Comment #2
babruix commentedAttaching patch (currently includes permissions adding too as well as descriptions) and screenshot with how it looks on permissions page.
Comment #3
babruix commentedOh looks we need to wait until #366950 get committed.
Comment #4
amonteroLinked issue got commited.
Comment #5
ivan zugec commentedThe attached patch changes the description for the "Administer users" and "Administer account settings" using the text from the first comment.
Also, take note that "Administer user settings" is now "Administer account settings".
Comment #6
scull1916 commented#5: user_permission_descriptions-1813488-5.patch queued for re-testing.
Comment #7
tstoecklerThanks, that looks great. Sadly, I had a typo in my suggestion above :-/
Manager -> Manage
Comment #8
ivan zugec commentedNot a problem. :) Patch fixes typo.
Comment #9
tstoecklerThanks, looks great!
Comment #10
babruix commentedNew patch changes url() to \Drupal::url and @ to ! in placeholders.
Comment #12
babruix commentedComment #13
babruix commentedComment #14
babruix commentedComment #16
babruix commentedFor some reason, using \Drupal::url() throws exception in 2 Views tests:
, so generated URL by calling \Drupal::urlGenerator()->generateFromPath() . Or any ideas how to fix problems with Views tests? Link...
Comment #17
parthipanramesh commentedI have the same problem. Any ideas?
Comment #18
selwynpolit commented16: user_permission_descriptions-1813488-16.patch queued for re-testing.
Comment #19
xadag commentedHi,
I've tried to review this issue but as the patch is very old (2013), far away from the beta1, i saw that hook_permissions no longer exist in the API so the patch will not be valid at all now (maybe i'm wrong).
I saw that definition of permissions moved to a yml file
Also the name of permission administer users and administer users settings move to administer users and Administer account settings i guess.
So work will be do on that initial need, maybe create a new patch from the yml file with the descriptions from the older patch.
Sorry if i missunderstood something, i'm a beginner in drupal contribution :)
Comment #20
xadag commentedComment #21
legolasboI've rerolled the patch.
Comment #22
legolasboComment #23
jsobiecki commentedComment #24
quietone commentedNice, works for me.
Before:

After applying patch:

Comment #25
quietone commentedJust the upload for one of the images above
Comment #26
legolasboRestoring the amsterdam2014 tag for historic analytics purposes.
Comment #27
gugalamaciek commentedComment #28
gugalamaciek commentedI reviewed this propositions and have some suggestions about text descriptions.
Administer users
Manage all user accounts. This includes editing all user information, changes of e-mail addresses and passwords, issuing e-mails to users, blocking and deleting user accounts.
My comment: Small styling changes.
Administer account settings
Configure site-wide settings and behavior for user accounts and registration. This includes account cancellation methods, the content of user e-mails and fields attached to users.
My comment: Here, for me, the most important think is that this settings and behaviurs are user account site-wide settings. This has been removed in changed comment and I restored it im my proposition. This may be obvious for someone, who used Drupal, but for novice I think this is good to stay with 'site-wide' information.
I've attached patch with this changes.
Comment #29
jsobiecki commented+1 From me. From technical perspective it's only update of single .yml file.
Description is clear enough.
Comment #30
jsobiecki commentedComment #31
alexpottI think this should be
Manage all user accounts. This includes editing all user information, changes of e-mail addresses and passwords, issuing e-mails to users and blocking and deleting user accounts.Since "issuing e-mails to users" and "blocking and deleting user accounts" are the separate list items and we don't use the Oxford comma.Comment #32
quietone commentedI agree with ngwebs that using "site-wide" is a better option.
Here's the patch without the oxford comma and the interdiff (my first)
And, since I'm into screenshots at the moment.

Comment #33
zaporyliePatch #1813488-32: Add descriptions to clarify "administer users" and "administer user settings" permissions includes suggestions from #1813488-31: Add descriptions to clarify "administer users" and "administer user settings" permissions and can be committed.
Comment #34
alexpottCommitted 5a53811 and pushed to 8.0.x. Thanks!