User statuses are confusing (Craft 2 and Craft 3)

[missmatsuko]

Description

1. When we filter users by status and select 'Pending' (orange), users with the suspended status (red) will appear. I'm guessing this is because these suspended users never verified their account, but it is confusing that the filter doesn't show only users whose status is set to 'Pending'.

2. When I inspected some of these users, I found that even the users marked with orange that I thought were 'Pending' were actually 'Unverified'. I don't know where this term is coming from, since the docs below only list 'active', 'locked', 'suspended', 'pending', 'archived', and null as possible values for User Status. I did notice that there's a 'pending' class on this element, though.

• Craft 2 User Status Docs
• Craft 3 User Status Docs

Steps to reproduce

1. Set up a Craft site and add some users
2. Suspend some users
3. Go to /admin/users and select the 'Pending' status

Additional info

• Craft version: All? Observed on Craft 2 and Craft 3 sites
• PHP version:
• Database driver & version:
• Plugins & versions:

[brandonkelly]

It’s a little awkward because a user technically could be both pending and suspended (though suspending a user that hasn’t even activated their account yet, let alone done something suspension-worthy, is a little Dickish).

Considering that I would say this is expected behavior. If their account is pending, they should show up in this list, regardless of whether they’ve been suspended. If they’ve been suspended, I do think that’s an important thing to show in the Status column, even when searching for Pending users.

2. When I inspected some of these users, I found that even the users marked with orange that I thought were 'Pending' were actually 'Unverified'.

Where are you seeing the reference to “unverified” ? Pending and unverified mean the same thing, but we should be consistent.

[missmatsuko]

It’s a little awkward because a user technically could be both pending and suspended (though suspending a user that hasn’t even activated their account yet, let alone done something suspense-worthy, is a little Dickish).

Yeah, I'm not sure what the reason for suspending users was. It looks like maybe the accounts were created with spammy-looking emails, so maybe that's why they got suspended.

Considering that I would say this is expected behavior. If their account is pending, they should show up in this list, regardless of whether they’ve been suspended. If they’ve been suspended, I do think that’s an important thing to show in the Status column, even when searching for Pending users.

In this particular case, the client wants to see only Pending users who are not Suspended.

If this is the expected behaviour, then the user detail view should display both 'Pending' and 'Suspended'. Currently it looks like the user's status is only 'Suspended'.

The dot in the list-view items should also match the filter, maybe by showing both colors. Currently it seems like the filter is broken because the filter's dot color doesn't match the result dot colors.

The documentation for user status should also be updated to make it clear that a user can have multiple statuses. Is this really the case though? It seems like user status is a string, so a user shouldn't be able to have multiple statuses: Craft 3 User Model - Status

Where are you seeing the reference to “unverified” ? Pending and unverified mean the same thing, but we should be consistent.

I saw this in the user's detail page (e.g. /admin/users/26), in the right sidebar.
I'm guessing this term is being set here: UsersController.php line 606

[brandonkelly]

In this particular case, the client wants to see only Pending users who are not Suspended.

I guess I could see why… if a user is suspended, even if they haven’t activated their account yet they’re not really “pending” anything… in fact they should get an error when they try to activate their account at that point.

The documentation for user status should also be updated to make it clear that a user can have multiple statuses. Is this really the case though? It seems like user status is a string, so a user shouldn't be able to have multiple statuses: Craft 3 User Model - Status

“Status” is a core feature for all elements. Users just happen to define their status based on multiple independent properties:

cms/src/elements/User.php

Lines 933 to 952 in 71b8848

	public function getStatus()
	{
	if ($this->locked) {
	return self::STATUS_LOCKED;
	}
	if ($this->suspended) {
	return self::STATUS_SUSPENDED;
	}
	if ($this->archived) {
	return self::STATUS_ARCHIVED;
	}
	if ($this->pending) {
	return self::STATUS_PENDING;
	}
	return self::STATUS_ACTIVE;
	}

It wouldn’t be possible to show more than once status for users without introducing a breaking change for all element types (including plugin-supplied ones), so not something we could even consider until Craft 4.

I saw this in the user's detail page (e.g. /admin/users/26), in the right sidebar.

Ah yes, thanks, will fix that.

[missmatsuko]

Thank you! Would it be possible to apply to Craft 2 as well? 🤞

[brandonkelly]

Yep done.

[missmatsuko]

Champ!