Come mostrare il numero di download sui file caricati in un post (solo hosting Pro, componente tema)?

Ciao a tutti,

Gestiamo una community su Discourse (hosting Pro, quindi niente plugin personalizzati, solo temi e componenti del tema). Abbiamo una categoria in cui i membri condividono file scaricabili (pacchetti BIOS, script, pacchetti di configurazione). Questi file sono caricati direttamente su Discourse, non ospitati su GitHub o altrove.

Cosa vogliamo
Un conteggio dei download visibile su ogni file, simile allo screenshot di riferimento sottostante (un marketplace di skill che mostra preferiti, installazioni e un pulsante di download). Idealmente:

  • un conteggio che aumenta ogni volta che qualcuno scarica l’allegato,
  • mostrato nell’argomento e, se possibile, sulle card della lista degli argomenti,
  • ordinabile o filtrabile in seguito se i dati sono disponibili.

Cosa abbiamo provato
Abbiamo creato un componente del tema che aggiunge un pulsante di download e cerca di leggere il conteggio dei clic sull’allegato. Il conteggio rimane sempre a 0, anche dopo diversi download di prova da account diversi.

Cosa ci serve sapere

  1. Discourse traccia i download degli allegati caricati nativamente? Se sì, dove sono archiviati questi dati e sono esposti nel JSON dell’argomento/post o nel Data Explorer?
  2. Se viene tracciato come clic sui link, i clic sugli allegati vengono conteggiati quando il file viene aperto tramite il link /uploads/short-url/... e quel conteggio dipende da qualche impostazione del sito (ad esempio, il tracciamento dei clic sui link interni)?
  3. Se non viene tracciato, qual è l’approccio consigliato su un piano ospitato? Ad esempio, un reindirizzamento di tracciamento, un contatore basato su API o un componente del tema che segnala a un endpoint esterno.
  4. Il conteggio si comporta in modo diverso per i file aggiunti tramite il campo “upload” di un modello di modulo rispetto ai file aggiunti nel compositore normale?

Ambiente

  • Discourse Pro hosting, tema Foundation
  • File caricati come allegati ai post (non link esterni)
  • Versione: [incollare da /admin]

Riferimento (cosa vorremmo costruire)

Mostra il pulsante di download, il conteggio dei preferiti e il conteggio installazioni/download su una pagina delle risorse.

Qualsiasi suggerimento, codice di esempio o componente esistente sarebbe molto apprezzato. Grazie!

@Jessica_S Requisito interessante! Alcune domande:

  1. Ti servono i download totali o i download unici per utente?

  2. Devono essere conteggiati anche i download degli ospiti?

  3. Sei disponibile a utilizzare un’API esterna per il tracciamento, se Discourse non espone gli eventi di download degli allegati?

Sì, Discourse espone tali conteggi nel JSON del flusso dei post.

Ad esempio, il numero di clic su questo link verrĂ  contato https://www.rd.usda.gov/sites/default/files/pdf-sample_0.pdf

Poi consulta https://meta.discourse.org/t/how-to-show-a-download-count-on-files-uploaded-to-a-post-pro-hosting-theme-component-only/417810.json:

e in JavaScript si ottiene un array post.link_counts.

@RGJ Grazie per averlo segnalato. Hai ragione, apprezzo il chiarimento. Esaminerò i dati di post.link_counts nel JSON dello stream dei post e il modo in cui possono essere utilizzati per visualizzare il numero di download degli allegati tramite un componente tematico di Discourse.

Ho aggiunto il codice al mio tema, ma non viene rilevato automaticamente: continuo a non vedere il numero di download.

Che codice hai aggiunto?

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; // solo il primo post

  const links = post.link_counts || [];

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

    // Cerca il numero di download per questo file
    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;

    // Ricostruisci il pulsante: [icona] nomefile | conteggio
    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;
}
}

Hai controllato manualmente il JSON di quel post? Il link_count che stai cercando è incluso? Credo che il file debba usare un link esterno perché questo funzioni

Quindi gli allegati caricati non sembrano essere conteggiati. Se utilizziamo invece un link esterno (ad esempio GitHub Releases), il conteggio dei clic verrĂ  mostrato automaticamente? Come dovrei configurarlo se sono un principiante?