Skip to main content

​
Overview

Forum support lets members ask for help in a forum channel. They press a button on a panel, fill in a short form, pick the type of inquiry (a tag of the forum) and Petto makes the post for them. Inside the post, the author and the staff have tools to lock, close and solve it. It works like Tickets, but every question is a post in a forum that other members can find later.
Forum support is off until you set a forum up with !forum setup #forum (Manage Server). Nothing changes in a server that does not use it. !forum is a prefix command (alias !forums); there are no slash commands. !forumconfig shows the module card.
liam types !forumconfig and Petto answers with the Forum support config card: the setup help, its forum, its state and the commands to change it

In Discord: !forumconfig with the setup of the forum and every command of the module.

​
Set it up

1

Pick the forum

!forum setup #support help makes a setup called help for the forum #support. A server can have up to 5 setups, one for each forum channel. Petto checks what it is missing in the forum and says so, and makes a Solved tag if the forum has none and it may edit the forum.
liam types !forum setup #support help and Petto answers with the card of the setup help: the forum, who may do what, the posts and the automation, all still off

In Discord: !forum setup with the forum and a name; the card shows who may do what and the automation.

2

Choose the staff

!forum set staff-roles @Helpers says which roles are the staff of this forum. Members with Manage Threads are staff everywhere.
liam types !forum set staff-roles @Helpers and Petto answers that it saved staff-roles of the setup help

In Discord: the staff role is saved.

3

Post the panel

!forum panel #support-info posts the card with the Open post button. Run it again and the message that is there is edited instead of posting a new one. Run it with another channel and the panel moves there.
liam types !forum panel #support-info and Petto answers that it posted the panel of the setup help, with the link to it

In Discord: !forum panel with the channel of the panel.

The panel Open A Post in #support-info: the text that tells how to open a post and the green Open post button under it

In Discord: the panel with the Open post button.

4

Check it

!forum status shows the settings, who may do what, the automation and any permission Petto is missing.
liam types !forum status and Petto answers with the card of the setup and a warning that it is missing the Manage Threads permission in the forum, plus three optional permissions

In Discord: !forum status with the permission Petto is missing.

You can do the same, and much more, from the dashboard: Community, Forums (next to Tickets). It has the setups, an editor with a live preview of the panel, the button of “Send or update the panel” and the list of posts with Lock, Close and Solved buttons.
The Forums page with three setups: help and feedback on, bugs off, each with its forum, a link to its panel and the Edit and Turn off buttons, and a note on feedback that Petto cannot post there

Dashboard → Community → Forums: the setups of your forums, each one with its panel and its posts.

The editor of the setup help with the forum and the panel settings on the left and the preview of the Open A Post card with its green button on the right

Dashboard → Community → Forums: the editor of a setup: the forum, the panel and a live preview of it and of the first message.

The Forum posts page with the Open tab: five posts with their author, date, state and who handles them, and a Lock, Close and Solved button on each

Dashboard → Community → Forums: the posts of your forums with the Lock, Close and Solved buttons.

​
What members see

  1. They press Open post on the panel.
  2. A form asks for the title and the description, and up to three more questions you add (short text, paragraph or a menu of choices). If you turn on pictures, the form has a picture upload.
  3. If the forum has tags, a menu asks for the type of inquiry (the tag). It is skipped when the forum has no tags to pick. A tag can be optional (a “Post without a tag” button) or required.
  4. Petto makes the post and answers with a private link to it.
The Open a post form with the title and the description filled in, a short question about the version and a menu with the platform

In Discord: the form that opens when a member presses Open post.

The post Cannot log in to the dashboard with the tag Bug: Petto wrote Post opened by enderwolf and the description, then the submitted form with the version and the platform, then a card that pings Helpers and lists three guidelines

In Discord: a new post: the first message, the answers of the form and the card with the guidelines and the role to ping.

The Form card with the title of the window and the labels, the picture switch and two questions, a short text and a menu of choices

Dashboard → Community → Forums: the form: the texts of the window and up to three more questions.

The post card with the first message style set to a line and a card, the slowmode, three guidelines and the Helpers role to ping

