Merge branch 'descriptions-fixes' into 'develop'
[akkoma] / docs / configuration / howto_user_recomendation.md
1 # How to activate user recommendation (Who to follow panel)
2 ![who-to-follow-panel-small](/uploads/9de1b1300436c32461d272945f1bc23e/who-to-follow-panel-small.png)
3
4 To show the *who to follow* panel, edit `config/prod.secret.exs` in the Pleroma backend. Following code activates the *who to follow* panel:
5
6 ```elixir
7 config :pleroma, :suggestions,
8 enabled: true,
9 third_party_engine:
10 "http://vinayaka.distsn.org/cgi-bin/vinayaka-user-match-suggestions-api.cgi?{{host}}+{{user}}",
11 timeout: 300_000,
12 limit: 40,
13 web: "https://vinayaka.distsn.org"
14
15 ```
16
17 `config/config.exs` already includes this code, but `enabled:` is `false`.
18
19 `/api/v1/suggestions` is also provided when *who to follow* panel is enabled.
20
21 For advanced customization, following code shows the newcomers of the fediverse at the *who to follow* panel:
22
23 ```elixir
24 config :pleroma, :suggestions,
25 enabled: true,
26 third_party_engine:
27 "http://vinayaka.distsn.org/cgi-bin/vinayaka-user-new-suggestions-api.cgi?{{host}}+{{user}}",
28 timeout: 60_000,
29 limit: 40,
30 web: "https://vinayaka.distsn.org/user-new.html"
31 ```