So wird die Downloadanzahl für Dateien in einem Beitrag angezeigt (nur Pro-Hosting, Theme-Komponente)

Hallo zusammen,

Wir betreiben eine Community auf Discourse (Pro-Hosting, daher keine benutzerdefinierten Plugins, nur Themes und Theme-Komponenten). Wir haben eine Kategorie, in der Mitglieder herunterladbare Dateien teilen (BIOS-Pakete, Skripte, Konfigurationspakete). Diese Dateien werden direkt zu Discourse hochgeladen und nicht auf GitHub oder anderswo gehostet.

Was wir wollen
Eine sichtbare Anzahl der Downloads für jede Datei, ähnlich wie im unten gezeigten Referenzscreenshot (ein Skill-Marktplatz, der Favoriten, Installationen und einen Download-Button anzeigt). Idealerweise:

  • eine Zählung, die jedes Mal erhöht wird, wenn jemand den Anhang herunterlädt,
  • angezeigt im Thema und, wenn möglich, auf den Themenvorschau-Karten,
  • später sortierbar oder filterbar, falls die Daten verfügbar sind.

Was wir versucht haben
Wir haben eine Theme-Komponente erstellt, die einen Download-Button hinzufügt und versucht, die Klickanzahl des Anhangs zu lesen. Die Zählung bleibt jedoch immer bei 0, selbst nach mehreren Test-Downloads von verschiedenen Konten.

Was wir wissen müssen

  1. Verfolgt Discourse standardmäßig Downloads von hochgeladenen Anhängen? Wenn ja, wo werden diese Daten gespeichert, und sind sie im JSON der Themen/Posts oder im Data Explorer verfügbar?
  2. Wenn es als Link-Klicks verfolgt wird, werden Klicks auf Anhänge gezählt, wenn die Datei über den /uploads/short-url/...-Link geöffnet wird, und hängt diese Zählung von einer Site-Einstellung ab (z. B. ob Klicks auf interne Links verfolgt werden)?
  3. Wenn es nicht verfolgt wird, was ist der empfohlene Ansatz auf einem gehosteten Plan? Zum Beispiel eine Tracking-Weiterleitung, ein API-basierter Zähler oder eine Theme-Komponente, die an einen externen Endpunkt meldet.
  4. Verhält sich die Zählung unterschiedlich bei Dateien, die über ein „Upload“-Feld in einem Formular-Template hinzugefügt wurden, im Vergleich zu Dateien, die im normalen Editor hinzugefügt werden?

Umgebung

  • Discourse Pro hosted, Foundation Theme
  • Dateien als Post-Anhänge hochgeladen (keine externen Links)
  • Version: [Aus /admin einfügen]

Referenz (was wir bauen möchten)

Zeigt den Download-Button, die Favoritenanzahl und die Installations-/Downloadanzahl auf einer Ressourcenseite.

Jeder Hinweis, Beispielcode oder vorhandene Komponenten wären wirklich willkommen. Vielen Dank!

@Jessica_S Interessante Anforderung! Ein paar Fragen:

  1. Benötigen Sie die Gesamtzahl der Downloads oder die Anzahl der eindeutigen Downloads pro Benutzer?

  2. Sollten auch Downloads von Gästen gezählt werden?

  3. Sind Sie offen für eine externe API zur Nachverfolgung, falls Discourse keine Ereignisse für das Herunterladen von Anhängen bereitstellt?

Ja, Discourse stellt diese Zählwerte im JSON des Beitragsstroms bereit.

Beispiel: Die Anzahl der Klicks auf diesen Link wird gezählt: https://www.rd.usda.gov/sites/default/files/pdf-sample_0.pdf

Sehen Sie sich dann How to show a download count on files uploaded to a post (Pro hosting, theme component only)? an:

und in Javascript erhalten Sie ein Array post.link_counts.

@RGJ Danke, dass du darauf hingewiesen hast. Du hast recht, ich schätze die Klarstellung. Ich werde mir die post.link_counts-Daten im Post-Stream-JSON ansehen und wie sie verwendet werden können, um Download-Zähler für Anhänge über eine Discourse-Theme-Komponente anzuzeigen.

Ich habe den Code in mein Theme eingefügt, aber er wird nicht automatisch erkannt – ich sehe weiterhin nicht die Anzahl der Downloads.

Welchen Code hast du hinzugefügt?

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; // nur der erste Beitrag

  const links = post.link_counts || [];

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

    // Download-Zähler für diese Datei suchen
    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;

    // Button neu aufbauen: [Icon] Dateiname | Anzahl
    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;
}
}

Hast du den JSON für diesen Beitrag manuell überprüft? Ist die link_count, die du suchst, enthalten? Ich denke, die Datei muss einen externen Link verwenden, damit das funktioniert.

Hochgeladene Anhänge scheinen also nicht gezählt zu werden. Wenn wir stattdessen einen externen Link verwenden (z. B. GitHub Releases), wird die Klickanzahl dann automatisch angezeigt? Wie sollte ich das als Anfänger einrichten?