Add warning message when post is rejected

README.md

@@ -5,12 +5,11 @@
 [![Release](https://img.shields.io/github/v/release/mattermost/mattermost-plugin-profanity-filter)](https://github.com/mattermost/mattermost-plugin-profanity-filter/releases/latest)
 [![HW](https://img.shields.io/github/issues/mattermost/mattermost-plugin-profanity-filter/Up%20For%20Grabs?color=dark%20green&label=Help%20Wanted)](https://github.com/mattermost/mattermost-plugin-profanity-filter/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22Up+For+Grabs%22+label%3A%22Help+Wanted%22)
 
-
-This plugin allows you to censor profanity on your Mattermost server. The plugin checks all messages for matches against the configured "Bad Words List" before they are posted to any channel. The characters in any word matches are replaced with a series of "*"s.
+This plugin allows you to censor profanity on your Mattermost server. The plugin checks all messages for matches against the configured "Bad words list" before they are posted to any channel. The characters in any word matches are replaced with a series of "\*"s.
 
 **Supported Mattermost Server Versions: 5.2+**
 
-## Plugin Marketplace 
+## Plugin Marketplace
 
 1. Go to **Main Menu > Plugin Marketplace** in Mattermost.
 2. Search for "Profanity Filter" or manually find the plugin from the list and click **Install**
@@ -24,4 +23,10 @@ This plugin allows you to censor profanity on your Mattermost server. The plugin
 
 ### Usage
 
-You can edit the bad words list in **System Console > Plugins > Profanity Filter > Bad Words list**.
+You can edit the bad words list in **System Console > Plugins > Profanity Filter > Bad words list**.
+
+Choose to either censor the bad words with a character or reject the post with a custom warning message:
+
+![Post rejected by the plugin](./.github/post-rejected.gif)
+
+![Post censored by the plugin](./.github/post-censored.gif)

plugin.json

@@ -18,6 +18,14 @@
         "type": "bool",
         "help_text": "If set the plugin will reject posts containing profanity instead of censoring."
       },
+      {
+        "key": "WarningMessage",
+        "display_name": "Warning Message",
+        "type": "text",
+        "help_text": "If Reject Posts is enabled, this message will be sent to the user to warn him. Use `%s` in the message if you want to cite the forbidden word. Markdown formatted.",
+        "placeholder": "Ex. Your post has been rejected by the Profanity Filter, because the following word is not allowed: `%s`.",
+        "default": "Your post has been rejected by the Profanity Filter, because the following word is not allowed: `%s`."
+      },
       {
         "key": "CensorCharacter",
         "display_name": "Censor Character",
@@ -37,4 +45,4 @@
     "header": "",
     "footer": ""
   }
-}
+}

server/configuration.go

@@ -22,6 +22,7 @@ type configuration struct {
 	RejectPosts     bool
 	CensorCharacter string
 	BadWordsList    string
+	WarningMessage  string `json:"WarningMessage"`
 }
 
 // Clone shallow copies the configuration. Your implementation may require a deep copy if

server/plugin.go

@@ -1,6 +1,7 @@
 package main
 
 import (
+	"fmt"
 	"strings"
 	"sync"
 	"unicode"
@@ -39,6 +40,11 @@ func (p *Plugin) FilterPost(post *model.Post) (*model.Post, string) {
 	for i, word := range words {
 		if p.WordIsBad(word) {
 			if configuration.RejectPosts {
+				p.API.SendEphemeralPost(post.UserId, &model.Post{
+					ChannelId: post.ChannelId,
+					Message:   fmt.Sprintf(configuration.WarningMessage, word),
+					RootId:    post.RootId,
+				})
 				return nil, "Profane word not allowed: " + word
 			}
 			words[i] = strings.Repeat(configuration.CensorCharacter, len(word))