[user] Add getSites functions in User class

[CamilleBeau]

Brief summary of changes

This PR adds 2 functions to the user class. One returns an array of Site objects that the user has access to. The other returns an associative array with the format CenterID => SiteName for all of the sites that the user has access to.

• Have you updated related documentation?

Testing instructions (if applicable)

Link(s) to related issue(s)

[jeffersoncasimir]

I believe you should be using $user->getStudySites() instead of reimplementing the logic

[CamilleBeau]

@jeffersoncasimir getStudySites only includes study sites, but I believe in this case we want all sites that the user has access to

[CamilleBeau]

@jeffersoncasimir @driusan (and @ridz1208 because you seem interested in this development) I added 2 functions to the User class:

1. getSites() that returns an array of Site objects for all sites that the user has
2. getSitesNamesList() that returns an associative array of centerID => centerName

I'm still trying to set up Docker on my VM to be able to debug the test suites (it was failing yesterday), but I'm trying something out in my last commit.

[jeffersoncasimir]

This has been tested and works as expected. Great work!

[driusan]

I don't understand why this is necessary.

user_accounts.class.inc already has:

    /**
     * Tells the base class that this page's provisioner can support the
     * HasAnyPermissionOrUserSiteMatch filter.
     *
     * @return ?array of permissions or null
     */
    public function allSitePermissionNames() : ?array
    {
        return ['user_accounts_multisite'];
    }

so shouldn't the HasAnyPermissionOrUserSiteMatch filter take care of it?

[CamilleBeau]

allSitePermissionNames function takes care of filtering out users who don't belong to one of the user's sites, but this code makes it so that only the user's sites are shown in the "Site" column of the table.

With the change from user_accounts.class.inc but without this change, there were empty strings in between commas:

[CamilleBeau]

@jeffersoncasimir @driusan I removed all of the user_accounts code, changed the name, and the description. The PR now only includes the 2 functions that can be used elsewhere in the code.