Dashboard → Community → Forums: the first message, the guidelines and the roles to ping.

A post with only the line Post opened by enderwolf as first message, the description in a green card under it, then the submitted form and the guidelines card

In Discord: the same post with the first message in the style of a card: one line, and the description in a card.

Under the panel, a message only the member sees: Pick the type of inquiry, with the menu open showing Bug, Question and Account, and the buttons Post without a tag and Cancel

In Discord: the step to select the type of inquiry, seen only by the member.

A message only the member sees: Your post is ready, with the link to the new post

In Discord: Petto answers with a private link to the new post.

The first message of the post says Post opened by @member - title followed by the description. You can change it with a template that uses {user}, {username}, {title}, {description}, {tag}, {server} and {forum}, or have only the first line in the message and the description in a card. After it come the answers to the other questions, the pictures, and a card with your guidelines and the roles to ping.
The usual panel text says, like other bots do, that images cannot be attached while filling in the form and can be added once the post is open. If you turn on pictures in the form, the text says the opposite. You can write your own text, or use a saved design (a Components V2 card made in the embed designer): the button goes under it.

​
Tags

  • Members can only pick tags the setup allows (all of them if you chose none), never the ones only moderators can use and never the Solved tag.
  • A post can have up to the number of tags you allow (1 to 5).
  • If the forum itself requires a tag, Petto asks for one even when the setup does not.
The Tags card: tag required off, two tags per post, Solved as the solved tag and the checkboxes Bug, Question and Account on, Solved and Moderation off

Dashboard → Community → Forums: which tags members can pick, how many a post can have and the tag that means solved.

​
Limits and blocks

Every refusal is shown only to the member, in their language, with the reason.
Under the panel, a message only the member sees: You already have 3 open posts (the most is 3), with links to them, and Close or solve one before opening another

In Discord: a member who already has three open posts is refused, and only they see it.

The Who can do what card with the staff roles Moderators and Helpers, the blocked role Muted, three open posts per member, 30 seconds between posts and the three author switches on

Dashboard → Community → Forums: the staff roles, who may open posts, the limits and what the author can do.

​
Commands

Inside a forum post, the tools below work. Each one answers with a small green card, for example @staff: Successfully locked #post-name, with a quiet mention.
chu types !tl with a reason and Petto answers with the green card: chu, Successfully locked the post, and the reason in small text

In Discord: !tl with a reason locks the post.

chu types !tul and Petto answers with the green card: Successfully unlocked the post

In Discord: !tul lets members write again.

enderwolf types !forum close with a reason and Petto answers with the green card Successfully closed the post and the reason

In Discord: the author closes their own post; the card is the last message.

kira types !forum reopen in a closed post and Petto answers with the green card Successfully opened the post again

In Discord: a closed post is opened again.

After kira helps, enderwolf types !forum solved and Petto answers with the green card Marked the post as solved and a note that it will be closed tomorrow

In Discord: the author marks the post as solved; the card says when it will be closed.

enderwolf asks to reopen the topic and types !forum unsolved; Petto answers with the green card saying the post is not solved any more

In Discord: the Solved tag comes off.

enderwolf types !forum rename with a new title and Petto answers with the green card: the title of the post is now the new one in bold

In Discord: the author changes the title of their post.

shi types !forum tag add Bug and then !forum tag remove Question; Petto answers each one with a green card

In Discord: a tag is added and another one removed.

enderwolf types !forum tag list and Petto answers with a card that lists Bug, Question, Account, Solved and Moderation (staff only), with Question in bold because the post has it

In Discord: the tags of the forum, with the ones of the post in bold.

kira types !forum claim and Petto answers Handled by kira; later kira types !forum unclaim and Petto answers that she does not handle the post any more

In Discord: a staff member says that they handle the post, and then lets it go.

kira types !forum list and Petto answers with the card Forum posts, showing Open: five posts with a link, author, state and time, and a menu to show the other states

In Discord: the open posts of the forums, with their author, state and who handles them.

With more than one setup, add --setup <name> to the setup commands (they are also found by the forum you type them in).

