게시물에 업로드된 파일의 다운로드 수를 표시하는 방법 (Pro 호스팅, 테마 구성 요소 전용)?

안녕하세요 모두,

저희는 Discourse(Pro 호스팅, 따라서 사용자 지정 플러그인은 없고 테마 및 테마 구성 요소만 가능)에서 커뮤니티를 운영하고 있습니다. 회원들이 다운로드 가능한 파일(BIOS 패키지, 스크립트, 설정 팩 등)을 공유하는 카테고리가 있는데, 이 파일들은 GitHub 등 외부에 호스팅되지 않고 Discourse에 직접 업로드됩니다.

원하는 기능
아래 참조 스크린샷과 같이 각 파일에 눈에 띄는 다운로드 횟수 표시(즐겨찾기, 설치 횟수 및 다운로드 버튼이 표시된 스킬 마켓플레이스 이미지)가 필요합니다. 이상적으로는:

  • 누군가가 첨부 파일을 다운로드할 때마다 횟수가 증가해야 하며,
  • 게시글(topic) 내에서 표시되고, 가능하다면 게시글 목록 카드에도 표시되어야 하며,
  • 데이터가 확보된다면 나중에 정렬 또는 필터링이 가능해야 합니다.

시도해 본 사항
다운로드 버튼을 추가하고 첨부 파일의 클릭 횟수를 읽어보려는 테마 구성 요소를 제작했습니다. 그러나 여러 계정에서 테스트 다운로드를 수행한 후에도 횟수는 항상 0으로 유지됩니다.

확인해야 할 사항

  1. Discourse는 기본적으로 업로드된 첨부 파일의 다운로드를 추적하나요? 만약 그렇다면, 해당 데이터는 어디에 저장되며, 게시글/게시물 JSON이나 Data Explorer에서 노출되나요?
  2. 링크 클릭으로 추적된다면, /uploads/short-url/... 링크를 통해 파일을 열 때 첨부 파일 클릭이 집계되나요? 그리고 해당 집계가 사이트 설정(예: 내부 링크 클릭 추적)에 의존하나요?
  3. 만약 추적되지 않는다면, 호스팅 계획에서 권장되는 접근 방식은 무엇인가요? 예를 들어 추적용 리디렉션, API 기반 카운터, 또는 외부 엔드포인트로 보고하는 테마 구성 요소 등입니다.
  4. Form Template의 “upload” 필드를 통해 추가된 파일과 일반 편집기를 통해 추가된 파일 간에 집계 방식에 차이가 있나요?

환경

  • Discourse Pro 호스팅, Foundation 테마
  • 파일은 게시물 첨부 파일로 업로드됨(외부 링크 아님)
  • 버전: [/admin에서 붙여넣기]

참조 (구축하려는 기능)

리소스 페이지에 다운로드 버튼, 즐겨찾기 횟수 및 설치/다운로드 횟수가 표시된 예시입니다.

어떤 방향 제시든, 예제 코드든, 기존 구성 요소든 정말 감사하겠습니다. 감사합니다!

@Jessica_S 흥미로운 요구사항이네요! 몇 가지 질문이 있습니다:

  1. 총 다운로드 수가 필요하신가요, 아니면 사용자별 고유 다운로드 수인가요?

  2. 게스트의 다운로드도 집계되어야 하나요?

  3. Discourse가 첨부파일 다운로드 이벤트를 노출하지 않는 경우, 추적을 위해 외부 API를 사용하는 것에 대해 열어두셨나요?

네, Discourse는 게시물 스트림 json에 해당 카운트를 노출합니다.

예를 들어, 이 링크에 대한 클릭 수가 기록됩니다. https://www.rd.usda.gov/sites/default/files/pdf-sample_0.pdf

이후 https://meta.discourse.org/t/how-to-show-a-download-count-on-files-uploaded-to-a-post-pro-hosting-theme-component-only/417810.json을 확인해 보세요:

그리고 JavaScript에서 post.link_counts 배열을 가져올 수 있습니다.

@RGJ 알려주셔서 감사합니다. 맞습니다, 명확한 설명에 감사드립니다. 포스트 스트림 JSON의 post.link_counts 데이터와 Discourse 테마 구성 요소를 통해 첨부 파일 다운로드 횟수를 표시하는 데 이를 어떻게 사용할 수 있는지 살펴보겠습니다.

테마에 코드를 추가했지만 자동 인식되지 않아서 다운로드 수가 여전히 보이지 않아요.

어떤 코드를 추가했나요?

JS:

import { apiInitializer } from “discourse/lib/api”;
import { iconHTML } from “discourse/lib/icon-library”;

// 1234 → 1.2k, 15000 → 15k
const formatCount = (n) => {
if (n < 1000) return ${n};
const k = n / 1000;
return ${k >= 10 ? Math.round(k) : k.toFixed(1).replace(/\.0$/, "")}k;
};

export default apiInitializer(“1.8.0”, (api) => {
api.decorateCookedElement(
(el, helper) => {
const post = helper?.getModel?.();
if (!post || post.post_number !== 1) return; // 첫 번째 게시물만 대상

  const links = post.link_counts || [];

  el.querySelectorAll("a.attachment").forEach((a) => {
    if (a.dataset.dlDecorated) return;
    a.dataset.dlDecorated = "1";

    // 이 파일의 다운로드 수 조회
    const path = new URL(a.href, location.origin).pathname;
    const match = links.find((l) => l.url && l.url.includes(path));
    const downloads = match?.clicks || 0;

    // 버튼 재구성: [아이콘] 파일명 | 수량
    const fileName = a.textContent.trim();
    a.textContent = "";
    a.classList.add("gm-download-btn");
    a.insertAdjacentHTML("afterbegin", iconHTML("download"));

    const name = document.createElement("span");
    name.className = "gm-download-name";
    name.textContent = fileName;
    a.appendChild(name);

    const count = document.createElement("span");
    count.className = "gm-download-count";
    count.textContent = formatCount(downloads);
    count.title = `${downloads} download${downloads === 1 ? "" : "s"}`;
    a.appendChild(count);
  });
},
{ id: "gm-download-button", onlyStream: true }

);
});

CSS:.gm-download-btn {
display: inline-flex;
align-items: center;
gap: 0.6em;
padding: 0.55em 0.55em 0.55em 1.2em;
border-radius: 999px;
background: var(–tertiary);
color: var(–secondary) !important;
font-weight: 600;
text-decoration: none;

&:hover {
background: var(–tertiary-hover);
color: var(–secondary) !important;
}

.d-icon {
color: var(–secondary);
}

.gm-download-count {
margin-left: 0.4em;
padding: 0.15em 0.8em;
border-radius: 999px;
background: rgba(255, 255, 255, 0.22);
font-size: var(–font-down-1);
font-variant-numeric: tabular-nums;
}
}

해당 게시물의 json을 수동으로 확인해 보셨나요? 찾으시던 link_count가 포함되어 있나요? 이 기능이 동작하려면 파일에 외부 링크를 사용해야 하는 것 같습니다.

그렇다면 업로드한 첨부파일은 집계되지 않는 것 같네요. 대신 외부 링크(예: GitHub Releases)를 사용하면 클릭 수가 자동으로 표시되나요? 초보자인 저는 어떻게 설정해야 할까요?