From 94ae029a4a897c3a8fc04d2a97df9a59cd551930 Mon Sep 17 00:00:00 2001 From: Heng Yeow Date: Fri, 26 Oct 2018 13:54:37 +0800 Subject: [PATCH 1/5] Create 02-03-cli-tools.md --- docs/source/02-03-cli-tools.md | 181 +++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 docs/source/02-03-cli-tools.md diff --git a/docs/source/02-03-cli-tools.md b/docs/source/02-03-cli-tools.md new file mode 100644 index 000000000..5d5df0864 --- /dev/null +++ b/docs/source/02-03-cli-tools.md @@ -0,0 +1,181 @@ +--- +title: Configuration with CLI tools +permalink: /configuration-cli-tools/ +class: configuration +toc: true +--- + +Talk can be configured using CLI tools. The CLI tools are available through `./bin/cli`. Below is a list of commands available: +``` + Usage: cli [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + serve serve the application + db run database commands + settings interact with the application settings + assets interact with assets + setup setup the application + jobs work with the job queues + token work with the access tokens + users work with the application auth + migration provides utilities for migrating the database + plugins provides utilities for interacting with the plugin system + help [cmd] display help for [cmd] +``` + +## Serving the application +To serve the application, run `./bin/cli serve`. Please check that you have installed the Talk before doing this step. Below is a list of additional options available for this command: +``` + Usage: cli-serve [options] + + Options: + + -j, --jobs enable job processing on this thread + --disabled-jobs disable jobs specified if the -j option is passed, specified as a comma separated list (default: ) + -w, --websockets enable the websocket (subscriptions) handler on this thread + -h, --help output usage information +``` + +## Database commands +You can also run database commands using `./bin/cli db`. Below is a list of additional options available for this command: +``` + Usage: cli-db [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + createIndexes creates the database indexes and waits until they are created +``` + +## Application settings +You can also change application settings using `./bin/cli settings`. Below is a list of additional options available for this command: +``` + Usage: cli-settings [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + change-org-name change the organization name +``` + +## Interaction with assets +You can also interact with your application's assets using `./bin/cli assets`. Below is a list of additional options available for this command: +``` +Usage: cli-assets [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + list [options] list all the assets in the database + refresh [age] queues the assets that exceed the age requested + update-url update the URL of an asset + merge merges two assets together by moving comments from src to dst and deleting the src asset + rewrite [options] rewrites asset url's using the provided regex replacement pattern +``` + +## Setting up the application +You can also run a setup wizard to setup the wizard using `./bin/cli setup`. Below is a list of additional options available for this command: +``` + Usage: cli-setup [options] + + runs the setup wizard to setup the application + + Options: + + --defaults apply defaults for config instead of prompting + -h, --help output usage information +``` + +## Working with job queues +You can also work with job queues using `./bin/cli jobs`. Below is a list of additional options available for this command: +``` + Usage: cli-jobs [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + process starts job processing + cleanup [options] cleans up inactive jobs +``` + +## Working with access tokens +You can also work with access tokens using `./bin/cli token`. Below is a list of additional options available for this command: +``` + Usage: cli-token [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + list list tokens for a user + revoke revokes a token with a given id + create create a token for a user with a given name +``` + +## Working with your application's authentication +You can also work with your application's authentication using `./bin/cli users`. Below is a list of additional options available for this command: +``` +Usage: cli-users [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + create creates a local user + delete delete a user + list searches for a user based on their stored username and email + set-role sets the role on a user + verify verifies the given user's email address +``` + +## Migrating your database +Talk provides utilities for migrating your database using `./bin/cli migration`. Below is a list of additional options available for this command: +``` + Usage: cli-migration [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + create creates a new migration + run [options] runs all pending migrations +``` + +## Interacting with the plugin system +Talk provides utilities to interact with the plugin system using `./bin/cli plugins`. Below is a list of additional options available for this command: +``` + Usage: cli-plugins [options] [command] + + Options: + + -h, --help output usage information + + Commands: + + create creates a seed plugin + list + reconcile [options] reconciles dependencies by downloading external plugins +``` From c4de69218c445b2dac1438b7063896b4f8959be7 Mon Sep 17 00:00:00 2001 From: Heng Yeow Date: Fri, 26 Oct 2018 13:55:30 +0800 Subject: [PATCH 2/5] Update _config.yml --- docs/_config.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/_config.yml b/docs/_config.yml index 041054bda..3ad74d56b 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -98,6 +98,8 @@ sidebar: url: /configuration/ - title: Advanced Configuration url: /advanced-configuration/ + - title: Configuration with CLI tools + url: /configuration-cli-tools/ - title: Integrating children: - title: Authentication From 52f2f4838514c4871e971b51806e255da6421c04 Mon Sep 17 00:00:00 2001 From: immber Date: Mon, 29 Oct 2018 16:05:26 -0700 Subject: [PATCH 3/5] updated mod queues documentation --- .../03-03-product-guide-moderator-features.md | 84 ++++++++++++++----- 1 file changed, 63 insertions(+), 21 deletions(-) diff --git a/docs/source/03-03-product-guide-moderator-features.md b/docs/source/03-03-product-guide-moderator-features.md index abb2c454a..306b2ad11 100644 --- a/docs/source/03-03-product-guide-moderator-features.md +++ b/docs/source/03-03-product-guide-moderator-features.md @@ -5,7 +5,7 @@ permalink: /moderator-features/ ## The Talk Admin -The Admin is your moderators will moderate your comments, and your Admins will +The Admin is where your moderators will moderate your comments, and your Admins will configure and manage the different parts of Talk. ### Moderate @@ -18,57 +18,99 @@ site-wide. **New** -The New queue contains all comments that have not been moderated yet. +>_Conditions:_ Pre-Mod disabled -**Reported** +Comments have been published? _**Yes**_ -The Reported queue contains all comments that need moderator attention. +The New queue contains all comments that have not been moderated yet. This queue contains comments that haven’t yet been Accepted or Rejected by a moderator -**Approved** +**Pre-mod** -The Approved queue contains all approved comments. +>_Conditions:_ Pre-Mod enabled + +Comments have been published? _**No**_ + +This queue contains comments that haven’t yet been Accepted or Rejected by a moderator + +**Accepted** + +Comments have been published? _**Yes**_ + +Comments that have been approved by a moderator, written by a Staff member (and so auto approved), or Featured (and so auto approved). Tags for reports still appear on comments in this queue, but the comments will not go back into Reported. **Rejected** -The Rejected queue contains all comments that have been rejected, either -manually by moderators or automatically, e.g. they have used a banned word. +Comments have been published? _**No**_ + +Comments that have been rejected by a moderator, or rejected because they contained a banned word/phrase. Tags for reports still appear on comments in this queue, but the comments will not go back into Reported. + + +**Reported** + +>_Conditions:_ Pre-Mod disabled + +Comments have been published? _**depends**_ + +This queue contains comments that have been reported for moderator review, either by users or automatically by Talk, and have not yet been Approved or Rejected. If there are comments to review in this queue, a red dot will be displayed in the top menu. **All** The All queue contains all comments that have been submitted either article or site-wide. -#### Moderation Badges +#### Moderation Tags **Pre-mod** -The Pre-mod badge signifies comments that are being pre-modded. +_Comment published? No_ + +The Pre-mod tag signifies comments that are being pre-modded. **User** -The User badge signifies comments that have been reported by another user. +_Comment published? Yes_ -**History** +Comment has been reported by a user. The ‘More Details’ box contains the name/s of the users who reported the comment, and any additional information they provided. + +**Staff** + +_Comment published? Yes_ + +Comment has been reported by a staff member. The ‘More Details’ box contains the name/s of the staff member who reported the comment, and any additional information they provided. + +**Suspect Word** + +_Comment published? Yes_ + +Comment contains a word or phrase that is on the ’Suspect words’ list in the Configure > Moderation tab (administrators only). The word/phrase will be highlighted in yellow. + +**Karma** + +_Comment published? No_ + +The History tag signifies comments that have been flagged because the user’s history indicates their Accepted:Rejected ratio has reached below the karma threshold. [Read more here...](/talk/trust/#user-karma-score) + +**Spam** + +_Comment published? No_ + +If you are using the Akismet anti-spam plugin, this tag means that Akismet has flagged the comment as spam. You must Approve it for it to appear in the stream. **Requires:** [talk-plugin-akismet](/talk/plugin/talk-plugin-akismet/) -The History badge signifies comments that have been flagged because of a user’s -history. **Toxic** -The Toxic badge signifies comments that are above the set Toxicity Probability -Threshold. Note you must have [talk-plugin-toxic-comments](/talk/additional-plugins/#talk-plugin-toxic-comments) enabled. -[Read more about Toxic Comments here](/talk/toxic-comments/). +_Comment published? No_ -**Suspect** +If you are using the Toxic Comments plugin, this tag means that Perspective API has flagged the comment as likely to be toxic, above the threshold you have set (default: 80%). You must Approve it for it to appear in the stream. **Requires:** [talk-plugin-toxic-comments](/talk/additional-plugins/#talk-plugin-toxic-comments). +Read more about [Toxic Comments here](/talk/toxic-comments/). -The Suspect badge signifies comments that contain a Suspect Word. **Contains Link** -The Contains Link badge signifies a comment that contains a link, which can +The Contains Link tag signifies a comment that contains a link, which can sometimes mean it is a spam or ad comment. -**Flag Details View** +**More Details View** At the bottom of each comment in the moderation queues, you can see more information about a comment’s flags by clicking on More Detail. From 0ce0d57a96d010141ae14887e96f1442c67b6f75 Mon Sep 17 00:00:00 2001 From: Kim Gardner Date: Tue, 30 Oct 2018 15:45:26 +0000 Subject: [PATCH 4/5] Spanish translation tweak #1 --- plugins/talk-plugin-auth/client/translations.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/talk-plugin-auth/client/translations.yml b/plugins/talk-plugin-auth/client/translations.yml index caae962bb..4ff4fb994 100644 --- a/plugins/talk-plugin-auth/client/translations.yml +++ b/plugins/talk-plugin-auth/client/translations.yml @@ -219,7 +219,7 @@ es: register: "Registrar" sign_up: "Registro" confirm_password: "Confirmar Contraseña" - username: "Nombre" + username: "Nombre de Usuario" already_have_an_account: "¿Ya tienes una cuenta?" recover_password: "Recuperar la contraseña" email_in_use: "Este correo se encuentra en uso" From 53abb65da198aed6d591c024b9da2650471f88ac Mon Sep 17 00:00:00 2001 From: Andrew Losowsky Date: Thu, 1 Nov 2018 15:08:08 -0400 Subject: [PATCH 5/5] Updated text - updated User Drawer information - updated Shortcuts information - changed the order --- .../03-03-product-guide-moderator-features.md | 69 +++++++++++-------- 1 file changed, 39 insertions(+), 30 deletions(-) diff --git a/docs/source/03-03-product-guide-moderator-features.md b/docs/source/03-03-product-guide-moderator-features.md index 306b2ad11..3b6c4f1c4 100644 --- a/docs/source/03-03-product-guide-moderator-features.md +++ b/docs/source/03-03-product-guide-moderator-features.md @@ -58,7 +58,7 @@ This queue contains comments that have been reported for moderator review, eithe The All queue contains all comments that have been submitted either article or site-wide. -#### Moderation Tags +#### Moderation Tags that appear in Reported/other queues **Pre-mod** @@ -88,7 +88,7 @@ Comment contains a word or phrase that is on the ’Suspect words’ list in the _Comment published? No_ -The History tag signifies comments that have been flagged because the user’s history indicates their Accepted:Rejected ratio has reached below the karma threshold. [Read more here...](/talk/trust/#user-karma-score) +The History tag signifies comments that have been flagged because the user’s history indicates their Accepted:Rejected ratio has reached below the karma threshold. [Read more about karma here.](/talk/trust/#user-karma-score) **Spam** @@ -130,9 +130,35 @@ Rejecting a comment removes the comment from the stream. Featuring a comment adds that comment to the Featured Comments tab on the stream. +#### Keyboard Shortcuts + +Talk also supports a number of keyboard shortcuts that moderators can leverage +to moderate queues quickly: + +| Shortcut | Action | +| -------- | -------------------------- | +| `j` | Go to the next comment | +| `k` | Go to the previous comment | +| `ctrl+f` | Open search | +| `1-5` | Switch queues | +| `z` | Zen mode | +| `?` | Open shortcuts menu | +| `d` | Approve | +| `f` | Reject | + +Note: "Zen mode" allows a moderator to view and action only one comment at a time. Enjoy the silence! + +#### The User Drawer + +In order to get an idea of what sort of a commenter someone is, moderators can +click on the commenter's username in any moderation queue/elsewhere in the admin (eg the Community page) to see details about +their comments, and to take actions. + +#### User Drawer Actions + **Suspend User** -Suspending a user allows a moderator to give a commenter a “time-out”; during +Suspending a user allows a moderator to give a commenter a “time-out” for a set time chosen from four options; during that time they won’t be allowed to post comments or react to comments. **Ban User** @@ -141,15 +167,13 @@ Banning a user allows a moderator to permanently disallow a commenter to interact with their community. The commenters previous comments will remain on the site. This action can only be un-done manually by a moderator. -#### Viewing a User’s Comment History +**Reject Username** -In order to get an idea of what sort of a commenter someone is, moderators can -click on the commenters username in any moderation queue and see details about -their history. +If a username is violating your guidelines but isn't bad enough to lead to a ban (eg. they are impersonating a famous person), you can reject their username. This will prevent them from publishing comments until they submit a new username. The new name will appear on the Community page for moderator approval before they can publish comments again. **Username, Email and Member Since Date** -This shows the basic details about a commenter. +This shows the basic details about a commenter's account **Total Comments** @@ -161,32 +185,17 @@ display on the site. This shows the % of comments a commenter has had rejected by moderators, or automatically. -**Reports** +**Karma score** -This shows if a commenter is a reliable flagger, an unreliable flagger, or a -neutral flagger. [Read more about reliable and unreliable flaggers here](/talk/trust/#reliable-and-unreliable-flaggers). +The user's current score. To see the default threshhold, click on the 'i' next to the word Karma. If the user's score is equal to or below the default threshhold, the number will be highlighted red. [Read more about karma scores here.](/talk/trust/#user-karma-score) + +**User History** + +This shows the history of the account - if a user has changed their username, or been suspended or banned. The name of the moderator who suspended/banned them/lifted the suspection or ban is displayed here as well. **Moderating from this View** -Talk also allows you to moderate a commenters recent comments from this view. - -#### Keyboard Shortcuts - -Talk also supports a number of keyboard shortcuts that moderators can leverage -to moderate quickly: - -| Shortcut | Action | -| -------- | -------------------------- | -| `j` | Go to the next comment | -| `k` | Go to the previous comment | -| `ctrl+f` | Open search | -| `t` | Switch queues | -| `z` | Zen mode | -| `?` | Open this menu | -| `d` | Approve | -| `f` | Reject | - -Note: "Zen mode" allows a moderator to view and action only one comment at a time. Enjoy the silence! +Talk also allows you to moderate a commenters recent comments from this view. You can 'Select all' to select up to ten previous comments, and take bulk accept/reject actions. ### Stories