function devel_switch_user_list

Provides the Switch user list.

Return value

array An array of links, each of which can be used to switch to a user.

File

./devel.module, line 903

Code

function devel_switch_user_list() {
    global $user;
    $links = array();
    if (user_access('switch users')) {
        $list_size = variable_get('devel_switch_user_list_size', 10);
        if ($include_anon = variable_get('devel_switch_user_include_anon', FALSE)) {
            --$list_size;
        }
        $dest = drupal_get_destination();
        // Try to find at least $list_size users that can switch.
        // Inactive users are omitted from all of the following db selects.
        $roles = user_roles(TRUE, 'switch users');
        $query = db_select('users', 'u');
        $query->addField('u', 'uid');
        $query->addField('u', 'access');
        $query->distinct();
        $query->condition('u.uid', 0, '>');
        $query->condition('u.status', 0, '>');
        $query->orderBy('u.access', 'DESC');
        $query->range(0, $list_size);
        if (!isset($roles[DRUPAL_AUTHENTICATED_RID])) {
            $query->leftJoin('users_roles', 'r', 'u.uid = r.uid');
            $or_condition = db_or();
            $or_condition->condition('u.uid', 1);
            if (!empty($roles)) {
                $or_condition->condition('r.rid', array_keys($roles), 'IN');
            }
            $query->condition($or_condition);
        }
        $uids = $query->execute()
            ->fetchCol();
        $accounts = user_load_multiple($uids);
        foreach ($accounts as $account) {
            $path = 'devel/switch/' . $account->name;
            $links[$account->uid] = array(
                'title' => drupal_placeholder(format_username($account)),
                'href' => $path,
                'query' => $dest + array(
                    'token' => drupal_get_token($path),
                ),
                'attributes' => array(
                    'title' => t('This user can switch back.'),
                ),
                'html' => TRUE,
                'last_access' => $account->access,
            );
        }
        $num_links = count($links);
        if ($num_links < $list_size) {
            // If we don't have enough, add distinct uids until we hit $list_size.
            $uids = db_query_range('SELECT uid FROM {users} WHERE uid > 0 AND uid NOT IN (:uids) AND status > 0 ORDER BY access DESC', 0, $list_size - $num_links, array(
                ':uids' => array_keys($links),
            ))->fetchCol();
            $accounts = user_load_multiple($uids);
            foreach ($accounts as $account) {
                $path = 'devel/switch/' . $account->name;
                $links[$account->uid] = array(
                    'title' => format_username($account),
                    'href' => $path,
                    'query' => array(
                        'token' => drupal_get_token($path),
                    ),
                    'attributes' => array(
                        'title' => t('Caution: this user will be unable to switch back.'),
                    ),
                    'last_access' => $account->access,
                );
            }
            uasort($links, '_devel_switch_user_list_cmp');
        }
        if ($include_anon) {
            $path = 'devel/switch';
            $link = array(
                'title' => format_username(drupal_anonymous_user()),
                'href' => $path,
                'query' => $dest + array(
                    'token' => drupal_get_token($path),
                ),
                'attributes' => array(
                    'title' => t('Caution: the anonymous user will be unable to switch back.'),
                ),
            );
            if (user_access('switch users', drupal_anonymous_user())) {
                $link['title'] = drupal_placeholder($link['title']);
                $link['attributes'] = array(
                    'title' => t('This user can switch back.'),
                );
                $link['html'] = TRUE;
            }
            $links[] = $link;
        }
    }
    if (array_key_exists($user->uid, $links)) {
        $links[$user->uid]['title'] = '<strong>' . $links[$user->uid]['title'] . '</strong>';
    }
    return $links;
}