Calculando tópicos "Principais" no Discourse

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

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

Os sites Discourse possuem um recurso que permite aos usuários classificar tópicos por “Mais Acessados” (Top). Este guia explica como esses tópicos “Mais Acessados” são calculados e exibidos.

Resumo

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

Cálculo da Pontuação de Mais Acessado

A “Pontuação de Mais Acessado” para 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 ocultas do site como multiplicadores (estas não são visíveis na interface de configurações de administrador, mas podem ser alteradas através do console Rails ou API):

  • top topics formula log views multiplier (padrão: 2)
  • top topics formula first post likes multiplier (padrão: 0.5)
  • top topics formula least likes per post multiplier (padrão: 3)

Etapas do Cálculo

Calcule uma pontuação de mais acessado para cada tópico somando o seguinte:

  1. O logaritmo do número de visualizações (mínimo 1) 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:
    • A média de curtidas por postagem (total de curtidas no tópico dividido pelo número de postagens)
    • O valor least likes per post multiplier
  4. Se o período tiver menos de 10 postagens, realize 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 logaritmo do número de postagens (mínimo 1) no tópico

Visualizando Tópicos Mais Acessados

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

Recursos Adicionais

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

-- [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

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

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