Open Docs Navigation

Locks

As fun as stickers, gifs, and voice messages can be, they can also cause problems in groups. For example, if your group chat is like the official Rose Support group, users are there for a specific purpose |to get help. Having users shitposting gifs and stickers can make it very difficult to get help. Or perhaps you have issues with ||Arabic spammers, and want to block any RTL messages. Whatever your need, locks are here to help.

Checking Your Group's Lock Status

By default, Rose should have nothing locked, meaning everything is available. However, if you're new to a group, you might be curious what content you are allowed to post, and what might be disabled. Or as an admin, you want to double check if you've disabled everything you need. Thankfully, it's as simple as issuing the below command:

/locks

Rose will respond with a list of all available locks with true or false values for each lock type.

Locktypes

If you want to view a list of all the content types that are available to be locked, you can issue the below command:

/locktypes

For your convenience, the list is included below for your reference, with a short description for each.

Type of Lock Description
all Locks everything in the list
audio Uploaded audio files
bot Blocks users from adding bots to your group
button Blocks users and inline bots from sending button links
command Bot commands issued with / or !
contact Shared contacts (vCards, etc.)
document Shared files
email Email addresses in @.___ format
forward Forwarded messages
game
gif GIF images
location Shared locators
phone
photo Images
poll Voting polls
rtl Any messages containing RTL characters (Arabic, Hebrew, etc.)
sticker Stickers
text All text messages
url URLs and links
video Videos
videonote Telegram video messages (Similar to voice messages)
voice Telegram voice messages

Configuring Locked Content Types

As we now have the above list of content available for us to lock, we can now get started with actually locking our unwanted content

Locking Content

To lock a certain type of content, simply issue the below command:

/lock <locktype>

Example Scenario

If you wanted to prevent users from sending GIFs, you would issue the below command:

/lock gif

You may also lock multiple locktypes in the same command. To do this, you would simply separate each locktype with a space. So, if you wanted to lock gifs, videos, and stickers, you would issue the below:

/lock gif video sticker

Lock Warnings

While locks will prevent a user from posting the specified content types, you may want to go a step further. This is where lock warnings come in handy. Lock warnings will issue a warning to a user whenever they try to send a content type that is locked. This setting lets users know you mean business when it comes to locks.

To enable lock warnings, issue either of the following commands:

/lockwarns on
/lockwarns yes

To disable lock warnings, either of the below can be issued:

/lockwarns off
/lockwarns no

Unlocking Content

Of course, any content type that you lock can be unlocked just as easily as you locked it. To unlock a content type, issue the below command:

/unlock <locktype>

Example Scenario

Let's refer to our example above where we wanted to lock gifs, videos, and stickers. If you wanted to unlock videos, but still keep gifs and stickers locked, you would issue the below command:

/unlock video

Just like locking content, you can also unlock multiple content types in the same way. So if you wanted to unlock gifs and stickers, you would issue the following:

/unlock gif sticker

Whitelisting URLs

You've locked URLs from your group, and nobody can send links. Great! But what if you want still want users to be able to share specific URLs, such as a link to your group's website? Don't worry, Rose can do this too with URL whitelisting. Any URLs on this whitelist will be allowed in your chat, even if you've enabled the URL locktype!

Viewing The Current Whitelist

To view a list of URLs that you currently have whitelisted, you can issue the below command:

/whitelist

Adding A Whitelist Entry

To add a URL to the whitelist, simply issue the following command:

/whitelist <URL>

Example Scenario

Let's say we wanted to whitelist the URL to the Miss Rose website. To do this, we would issue the command like shown below:

/whitelist missrose.xyz

Like adding and removing locktypes, you can also specify multiple URLs, separated by a space. Let's say we wanted to whitelist both the Miss Rose site, and the Telegram site. We would issue the below:

/whitelist missrose.xyz telegram.org

Removing A Whitelist Entry

To remove a URL from the whitelist, issue the following command:

/rmwhitelist <URL>

Example Scenario

If we wanted to remove the Telegram site from the whitelist, we would issue the command like shown:

/rmwhitelist telegram.org

Multiple URLs can be specified, just like when adding an entry. If you wanted to remove both the Miss Rose site and the Telegram site, you would issue the following command:

/rmwhitelist missrose.xyz telegram.org