patreon auth

site/src/docs/configuration/authorization/index.md

@@ -73,6 +73,12 @@ _instructions for Google OAuth2 setup borrowed from [oauth2_proxy](https://githu
 
 For more details refer to [Yandex OAuth](https://yandex.com/dev/oauth/doc/dg/concepts/about.html) and [Yandex.Passport](https://yandex.com/dev/passport/doc/dg/index.html) API documentation.
 
+### Patreon Auth provider
+1. Create a new Patreon client https://www.patreon.com/portal/registration/register-clients
+2. Fill **App Name**, **Description**
+3. In the field **Redirect URIs** enter the correct URI constructed as domain + `/auth/patreon/callback`, i.e. `https://example.mysite.com/auth/patreon/callback`
+4. Expand client details, take a note of the **Client ID** and **Client Secret**. Those will be used as `AUTH_PATREON_CID` and `AUTH_PATREON_CSEC`
+
 ## Anonymous Auth Provider
 
 Optionally, anonymous access can be turned on. In this case, an extra `anonymous` provider will allow logins without any social login with any name satisfying 2 conditions:

site/src/docs/contributing/api/index.md

@@ -15,6 +15,7 @@ type User struct {
     Admin    bool   `json:"admin"`
     Blocked  bool   `json:"block"`
     Verified bool   `json:"verified"`
+    PaidSub  bool   `json:"paid_sub"` // is paid Patreon subscriber
 }
 ```
 
@@ -113,18 +114,19 @@ type PostInfo struct {
 
 ```go
 type Config struct {
-    Version        string   `json:"version"`
-    EditDuration   int      `json:"edit_duration"`
-    MaxCommentSize int      `json:"max_comment_size"`
-    Admins         []string `json:"admins"`
-    AdminEmail     string   `json:"admin_email"`
-    Auth           []string `json:"auth_providers"`
-    LowScore       int      `json:"low_score"`
-    CriticalScore  int      `json:"critical_score"`
-    PositiveScore  bool     `json:"positive_score"`
-    ReadOnlyAge    int      `json:"readonly_age"`
-    MaxImageSize   int      `json:"max_image_size"`
-    EmojiEnabled   bool     `json:"emoji_enabled"`
+    Version         string   `json:"version"`
+    EditDuration    int      `json:"edit_duration"`
+    MaxCommentSize  int      `json:"max_comment_size"`
+    Admins          []string `json:"admins"`
+    AdminEmail      string   `json:"admin_email"`
+    Auth            []string `json:"auth_providers"`
+    LowScore        int      `json:"low_score"`
+    CriticalScore   int      `json:"critical_score"`
+    PositiveScore   bool     `json:"positive_score"`
+    ReadOnlyAge     int      `json:"readonly_age"`
+    MaxImageSize    int      `json:"max_image_size"`
+    EmojiEnabled    bool     `json:"emoji_enabled"`
+    SubscribersOnly bool     `json:"subscribers_only"` // enable commenting only for Patreon subscribers
 }
 ```