feat: Add user relations loading methods for groups and permissions

[michalsn]

Description
This PR enhances user queries by enabling the retrieval of related user data more efficiently.

It adds two new methods: withGroups() and withPermissions(), which loads user groups and permissions directly when fetching users. The existing withIdentities() method (previously undocumented) has also been included in the documentation.

With these methods, all necessary user information can be loaded in a single query (one per used method), reducing the number of additional queries and improving performance.

The problem this PR solves was described in the Bonfire2 repo: lonnieezell/Bonfire2#558

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[datamweb]

LGTM! Thanks.

@dgvirtual Please confirm if the issue has been resolved.

[datamweb]

LGTM! Thanks.

[michalsn]

Thanks @datamweb

[dgvirtual]

I added in Bonfire2 src\Users\Controllers\UserController:

        $userModel->filter($this->request->getGet('filters'))
            ->withPermissions()
            ->withIdentities()
            ->withGroups();

The withGroups part works (-14 database calls).

The withPermissions part seems to not work: I still get lazy loading on calling
$user->can('users.manage-admins') in view
src\Users\Views\_table.php

[michalsn]

I guess this may occur when no permissions are set for the user. I will look into it tonight.

[dgvirtual]

Yep, could be, I will check that as well

…

On Sun, 5 Oct 2025, 17:01 Michal Sniatala, ***@***.***> wrote: *michalsn* left a comment (codeigniter4/shield#1257) <#1257 (comment)> I guess this may occur when no permissions are set for the user. I will look into it tonight. — Reply to this email directly, view it on GitHub <#1257 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAULV6QI6VYWRDV65KFEB333WEQCPAVCNFSM6AAAAABYBVKXG2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTGNRZGA3TQOBSGU> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[michalsn]

@dgvirtual Please check #1290 when you get a chance.