peertube-plugin-livechat/support/documentation/content/en/documentation/user/streamers/moderation.md

title	description	weight	chapter
Moderation	Plugin peertube-plugin-livechat advanced moderation features	300	false

{{% notice warning %}} This section is still incomplete. {{% /notice %}}

{{% notice warning %}} This page describes the behaviour of livechat versions >= 10.0.0. There were some changes in the way we manage access rights for Peertube administrators and moderators. {{% /notice %}}

The chat bot

You can use a chat bot, that will help you for moderation. Check the chat bot documentation for more information.

Accessing moderation tools

You can access room settings and moderation tools using the chat dropdown menu at the top of the chat.

{{% notice tip %}} The video owner will be owner of the chat room. This means they can configure the room, delete it, promote other users as admins, ... {{% /notice %}}

{{% notice tip %}} Starting with livechat v10.0.0, Peertube instance's admins and moderators have no special rights on rooms by default. However, they have a special button available on top of the chat: "{{% livechat_label promote %}}". Clicking this button will give them owner access on the room. {{% /notice %}}

You can use ConverseJS moderation commands to moderate the room. When you open the chat room in full screen, there will also be a menu with dedicated commands on the top right.

{{% livechat_label livechat_configuration_channel_mute_anonymous_label %}}

{{% notice info %}} This feature comes with the livechat plugin version 10.2.0. {{% /notice %}}

You can prevent anonymous users to send messages. In such case, only registered users will be able to talk in the chat.

To enable or disable this feature, use the chat dropdown menu, open the "configure" menu. In the form, you will find a "{{% livechat_label livechat_configuration_channel_mute_anonymous_label %}}" checkbox.

Anonymous users won't have the message field, and will see following prompt: "{{% livechat_label muted_anonymous_message %}}"

When this feature is enabled, anonymous users will be assigned the "visitor" role. You can change their role to "participant" if you want to allow some of them to talk.

If you change the room configuration, all anonymous users will be muted or unmuted.

You can choose to enable or disable this feature for new chatrooms on the channel configuration page.

Roles and affiliations

There are several roles that can be assignated to users in chat rooms: owner, moderators, member, ...

{{% notice warning %}} This section is still incomplete. {{% /notice %}}

You can promote users as moderators, if you need some help.

Delete room content

You can delete old rooms: join the room, and use the menu on the top to destroy the room.

Instance moderation

As Peertube instance moderator or administrator, you will probably need to check that your users are not behaving badly.

You can list all existing chatrooms: in the plugin settings screen, there is a button «List rooms».

From there, you can also promote yourself as room moderator by using the "{{% livechat_label promote %}}" button on the right.