PyDrocsid/cogs

# User Info

Contains commands to show information about Discord user accounts.


## `userinfo`

Shows general information about the requested user.

```css
.[userinfo|user|uinfo|ui|userstats|stats] [user]
```

Arguments:

| Argument | Required |Description                                                                                                                   |
|:--------:|:--------:|:-----------------------------------------------------------------------------------------------------------------------------|
| `user`   |          | The user whose information is requested. If omitted, the requesting user receives their own information as a direct message. |

The user information given by this command includes:

- Current username, discriminator, avatar and id
- Membership status
- User activity (provided by [Inactivity](../inactivity))
- Active punishments (provided by [Mod Tools](../../moderation/mod))
- Moderation statistics (provided by [Mod Tools](../../moderation/mod)):
    - Reports
    - Warns
    - Mutes
    - Kicks
    - Bans

!!! note
    - Every user is allowed to request their own information.
    - Requesting other users' information, however, requires the `user_info.view_userinfo` permission.

<!-- markdownlint-disable MD046 -->
!!! info
    Moderation statistics:

    - The term `active` refers to the number of times this user *has actively* reported/punished someone else.
    - The term `passive` refers to the number of times this user *has been* reported/punished e.g. by a moderator.
<!-- markdownlint-enable MD046 -->


## `joined`

Shows a rough estimate of how much time has passed since the last verification of a given member. If no `Verified` role has been configured yet, this estimate refers to the last join date of this member.

```css
.joined [member]
```

Arguments:

| Argument | Required | Description                                                                                    |
|:--------:|:--------:|:-----------------------------------------------------------------------------------------------|
| `member` |          | The member whose information is requested. If omitted, this defaults to the requesting member. |


## `userlogs`

Shows the moderation log of a given user.

```css
.[userlogs|userlog|ulog] [user]
```

Arguments:

| Argument | Required | Description                                                                                                  |
|:--------:|:--------:|:-------------------------------------------------------------------------------------------------------------|
| `user`   |          | The user whose log is requested. If omitted, the requesting user receives their own log as a direct message. |

The user log given by this command contains the following events:

- Account creation
- Guild joins and leaves
- Username and nickname changes
- Verification state changes
- Discord invite approvals and removals and illegal invite posts (provided by [Invite Whitelist](../../moderation/invites))
- Illegal posts in media-only channels (provided by [MediaOnly](../../moderation/mediaonly))
- User notes (provided by [User Notes](../../moderation/user_notes))
- Passive moderation actions (provided by [Mod Tools](../../moderation/mod)):
    - Reports
    - Warns
    - Mutes
    - Kicks
    - Bans

!!! note
    - Every user is allowed to request their own moderation log.
    - Requesting other users' logs, however, requires the `user_info.view_userlog` permission.


## `init_join_log`

The `.init_join_log` command creates join (and, if enabled, verification) log entries for every user based on their [join dates received from the Discord API](https://discordpy.readthedocs.io/en/latest/api.html#discord.Member.joined_at){target=_blank}, if those entries don't already exist.

```.css
.init_join_log
```

!!! note
    - This command requires the `user_info.init_join_log` permission. It is recommended to grant this permission only to administrators.
    - As the bot has to individually create log entries in the database for every user, execution of this command may take a while.