Calculando os tópicos "Top" no Discourse

Documentação Usando Discourse
,
1

:bookmark: Este é um guia de referência que explica como os tópicos filtrados por “Principais” são determinados como “Tópicos Principais” no Discourse.

:person_raising_hand: Nível de usuário necessário: Todos os usuários

Os sites do Discourse têm um recurso que permite aos usuários classificar os tópicos por “Principais”. Este guia explica como esses tópicos “Principais” são calculados e exibidos.

Resumo

  • Todos os tópicos “Principais” recebem uma “Pontuação Principal”
  • A pontuação é baseada em curtidas, respostas e visualizações em um período de tempo selecionado
  • Os tópicos com a maior “Pontuação Principal” aparecem no topo da lista

Cálculo da Pontuação Principal

A “Pontuação Principal” de um tópico é calculada usando os seguintes fatores:

  1. Número de visualizações
  2. Curtidas na primeira postagem
  3. Curtidas em postagens subsequentes
  4. Número de respostas

O cálculo usa três configurações do site como multiplicadores:

Etapas de cálculo

Calcule uma pontuação principal para cada tópico, somando o seguinte:

  1. O número de visualizações para cada tópico no período selecionado multiplicado pelo log views multiplier
  2. O número de curtidas na postagem original do tópico multiplicado pelo first post likes multiplier
  3. O menor entre:
    • As curtidas médias por postagem (curtidas totais no tópico divididas pelo número de postagens)
    • O valor do least likes per post multiplier
  4. Se o período tiver menos de 10 postagens, execute o seguinte cálculo:
    0 - ((10 - número de postagens no tópico) / 20) * número de curtidas na postagem original
    Caso contrário, -10
  5. O número de postagens no tópico

Visualizando Tópicos Principais

Você pode ver um exemplo de Tópicos Principais em um site do Discourse na imagem abaixo:

Exemplo de Tópicos Principais em um site
Exemplo de Tópicos Principais em um site2396×807 58.7 KB

Recursos adicionais

Para mais detalhes técnicos, você pode consultar:

  • O código-fonte Ruby para o cálculo principal: discourse/app/models/top_topic.rb at main · discourse/discourse · GitHub
  • Esta consulta do Data Explorer para ver a “Pontuação Principal” exata para cada tópico:
    -- [params]
-- date :start_date = 26 apr 2020
-- date :end_date = 2 may 2020
-- double :log_views_multiplier = 2.0
-- double :first_post_likes_multiplier = 0.5
-- double :least_likes_per_post_multiplier = 3.0

WITH likes AS (
SELECT topic_id, SUM(like_count) AS count
FROM posts
WHERE created_at::date >= :start_date::date
  AND created_at::date < :end_date::date
  AND deleted_at IS NULL
  AND NOT hidden
  AND post_type = 1
GROUP BY topic_id
),
op_likes AS (
SELECT topic_id, like_count AS count
FROM posts
WHERE created_at::date >= :start_date::date
  AND created_at::date < :end_date::date
  AND post_number = 1
  AND deleted_at IS NULL
  AND NOT hidden
  AND post_type = 1
),
posts AS (
SELECT topic_id, GREATEST(COUNT(*), 1) AS count
FROM posts
WHERE created_at::date >= :start_date::date
  AND created_at::date < :end_date::date
  AND deleted_at IS NULL
  AND NOT hidden
  AND post_type = 1
  AND user_id <> 0
GROUP BY topic_id
),
views AS (
SELECT topic_id, COUNT(*) AS count
FROM topic_views
WHERE viewed_at::date >= :start_date::date
  AND viewed_at::date < :end_date::date
GROUP BY topic_id
),
category_definition_topic_ids AS (
  SELECT COALESCE(topic_id, 0) AS id FROM categories
),
top_topics AS(
SELECT
topics.id AS topic_id,
topics.title,
topics.user_id,
posts.count AS date_range_posts,
views.count AS date_range_views,
topics.views AS all_time_views,
topics.bumped_at,
(CASE
 WHEN topics.created_at::date < :start_date::date
  AND topics.created_at::date >= :end_date::date
 THEN 0
 ELSE log(GREATEST(views.count, 1)) * :log_views_multiplier +
    op_likes.count * :first_post_likes_multiplier +
    CASE WHEN likes.count > 0 AND posts.count > 0
       THEN
        LEAST(likes.count / posts.count, :least_likes_per_post_multiplier)
       ELSE 0
    END +
    CASE WHEN topics.posts_count < 10 THEN
       0 - ((10 - topics.posts_count) / 20) * op_likes.count
    ELSE
       10
    END +
    log(GREATEST(posts.count, 1))
 END) AS score
FROM posts
INNER JOIN views ON posts.topic_id = views.topic_id
INNER JOIN likes ON posts.topic_id = likes.topic_id
INNER JOIN op_likes ON posts.topic_id = op_likes.topic_id
LEFT JOIN topics ON topics.id = posts.topic_id AND topics.deleted_at IS NULL
WHERE topics.deleted_at IS NULL
  AND topics.visible
  AND topics.archetype <> 'private_message'
  AND NOT topics.archived
  AND topics.id NOT IN (SELECT id FROM category_definition_topic_ids)
ORDER BY
  score DESC,
  topics.bumped_at DESC
)

SELECT * FROM top_topics WHERE score > 0
12 curtidas
4

É possível incluir ‘votos’ neste cálculo?

5

Estes agora estão ocultos, então você não os verá nas configurações do site