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
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?
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)?
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.
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)
@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.
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 }
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?