Suggestions

Let your members make your server even better by posting suggestions!

With the Suggestions module you can setup a system that allows users to provide suggestions for your server or other things to suggest on of your choice. Users can create suggestions, vote or downvote on other suggestions, and more. Your server's moderators may approve or deny your server's suggestions.

Settings

Submit a Suggestion

In this area, you can customize how your bots' users will submit their suggestions.

Title

Here you may choose whether you want your members to be able to, unable to, or have to add a title. The default value for this is set to Disabled.

Value	Details
Disabled	Users cannot add a title for their suggestion.
Enabled	Users can optionally add a title for their suggestion.
Enabled and Required	Users are required to add a title for their suggestion.

Image

Here you may choose whether you want your members to be able to, unable to, or have to add an image. The default value for this is set to Disabled.

Value	Details
Disabled	Users cannot upload an image for their suggestion.
Enabled	Users can optionally upload an image for their suggestion.
Enabled and Required	Users are required to upload an image for their suggestion.

Title minimum length

Here you may choose how long the title of the suggestion may be at its shortest. The default value for this is set to 10. This setting only shows if Title is enabled (and required).

Title maximum length

Here you may choose how long the title of the suggestion may be at its longest. The default value for this is set to 200. This setting only shows if Title is enabled (and required).

Description minimum length

Here you may choose how long the description of the suggestion may be at its shortest. The default value for this is set to 10.

Description maximum length

Here you may choose how long the description of the suggestion may be at its longest. The default value for this is set to 4000.

Suggestions Management

In this area, you can customize who can manage your server's suggestions and how.

Manager Roles

Here you may choose the roles users must have in order to approve and deny suggestions.

Enable Logging

Here you may toggle whether logs about suggestions are sent to a specific channel.

Logging Channel

Here you may choose the channel where logs for the module will be sent. This setting only shows if Enable Logging is enabled.

Send all suggestions to a channel for approval

Here you may toggle whether suggestions are sent to a private channel where they must be approved or denied.

Approval Channel

Here you may choose the channel where suggestions for approval will be sent. This setting only shows if Send all suggestions to a channel for approval is enabled.

Hide the user who approved or denied the suggestion

Here you may toggle whether the user who approved or denied a suggestion is made public.

Suggestion

In this area, you can customize how the suggestion appears in the voting channel.

Suggestions Channel

Here you may choose the channel where suggestions will be posted and voted on. This is required for the system to function correctly.

Create Thread

Here you may toggle whether a thread for discussion will be created and attached to the suggestion/voting message in the suggestions channel.

Lock Thread on Verdict

Here you may toggle whether the thread attached to the suggestion will lock when a suggestion is approved or denied. This setting only shows if Create Thread is enabled.

Neutral Option

Here you may toggle whether a reaction for indecisiveness is added to the suggestion / voting message in the suggestions channel.

Upvote Emoji

Here you may choose the first emoji on the suggestion / voting message, which members can use to show their approval of the suggestion.

Neutral Emoji

Here you may choose the next emoji on the suggestion/voting message, which members can use to show they are indecisive on the suggestion. This setting only shows if Neutral Option is enabled.

Downvote Emoji

Here you may choose the last emoji on the suggestion / voting message, which members can use to show their disapproval of the suggestion.

Suggestion Embed color

Here you may choose the color of the embed in the suggestion/voting message.

Anonymous Suggestions

Here you may toggle whether the author of a suggestion is hidden from the public.

Message Suggestion Author for updates

Here you may toggle whether the author of a suggestion receives a direct message when there is an update on their suggestion.

Automation

In this area, you can customize how a suggestion can automatically be approved or denied based on its votes.

Auto Approve Type

Use this feature to automatically approve a suggestion by a certain type of condition.

Disabled

Suggestions will not be automatically approved on any condition.

Number of Upvotes

The number of upvotes needed for suggestions to be automatically approved.

Auto Approve - Number of upvotes

This setting allows you to set the minimum number of upvotes required to approve the suggestion automatically. You can only provide whole, positive numbers.

Difference between upvotes and downvotes

Difference between upvotes and downvotes needed for automatic approval of the suggestion.

Auto Approve - Difference

This setting allows you to set the minimum difference between the upvotes and the downvotes required to approve the suggestion automatically. This means that, if you set this setting to 10, there must be 10 upvotes more than downvotes in order for the suggestion to be approved. You can only provide whole, positive numbers.

Percentage of upvotes

Percentage of upvotes required for automatic approval of the suggestion. A minimum of upvotes required for the percentage to be checked is required. If there aren't enough upvotes, the suggestion won't be approved, even if the required percentage is reached.

Auto Approve - Percentage of upvotes

This setting allows you to set the minimum percentage of upvotes the suggestion must have in order for it to be approved automatically. You can only provide whole, positive numbers.

Auto Approve - Minimum upvotes

This setting allows you to set the minimum number of upvotes required for the filter above to work.

Auto Deny Type

Use this feature to automatically deny a suggestion by a certain type of condition.

Disabled

Suggestions will not be automatically denied on any condition.

Number of downvotes

The number of downvotes needed for suggestions to be automatically denied.

Auto Deny - Number of downvotes

This setting allows you to set the minimum number of downvotes required to deny the suggestion automatically. You can only provide whole, positive numbers.

Difference between downvotes and upvotes

Difference between the downvotes and upvotes needed for automatic denial of the suggestion.

Auto Deny - Difference

This setting allows you to set the minimum difference between the downvotes and the upvotes required to deny the suggestion automatically. This means that, if you set this setting to 10, there must be 10 downvotes more than upvotes in order for the suggestion to be denied. You can only provide whole, positive numbers.

Percentage of downvotes

Percentage of downvotes required for automatic denial of the suggestion. A minimum of downvotes required for the percentage to be checked is required. If there aren't enough downvotes, the suggestion won't be rejected, even if the required percentage is reached.

Auto Deny - Percentage of downvotes

This setting allows you to set the minimum percentage of downvotes the suggestion must have in order for it to be denied automatically. You can only provide whole, positive numbers.

Auto Deny - Minimum downvotes

This setting allows you to set the minimum number of downvotes required for the filter above to work.

Restrictions

In this area, you can customize who is restricted from posting suggestions and who is not.

Role Restrictions

Blacklist Type	Description
No Role Restrictions	All users of your server may create suggestions.
Disable for these roles...	Set this blacklist type if you want everyone to be able to create suggestions, except users with at least one of the roles provided in the menu below.
Enable for these roles...	Set this blacklist type if you want that only users with at least one of the roles provided in the menu below can post suggestions.

Commands

Below you may find some information on each command of the module.

/suggestion create

This command is what your users can run to make and post suggestions.

/suggestion verdict

This command will allow suggestion managers to approve or deny suggestions by their suggestion ID or message ID in the suggestions / voting channel.

/suggestion view

This command will allow you to view the information of a suggestion by its suggestion ID or message ID in the suggestions / voting channel.

---

Events

Below you may find some information on each event of the module.

Reaction Add

This event modifies the percentage of the votes and removes other reactions from the post when a reaction is added if it is in the suggestions/voting channel.

Reaction Remove

This event modifies the percentage of the votes when a reaction is removed if it is in the suggestions/voting channel.