mirror of
https://github.com/wassname/talk.git
synced 2026-06-29 02:48:05 +08:00
Kim Gardner
105 lines
4.5 KiB
Markdown
105 lines
4.5 KiB
Markdown
---
|
||
title: Additional Plugins
|
||
permalink: /additional-plugins/
|
||
class: configuration
|
||
---
|
||
|
||
Talk ships with several plugins that aren't enabled by default:
|
||
|
||
{% include toc.html %}
|
||
|
||
These plugins can be enabled by consulting the
|
||
[Plugins Overview]({{ "/plugins/" | relative_url }}) page.
|
||
|
||
## talk-plugin-like
|
||
|
||
Source: [plugins/talk-plugin-like](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-like){:target="_blank"}
|
||
|
||
Enables a `like` reaction button.
|
||
|
||
## talk-plugin-sort-most-liked
|
||
|
||
Source: [plugins/talk-plugin-sort-most-liked](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-most-liked){:target="_blank"}
|
||
|
||
Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewing-options" | relative_url }}){:.param}, [talk-plugin-like](#talk-plugin-like){:.param}
|
||
|
||
Provides a sort for the comments with the most `like` reactions first.
|
||
|
||
## talk-plugin-love
|
||
|
||
Source: [plugins/talk-plugin-love](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-love){:target="_blank"}
|
||
|
||
Enables a `love` reaction button.
|
||
|
||
## talk-plugin-sort-most-loved
|
||
|
||
Source: [plugins/talk-plugin-sort-most-loved](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-most-loved){:target="_blank"}
|
||
|
||
Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewing-options" | relative_url }}){:.param}, [talk-plugin-love](#talk-plugin-love){:.param}
|
||
|
||
Provides a sort for the comments with the most `love` reactions first.
|
||
|
||
## talk-plugin-remember-sort
|
||
|
||
Source: [plugins/talk-plugin-remember-sort](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-remember-sort){:target="_blank"}
|
||
|
||
Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewing-options" | relative_url }}){:.param}
|
||
|
||
Enables saving a user’s last sort selection as they browse other articles.
|
||
|
||
## talk-plugin-deep-reply-count
|
||
|
||
Source: [plugins/talk-plugin-deep-reply-count](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-deep-reply-count){:target="_blank"}
|
||
|
||
Enables counting of comments to include replies via a new graph edge. Not
|
||
recommended for large installations as it will unreasonably reduce the query
|
||
efficiency to compute this number.
|
||
|
||
## talk-plugin-slack-notifications
|
||
|
||
Source: [plugins/talk-plugin-slack-notifications](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-slack-notifications){:target="_blank"}
|
||
|
||
Enables all new comments that are written to be posted to a Slack channel as
|
||
well. Configure an
|
||
[Incoming Webhook](https://api.slack.com/incoming-webhooks){:target="_blank"}
|
||
app and provide that url in the form of the `SLACK_WEBHOOK_URL`
|
||
detailed below.
|
||
|
||
*Warning: On high volume sites, this means every single comment will flow into
|
||
Slack, if this isn't what you want, be sure to use the provided plugin as a
|
||
recipe to further customize the behavior*.
|
||
|
||
Configuration:
|
||
|
||
- `SLACK_WEBHOOK_URL` (**required**) - The webhook url that will be
|
||
used to post new comments to.
|
||
|
||
## talk-plugin-toxic-comments
|
||
|
||
Source: [plugins/talk-plugin-toxic-comments](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-toxic-comments){:target="_blank"}
|
||
|
||
Using the [Perspective API](http://perspectiveapi.com/){:target="_blank"}, this
|
||
plugin will warn users and reject comments that exceed the predefined toxicity
|
||
threshold. For more information on what Toxic Comments are, check out the
|
||
[Toxic Comments]({{ "/toxic-comments/" | relative_url }}) documentation.
|
||
|
||
Configuration:
|
||
|
||
- `TALK_PERSPECTIVE_API_KEY` (**required**) - The API Key for Perspective. You
|
||
can register and get your own key at [http://perspectiveapi.com/](http://perspectiveapi.com/){:target="_blank"}.
|
||
- `TALK_TOXICITY_THRESHOLD` - If the comments toxicity exceeds this threshold,
|
||
the comment will be rejected. (Default `0.8`)
|
||
- `TALK_PERSPECTIVE_API_ENDPOINT` - API Endpoint for hitting the
|
||
perspective API. (Default `https://commentanalyzer.googleapis.com/v1alpha1`)
|
||
- `TALK_PERSPECTIVE_TIMEOUT` - The timeout for sending a comment to
|
||
be processed before it will skip the toxicity analysis, parsed by
|
||
[ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `300ms`)
|
||
|
||
## talk-plugin-subscriber
|
||
|
||
Source: [plugins/talk-plugin-subscriber](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-subscriber){:target="_blank"}
|
||
|
||
Enables a `Subscriber` badge to be added to comments where the author has the
|
||
`SUBSCRIBER` tag. This must match with a custom auth integration that adds the
|
||
tag to the users that are subscribed to the service.
|