Discourse-Forum anbinden

Mit der Theme-Komponente werden Produktlinks in Forenbeiträgen zu Produktboxen, und jedes Thema zeigt passende Produkte.

Für Foren mit Discourse gibt es eine Theme-Komponente. Sie nutzt die Einbettung: Unterstützte Produktlinks in Beiträgen (Amazon, eBay, Awin-Deeplinks und Shopseiten, die affilinode als Angebot kennt) zeigen eine Produktbox mit den Affiliate-Links deiner Website, Shortcodes wie [affilinode_product id=…] werden zur Box, und auf Wunsch zeigt jedes Thema einmal passende Produkte aus deinem Katalog.

Einrichten mit dem Assistenten

1. Im Menü „Integrationen“ öffnen und bei „Discourse“ auf „Einrichten“ klicken (oder Strg+K und „Discourse-Forum anbinden“).
2. „Forum“: die Adresse des Forums eingeben, zum Beispiel forum.beispiel.de. Der Assistent ordnet es einer Website zu (oder legt eine an) und richtet den Einbettungsschlüssel mit dieser Domain ein.
3. „Komponente“: „In Discourse installieren“ öffnet in deinem Forum den Dialog „Installieren“ mit der Adresse der Komponente schon eingetragen. Bestätigen und die Komponente den Themes des Forums hinzufügen („Zu Themes hinzufügen“). Klappt der Direktlink nicht, die angezeigte Repo-Adresse unter Admin → Anpassen → Themes → Installieren → „Aus einem Git-Repository“ einfügen.
4. „Einstellungen“: auswählen, was die Komponente tun soll. Die Tabelle zeigt die Werte zum Kopieren; Pflicht ist nur affilinode_key, markiert ist alles, was vom Standard abweicht.
5. „Analysieren (optional)“: „Inhaltsquelle anlegen“ (API-Key nur für nicht öffentliche Kategorien) und in Discourse unter Admin → API → Webhooks einen Webhook mit der angezeigten Adresse und dem Secret anlegen – Inhaltstyp application/json, Ereignisse Themen und Beiträge.
6. „Prüfen“: „Installation prüfen“ liest aus der Startseite des Forums, ob die Komponente im aktiven Theme mit deinem Schlüssel eingestellt ist. Ist das Forum nur nach Anmeldung lesbar, schreib einen Testbeitrag mit einem Amazon-Link – danach zeigt die Prüfung unter „Zuletzt abgerufen“ und „Sichtbare Boxen“, ob die Boxen ankommen.

Einstellungen

• links_mode: box (Produktbox), compact (Zeile) oder off; links_max_per_post begrenzt die Boxen aus Links je Beitrag (Standard 3).
• shortcodes: Shortcodes als Boxen zeigen – alle Boxen des WordPress-Plugins, von [affilinode_product] bis [affilinode_search], [affilinode_advisor], [affilinode_compat], [affilinode_top], [affilinode_scatter], [affilinode_energy] und [affilinode_rating] (Attribute wie im Plugin, siehe „Produktboxen ohne WordPress einbetten“). Im Composer-Menü steht dann „Produkt einfügen“: Es sucht in deinem Katalog und setzt den Shortcode ein. Ab Version 0.3.0 der Komponente stehen unter „Weitere Boxen …“ alle Box-Arten – Produktkarte, Testbewertung, Auf einen Blick, Folgekosten, Alternativen, Textlink und Einzelwert im Satz, Bestenliste, Produktsuche, Produktberater, Kompatibilitäts-Check, Bester in der Kategorie und das Preis-Leistungs-Diagramm; ab 0.5.0 auch „Gutscheine“ ([affilinode_coupons]) und bei Produktbox und Karte „Gutscheine der Händler darunter“ (coupons=1). Die Komponente aktualisierst du in Discourse unter Admin → Anpassen → Themes → Komponente → „Aktualisieren“.
• Alle Optionen einer Box: Im Dashboard den Dialog „Code erzeugen“ öffnen (Seitenleiste, Alt + Umschalt + E oder unter „Integrationen“ → „Produkt einfügen“, auch am Ende des Discourse-Assistenten) und die Box zusammenstellen und im Reiter „Discourse“ den Shortcode kopieren.
• context_enabled: passende Produkte einmal je Thema, hinter dem Beitrag aus context_after_post (Standard: hinter dem ersten), mit context_limit Produkten und eigener Überschrift in context_title.
• excluded_categories: Kategorien ohne Boxen, zum Beispiel Off-Topic – Unterkategorien sind mit ausgeschlossen.
• min_trust_level_for_links: Links nur in Beiträgen ab dieser Vertrauensstufe umwandeln, als Schutz vor Spam. Beiträge des Teams werden immer umgewandelt, Shortcodes wirken unabhängig davon.
• theme und accent: Aussehen der Boxen wie bei data-theme und data-accent.

Steht ein Link allein in seinem Absatz (nackte Adresse oder Vorschaukarte), ersetzt die Box den Absatz; sonst kommt sie hinter den Absatz und der Link bleibt stehen. Private Nachrichten, ausgeblendete Beiträge, die Vorschau im Composer sowie Links in Zitaten und Code werden nicht umgewandelt. Kurzlinks wie amzn.to werden nicht aufgelöst.

Datenschutz und Kennzeichnung

• Für Links werden nur die Link-Adressen gesendet, für passende Produkte Titel, Kategorie, Schlagwörter und der Anfang der ersten Beiträge (höchstens 2.000 Zeichen) – keine Benutzernamen, keine Besucherdaten, keine Cookies. affilinode speichert weder Links noch Texte.
• Die Boxen tragen selbst die Kennzeichnung „Anzeige“ und den Affiliate-Hinweis.
• „Passend zum Thema“ ist im Tarif Publisher enthalten; in anderen Tarifen bleibt die Box leer. Jeder Abruf zählt zum API-Kontingent.