 |
Zusammenfassung | Ermöglicht das Importieren einer Sitemap, um Seitentitel automatisch auf Forum-Links abzubilden, ähnlich wie die Funktion „Beobachtete Wörter“ (Watched Words). |
 |
Repository-Link | GitHub - multidimension-al/discourse-sitemap-autolink: Turn sitemaps into automatic links in discourse. · GitHub |
 |
Installationsanleitung | So installieren Sie Plugins in Discourse |
Funktionen
Dies ist eine Alternative zur Verwendung der Funktion „Beobachtete Wörter“. Sie ermöglicht es, die Sitemap Ihrer externen Website zu importieren, Wörter automatisch zuzuordnen und diese dann beim nächsten Rebake (Neu-Rendern) zu verlinken. Sehr ähnlich der Funktionsweise von „Beobachteten Wörtern“, fügt jedoch den Schritt des Einspielens von Sitemaps und des Extrahierens von Schlüsselwörtern hinzu.
Gut geeignet für technische Foren mit einem separaten Wiki-Bereich oder ein Forum mit einem zugehörigen News- oder E-Commerce-Shop.
Sie nehmen Ihre Wiki-Sitemap:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://www.example.com/wiki/soldering-iron-maintenance</loc><lastmod>2026-07-02</lastmod></url>
<url><loc>https://www.example.com/wiki/mosfet-driver-board</loc><lastmod>2026-07-05</lastmod></url>
<url><loc>https://www.example.com/wiki/li-ion-battery-pack</loc><lastmod>2026-07-11</lastmod></url>
<url><loc>https://www.example.com/wiki/pcb-etching</loc><lastmod>2026-07-19</lastmod></url>
<url><loc>https://www.example.com/wiki/flux</loc><lastmod>2026-07-23</lastmod></url>
</urlset>
Das Plugin lädt die Sitemap herunter, extrahiert den Titel von der Seite und generiert dann die zu suchenden Wörter. Diese werden automatisch verlinkt, sobald Beiträge mit diesen Wörtern neu gerendert werden, oder das Plugin sucht nach diesen Beiträgen und rendert sie automatisch neu.
Abgeholteter <title> |
Gespeicherter Titel |
|---|---|
| Soldering Iron Maintenance - Example Wiki | Soldering Iron Maintenance |
| MOSFET Driver Board - Example Wiki | MOSFET Driver Board |
| Li-Ion Battery Pack - Example Wiki | Li-Ion Battery Pack |
| PCB Etching - Example Wiki | PCB Etching |
| Flux - Example Wiki | Flux |
Jeder der Titel wird zu einer Suchphrase, versehen mit Sicherheitsmechanismen.
| Gespeicherter Titel | Generierte Phrasen | Status |
|---|---|---|
| Soldering Iron Maintenance | soldering iron maintenance(s) | aktiv |
| MOSFET Driver Board | mosfet driver board(s) | aktiv |
| Li-Ion Battery Pack | li-ion battery pack(s) | aktiv |
| PCB Etching | pcb etching(s) | aktiv |
| Flux | flux, fluxes | wartet auf Prüfung — kurzes, einzelnes Wort |
Anschließend wird in jedem Beitrag, der etwas mit der Phrase übereinstimmt, automatisch ein Link zurück zur Wiki-Seite Ihrer Website eingefügt, maximal einmal pro Beitrag.
Wenn ich also einen Beitrag habe, der sagt:
Ich habe die Soldering Iron Maintenance Seite gelesen und ein Problem mit dem Inhalt festgestellt…
Wird das Wort „Soldering Iron Maintenance“ mit der in der Sitemap zugehörigen Seite verlinkt.
Konfiguration
Nach der Installation gibt es viele konfigurierbare Einstellungen sowie eine dedizierte Katalogseite, die Ihre importierten Sitemaps und die Liste der zu suchenden Phrasen zusammen mit der URL anzeigt.
Finden Sie Ihre Sitemap-XML-Datei, die Sie importieren möchten, und stellen Sie sicher, dass Sie ohne Einschränkungen Ihrer Discourse-Installation eine Verbindung zu diesem Server herstellen können. Identifizieren Sie das gemeinsame Site-Präfix oder Suffix und legen Sie die Sitemap-Autolink-Titel-Suffixe mit dem Teil des Feldes fest, den Sie nicht übereinstimmen lassen möchten. Ein Beispiel wäre „- Discourse Meta“, wenn Sie nicht möchten, dass dieser Seitentitel übereinstimmt. Sie können auch angeben, bestimmte gängige Wörter zu überspringen, die häufig auf Ihrer Website vorkommen. Die meisten Einstellungen müssen nicht aktiviert werden, ermöglichen es Ihnen jedoch, Timing und Verzögerungen anzupassen, wie viel Zeit für die Prüfung der Sitemap aufgewendet werden darf und welche Verzögerung zwischen jeder URL eingehalten werden soll.
Sobald die URL importiert wurde, wird die lastmod-Zeit gespeichert und es wird nicht erneut geprüft, es sei denn, das lastmod-Feld ändert sich. Sie können Suchphrasen manuell zuweisen oder löschen, und das Plugin fragt Sie automatisch bei einwortigen Übereinstimmungen nach.
Einstellungen
Verlinkung
| Einstellung | Standard | Zweck |
|---|---|---|
sitemap_autolink_enabled |
aus | Hauptschalter. |
sitemap_autolink_max_links_per_destination_per_post |
1 | Wie oft jedes Ziel pro Beitrag verlinkt werden darf (erste Erwähnungen haben Vorrang). 0 = unbegrenzt. |
sitemap_autolink_max_links_per_post |
0 | Gesamtzahl der automatischen Links pro Beitrag. 0 = unbegrenzt. |
sitemap_autolink_skip_quotes |
an | Niemals innerhalb von zitierter Material verlinken. |
sitemap_autolink_include_private_messages |
aus | Auch in persönlichen Nachrichten verlinken. |
sitemap_autolink_excluded_categories |
– | Niemals in diesen Kategorien verlinken (Unterkategorien eingeschlossen). |
sitemap_autolink_enabled_types |
– (alle) | Einschränkung, welche Inhaltstypen verlinkt werden dürfen. |
sitemap_autolink_type_priority |
manual |
Prioritätsreihenfolge bei Kollisionen, stärkste zuerst; nicht aufgeführte Typen haben die niedrigste Priorität. |
Katalog & Phrasen
| Einstellung | Standard | Zweck |
|---|---|---|
sitemap_autolink_sources |
– | Sitemaps zum Einspielen, eine pro Eintrag: https://example.com/sitemap.xml,content_type. Indizes erweitern sich automatisch. |
sitemap_autolink_manual_mappings |
– | Manuelle phrase,url,type-Regeln. Relative URLs werden relativ zum Forum aufgelöst. |
sitemap_autolink_min_phrase_length |
5 | Kürzere generierte Phrasen gehen zur Prüfung. |
sitemap_autolink_min_phrase_words |
2 | Generierte Phrasen mit weniger Wörtern gehen zur Prüfung (Token für Buchstaben+Ziffern-Modellnummern sind ausgenommen). |
sitemap_autolink_generate_plurals |
an | Generiert auch einfache Pluralvarianten. |
sitemap_autolink_title_suffixes |
– | Boilerplate, die vom Ende der abgeholteten Titel entfernt wird. Ein Eintrag darf das `-Zeichen nicht enthalten |
sitemap_autolink_excluded_url_patterns |
– | Niemals übereinstimmende Sitemap-URLs einspielen (Teilstring oder *-Platzhalter, z. B. */checkout*). |
sitemap_autolink_excluded_terms |
– | Exakte Phrasen, die niemals automatisch generiert werden dürfen. Manuelle Aliase überschreiben dies. |
Synchronisation
| Einstellung | Standard | Zweck |
|---|---|---|
sitemap_autolink_sync_enabled |
aus | Führt den täglichen Sitemap→Katalog-Job aus. |
sitemap_autolink_page_fetch_delay_ms |
500 | Höflichkeitspause zwischen Titelabrufen (nur für neue/geänderte URLs). |
sitemap_autolink_sync_time_budget_minutes |
30 | Maximale Minuten pro Lauf; der Lauf stoppt sauber als Teilweise und der nächste Lauf setzt die verbleibende Arbeit fort. |
sitemap_autolink_fetch_host_rewrites |
– | Holt einen öffentlichen Host über ein internes Ziel (siehe unten). |
Rebaking
| Einstellung | Standard | Zweck |
|---|---|---|
sitemap_autolink_auto_rebake_on_changes |
aus | Rendert nach einer Synchronisation Beiträge neu, die wahrscheinlich von Phrasenänderungen betroffen sind – ein gebündelter Hintergrundjob pro Synchronisation. |
sitemap_autolink_auto_rebake_max_phrases |
50 | Wenn eine Synchronisation mehr Phrasen ändert als dieser Wert, wird das Auto-Rebake vollständig übersprungen (damit ein initialer Import nie ein nahezu vollständiges Forum-Rebake auslöst). |
sitemap_autolink_auto_rebake_max_posts |
500 | Die meisten Beiträge, die eine Rebake-Welle einer Synchronisation betreffen darf. |
sitemap_autolink_max_rebakes_per_job_run |
200 | Batch-Größe pro Job-Lauf; größere Wellen werden in Folge-Jobs mit einer Minute Abstand fortgesetzt. |
Analytik
| Einstellung | Standard | Zweck |
|---|---|---|
sitemap_autolink_analytics_enabled |
an | Sendet internal_auto_link_click-Ereignisse an Google Analytics über gtag oder dataLayer, wenn generierte Links geklickt werden. Ohne Effekt, wenn keines davon vorhanden ist. |
Ich verwende dies, um meine Hauptwebsite mit meinem Discourse-Forum zu verlinken. So kann ein Thema in unserem Wiki oder Shop automatisch einen Link generieren.
Wenn jemand über ein bestimmtes Produkt spricht, wird der Link automatisch zum Zeitpunkt des Bakes hinzugefügt, solange ein von Ihnen zugewiesenes Schlüsselwort oder der Produktname selbst erwähnt wird.
Ebenso können Sie, wenn Sie eine Wiki-Website haben, die Seitentitel des Wikis automatisch verlinken. Nehmen wir an, Sie haben eine Geschichtswebsite und jemand erwähnt „Der Krieg von 1812“, was mit einem Wiki-Artikel mit demselben Namen übereinstimmt, dann wird automatisch verlinkt.
Ich hoffe, es gefällt Ihnen!