​
Who may use the tools

  • The author of a post can close it, mark it solved and rename it, only in their own post. You can turn each one off (author-close, author-solve, author-rename).
  • The staff roles of the setup and members with Manage Threads can use every tool in any post.
  • A staff member who only has a staff role cannot act on the post of a member whose highest role is above theirs (the same rule as moderation commands). Manage Threads is not held back by it.
  • In a forum that has no setup, only members with Manage Threads can use the tools, so !tl works in any forum for moderators.
  • Outside a forum post the tools answer that it is not a forum post. Petto checks its own permissions and says which one is missing.
enderwolf types !tl in his own post and Petto answers with a yellow card: Only the staff of this forum can do that

In Discord: a member who is not staff cannot lock a post.

​
Move a message into the forum

Reply to a message (or give its link or ID) and type !forum move. Petto makes a post in the forum with the Original Message card (what it said and who wrote it) and a note of who moved it, and leaves a reply under the message that points to the post and mentions its author. The original message is not deleted. Add the forum and a title if you need them: !forum move #support Cannot log in.
Nova asks about her level card in #general, kira replies to it with !forum move and a title, and Petto answers under the message that it moved it to the new post

In Discord: kira replies to a message with !forum move; Petto answers under the message with the link to the new post.

The new post in the forum: the original message from Nova, then the Original Message card with who wrote it and where, the quote, and who moved it

In Discord: the new post, with the Original Message card.

​
Settings of !forum set

max-open, cooldown, slowmode, require-tag, max-tags, images, adopt, tag-wait, inactive-days, inactive-action (lock or close), solved-action (none, lock or close), solved-delay (hours), author-close, author-solve, author-rename, staff-roles, ping-roles, required-roles, blocked-roles, guidelines, first-message, first-message-style (plain or card), panel-title, panel-text, panel-footer, panel-image, panel-color, panel-design, button-label, button-emoji, button-style, modal-title, title-label and description-label. Use none to clear a text or a list. The extra questions of the form and the log events are set on the dashboard.

​
Automation

One job runs every minute and only reads an index of the posts that are due, so it costs almost nothing. Everything here is optional and off by default.
  • Quiet posts: inactive-days locks or closes a post nobody wrote in for that many days.
  • Solved posts: solved-action and solved-delay lock or close a post that long after it was marked solved.
  • Posts made by hand: with adopt on, a post made in the forum without the panel is kept, gets the guidelines and the staff ping and can use the tools. If require-tag is on and the post has no tag, Petto asks its author to choose one and closes the post when tag-wait minutes pass.
A message in a post writes its last activity at most once every 5 minutes.
The Automation card with quiet posts closed after 7 days, solved posts closed 24 hours after, and the switch to keep posts made by hand with 10 minutes to choose a tag

Dashboard → Community → Forums: quiet posts, solved posts and posts made by hand.

​
Logging

The log category forums (!logs add #channel forums) tells when a post is opened, locked, closed or solved, who did it (or that Petto did it by itself) and why. Each of the four can be switched off on the dashboard, for each setup. See Logging.
The Log card with the four events checked: posts opened, locked, closed and solved

Dashboard → Community → Forums: what is told in the log of each setup.

​
Permissions Petto needs

In the forum channel: View Channel, Send Messages (to create posts), Send Messages in Threads and Manage Threads (to lock, close and tag). Create Public Threads, Attach Files (copying the pictures of the form) and Manage Channels (making the Solved tag) are optional. In the panel channel: View Channel and Send Messages. !forum status lists what is missing.

​
Troubleshooting

Give Petto the permissions above in the forum channel (or its category) and run !forum status again.
A forum holds 20 tags and Petto needs Manage Channels to add one. Add a tag called Solved yourself, or choose another tag on the dashboard.
The panel belongs to a setup that was turned off or removed, or the forum was deleted. Run !forum status, then !forum panel to post it again.
Use it inside a post of a forum. In a forum without a setup you need Manage Threads.
chu types !tl in #general and Petto answers with a yellow card: This is not a forum post. Use this inside a post of a forum

In Discord: !tl typed in a normal channel.

Look at inactive-days, solved-action and tag-wait in !forum status. The log category forums says which rule did it.