From 4ae99207320891c3676de17099b27a5fa5c6d254 Mon Sep 17 00:00:00 2001
From: Kim Gardner <kgardnr@gmail.com>
Date: Wed, 7 Mar 2018 17:11:08 -0500
Subject: [PATCH] Add Notifications docs

---
 docs/source/02-05-configuring-moderation.md | 54 ---------------
 docs/source/02-06-notifications.md          | 75 +++++++++++++++++++++
 2 files changed, 75 insertions(+), 54 deletions(-)
 delete mode 100644 docs/source/02-05-configuring-moderation.md
 create mode 100644 docs/source/02-06-notifications.md

diff --git a/docs/source/02-05-configuring-moderation.md b/docs/source/02-05-configuring-moderation.md
deleted file mode 100644
index 134d94209..000000000
--- a/docs/source/02-05-configuring-moderation.md
+++ /dev/null
@@ -1,54 +0,0 @@
----
-title: Configuring the Talk Admin
-permalink: /configuring-the-admin//
-class: configuration
-toc: true
----
-
-Using plugins and configuration variables, you can modify the way the Admin looks and how moderation works.
-
-### Creating a Custom Moderation Queue
-
-Talk can support custom pluggable mod queues, meaning you can write a plugin that has some logic and determines which comments should appear there. This works by adding a field modQueues` in the `index.js` of your client side plugin, like so:
-
-```
-	modQueues: {
-		newQueueKey: {
-
-		 // name
-		 name: 'My Queue Name',                    
-
-		 // material design icon
-		 icon: 'star',        
-
-		 // Filter by tags
-		 tags: ['MY_TAG'],                       
-
-		 // Filter by statuses
-		 statuses: ['NONE', 'PREMOD', 'ACCEPTED', 'REJECTED'],   
-
-		// Filter by comment containing action_type
-		action_type: 'FLAG',                    
-
-	 },
-	},
-```
-
-
-So if we wanted to make a Featured queue, we could do this like so:
-
-```
-	modQueues: {
-		featured: {
-			tags: ['FEATURED'],
-			icon: 'star',
-			name: 'Featured',
-		},
-	},
-```
-
-For more information, see here: https://github.com/coralproject/talk/pull/849
-
-### Flag Details
-
-To show more detailed information about reporting/flags, you can enable `talk-plugin-flag-details`.
diff --git a/docs/source/02-06-notifications.md b/docs/source/02-06-notifications.md
new file mode 100644
index 000000000..58217349d
--- /dev/null
+++ b/docs/source/02-06-notifications.md
@@ -0,0 +1,75 @@
+---
+title: Notifications
+permalink: /notifications//
+class: configuration
+toc: true
+---
+
+Talk currently supports 3 types of email notifications.
+
+
+1. When someone replies to my comment
+2. When a staff member replies to my comment
+3. When my comment gets featured
+
+Talk support 3 options for notification frequency: immediately, hourly or daily. Commenters can also opt-out of email notifications. Notifications are set to OFF by default.
+
+Commenters cannot enable notifications until they have verified their email.
+
+Note: Notifications are not currently supported for users that sign-up via Facebook or Google auth, or don't have an email attached to their account for any other reason.
+
+### Configuring SMTP
+
+You must setup SMTP to use notifications. The following ENV variables must be set:
+
+```
+TALK_SMTP_FROM_ADDRESS=email@email.com
+TALK_SMTP_USERNAME=username
+TALK_SMTP_PASSWORD=password
+TALK_SMTP_HOST=smtp.domain.net
+TALK_SMTP_PORT=2525
+```
+
+### Enabling Notifications
+
+Enabling the `talk-plugin-notifications` creates a NotificationManager that creates and manages events send from the event emitter that is linked to the Graph API PubSub system.
+
+Adding the `talk-plugin-notifications` plugin will also enable the `notifications` plugin hook. Any plugin that registers before the `talk-plugin-notifications` plugin will get picked up by.
+
+See https://github.com/coralproject/talk/blob/8b669a31c551a042f0f079d8cfc16825673eb8f0/plugins/talk-plugin-notifications-reply/index.js for an example.
+
+### Commenter Notification Settings
+
+Note that notifications REQUIRE the `talk-plugin-profile-settings` plugin; this is where on My Profile commenters will enable and manage their notification settings.
+
+### Notification Categories
+
+Talk currently supports the following Notifications options out of the box:
+
+`talk-plugin-notifications-category-reply`
+`talk-plugin-notifications-category-staff-reply`
+`talk-plugin-notifications-category-featured`
+
+### Notification Digests
+
+Talk supports hourly and daily digests out the box, if you would like to create your own, refer to the below:
+
+https://github.com/coralproject/talk/blob/9cc9969320dca47bb0f8f81e8d944ae4d19e548b/plugins/talk-plugin-notifications/server/connect.js#L69-L102
+        
+### Connect API
+
+This exposes the `graph/connectors.js` via the `connect` hook.
+
+```
+  module.exports = {
+    connect(connectors) {
+      // use `connectors`, contents of https://github.com/coralproject/talk/blob/b758dc91cb1f1969ecd895b6059306b318995b33/graph/connectors.js#L104
+    }
+  }
+```
+
+See https://github.com/coralproject/talk/blob/90290cfa2de88e62f687e1ed0235ba6dfe4cde26/plugins/talk-plugin-notifications/server/connect.js for an example.
+        
+### Email Templates
+
+Email templates are text based and support translations. If you would like to create a new email template, you can register it via the Connect API, see https://github.com/coralproject/talk/blob/8b669a31c551a042f0f079d8cfc16825673eb8f0/plugins/talk-plugin-notifications/server/connect.js#L12-L28###