Sie können Discourse als Kommentarsystem für WordPress verwenden. Die Kommentarfunktionen sind von den Veröffentlichungsfunktionen abhängig, daher müssen Sie die Veröffentlichung eingerichtet haben, damit das Kommentieren funktioniert. Wenn Sie die Veröffentlichung eingerichtet haben und bereit sind, das Kommentieren einzurichten, sehen Sie sich dieses kurze Video an oder folgen Sie den nachstehenden Anweisungen.
Nächster Schritt
Nachdem Sie das Kommentieren eingerichtet haben, möchten Sie vielleicht die folgenden Themen überprüfen
Anweisungen
Kommentieren einrichten
Damit Discourse-Kommentare auf Ihrer WordPress-Website angezeigt werden, müssen Sie die Einstellung „Discourse-Kommentare aktivieren“ auswählen. Wenn diese aktiviert ist, sehen Sie zwei Optionen. Die Option „Kommentare anzeigen“ lädt eine Kommentarvorlage für jeden WordPress-Beitrag, der in Discourse veröffentlicht wurde. Diese Vorlage zeigt Discourse-Kommentare unter den WordPress-Beiträgen an. Die Option „Link zu den Kommentaren anzeigen“ lädt eine Kommentarvorlage, die einen Link zum zugehörigen Discourse-Thema unter den veröffentlichten Beiträgen anzeigt. Die Anzahl der Antworten auf das Thema wird im Link angezeigt, aber keine Antworten werden auf WordPress angezeigt.
Beide Kommentaroptionen laden Kommentarvorlagen für die WordPress-Beiträge. Das bedeutet, dass sie nur funktionieren, wenn Kommentare für den Beitrag aktiviert sind. Wenn Sie Kommentare für alle Beiträge aktivieren möchten, aber keine historischen WordPress-Kommentare für Beiträge anzeigen lassen möchten, die nicht in Discourse veröffentlicht wurden, aktivieren Sie die Einstellung „WordPress-Kommentarvorlage entfernen“.
Einstellungen
Hier sind kurze Beschreibungen, was die anderen Kommentar-Einstellungen bewirken. Wenn Sie sich bei einer der Einstellungen immer noch unsicher sind, antworten Sie auf dieses Thema und bitten Sie um weitere Klärung.
Kommentare mit Ajax laden
Diese Einstellung wird verwendet, um Kommentare vom WordPress-Client zu laden, anstatt sie vom Server zu laden. Dies ist nützlich, wenn die Seiten-Cache-Funktion das Laden neuer Kommentare auf Ihrer Website verhindert.
Kommentar-CSS laden
Diese Einstellung lädt eine Stylesheet, die Probleme mit Discourse Oneboxen und Zitaten behebt, wenn sie auf WordPress angezeigt werden.
Vorhandene WP-Kommentare anzeigen
Wählen Sie diese Einstellung, um auch vorhandene WordPress-Kommentare für Beiträge anzuzeigen, die auch in Discourse veröffentlicht wurden. Wählen Sie die Einstellung aus.
Überschrift für vorhandene Kommentare
Wenn Sie vorhandene Kommentare anzeigen, fügt diese Einstellung eine Überschrift über den WordPress-Kommentaren hinzu.
Einstellungen für selektiven Import
Es gibt eine Reihe von Einstellungen, die es Ihnen ermöglichen, Kommentare selektiv zu importieren. Diese sollten selbsterklärend sein. Die Standardwerte für jede dieser Einstellungen sind ein guter Ausgangspunkt, ändern Sie diese also nur, wenn Sie einen Grund dazu haben.
- Maximale sichtbare Kommentare
- Minimale Anzahl von Antworten
- Mindestpunktzahl für Beiträge
- Mindestvertrauensstufe
- Vertrauensstufe-Punktzahl umgehen
- Nur von Moderatoren gelikte importieren
Benutzerdefiniertes Datums-/Zeitformat
Diese Einstellung formatiert das Datum, das für jeden Discourse-Kommentar angezeigt wird, der auf Ihrer WordPress-Website erscheint. Beginnen Sie mit dem Standardwert. Wenn Sie das Datumsformat ändern möchten, klicken Sie auf den Link in der Beschreibung der Einstellung, um Details zu erfahren, wie Sie dies tun können.
Kommentar-HTML cachen
Diese Einstellung kann zur Verbesserung der Leistung verwendet werden. Das Caching des Kommentar-HTML reduziert die Anzahl der Anfragen an Discourse. Die zugehörige Einstellung „Gecachten Kommentar-HTML löschen“ sollte selbsterklärend sein.
Ausführliche Kommentarprotokolle
Wenn diese Option aktiviert ist, werden alle erfolgreichen Abrufe von Kommentaren aus Discourse protokolliert, zusätzlich zu Fehlern (Standard).
Webhook zum Synchronisieren von Kommentardaten
Das Aktivieren des Webhooks zum Synchronisieren von Kommentardaten im Einstellungsbereich „Webhooks“ kann die Anzahl der API-Anfragen von WordPress an Discourse erheblich reduzieren. Bevor Sie den Webhook aktivieren:
-
Besuchen Sie die Discourse-URL, die in der Beschreibung der Einstellung angegeben ist (
http://forum.example.com/admin/api/web_hooks). -
Klicken Sie auf die Schaltfläche „Neuer Webhook“ und füllen Sie das Formular aus.
-
Geben Sie im Feld „Payload URL“ die URL ein, die in der Beschreibung des WP Discourse-Feldes „Sync Comment Data“ angegeben ist. Sie wird etwa so aussehen, wobei Ihre WordPress-Website-URL verwendet wird:
https://wp-discourse.dev/wp-json/wp-discourse/v1/update-topic-content. -
Stellen Sie sicher, dass das Feld „Content Type“ auf
application/jsongesetzt ist. -
Geben Sie im Eingabefeld „Secret“ eine Textzeichenfolge von mindestens 12 Zeichen ein. Kopieren Sie dann denselben Schlüssel in die WP Discourse-Einstellung „Webhook Secret Key“.
-
Stellen Sie im Feld „Welche Ereignisse sollen diesen Webhook auslösen?“ sicher, dass „Post Event“ ausgewählt ist.
-
Verwenden Sie das Feld „Ausgelöste Kategorien“, wenn Sie Beiträge nur aus WordPress in bestimmte Kategorien veröffentlichen. Auf diese Weise muss Ihre WordPress-Website keine Webhook-Anfragen für Themen verarbeiten, die keinen zugehörigen Discourse-Beitrag haben.
-
Lassen Sie die Einstellung „TLS-Zertifikat der Payload-URL prüfen“ aktiviert.
Aktivieren Sie schließlich das Kontrollkästchen „Aktiv“ und klicken Sie auf „Erstellen“. Wenn der Webhook gespeichert wurde, klicken Sie auf die Schaltfläche „Zu Ereignissen“.
-
-
Stellen Sie auf WordPress sicher, dass Sie das Webhook-Geheimnis von Discourse in das Feld „Webhook Secret Key“ eingegeben und die Webhook-Einstellung „Sync Comment Data“ aktiviert haben. Speichern Sie dann die Optionen.
Der Discourse-Webhook sollte jetzt funktionieren. Sie sollten ihn überprüfen, indem Sie auf die Schaltfläche „Ping“ des Webhooks in Discourse klicken (zu finden unter /admin/api/web_hooks/:webhook_id/events). Stellen Sie sicher, dass das Pingen des Webhooks einen Statuscode von 200 zurückgibt.
Anpassen des Kommentarzählungs-Synchronisierungszeitraums für WordPress-Archivseiten
Um die korrekte Anzahl von Discourse-Kommentaren für einen Beitrag zu erhalten, muss das Plugin periodisch eine HTTP-Anfrage an Discourse stellen, um die aktuelle Anzahl der Kommentare zu erhalten. Auf einzelnen Seiten ist dieser Zeitraum so eingestellt, dass er nicht öfter als alle 10 Minuten erfolgt. Für Archiv-Seiten ist der Zeitraum auf nicht mehr als einmal alle 24 Stunden eingestellt. Der Grund dafür ist, die Erstellung mehrerer Anfragen an Discourse bei jedem Zugriff auf eine Archivseite zu vermeiden.
Wenn Sie feststellen, dass das Plugin zu viele Anfragen an Discourse stellt, wenn die Archivseiten Ihrer Website angezeigt werden, können Sie den archive_page_sync_period anpassen, indem Sie den Filter 'discourse_archive_page_sync_period' verwenden. Dies tun Sie, indem Sie etwas wie das Folgende in die functions.php-Datei Ihres Themes einfügen:
add_filter( 'discourse_archive_page_sync_period', 'my_namespace_archive_page_sync_period' );
function my_namespace_archive_page_sync_period( $sync_period ) {
// Dies ändert den Synchronisierungszeitraum für archivierte Beiträge auf einmal pro Woche.
return WEEK_IN_SECONDS;
}
Wenn Sie feststellen, dass das Plugin nicht genügend Anfragen an Discourse stellt, um die aktuellen Kommentarzahlen für Archivseiten abzurufen, können Sie etwas wie das Folgende in die functions.php-Datei Ihres Themes einfügen. Dies setzt den archive_page_sync_period auf 10 Minuten.
Hinweis: Auf einer stark frequentierten Website kann dies eine hohe Belastung für Ihren Server bedeuten.
add_filter( 'discourse_archive_page_sync_period', 'my_namespace_archive_page_sync_period' );
function my_namespace_archive_page_sync_period( $sync_period ) {
// Dies ändert den Synchronisierungszeitraum für archivierte Beiträge auf einmal pro Woche.
return 10 * MINUTE_IN_SECONDS;
}
Kommentare anzeigen, ohne die WordPress-Kommentarvorlage zu laden
Das WP Discourse-Plugin verwendet die WordPress-Kommentarvorlage, um Discourse-Kommentare zu laden. Wenn Ihr Theme die Kommentarvorlage nicht lädt, können Sie Kommentare mit der statischen Hilfsfunktion get_discourse_comments anzeigen. Diese Funktion erfordert, dass Sie die ID des WordPress-Beitrags angeben, für den Sie Kommentare anzeigen möchten. Hier ist ein einfaches Beispiel für ihre Verwendung:
use WPDiscourse\Utilities\Utilities as DiscourseUtilities;
$discourse_comments = DiscourseUtilities::get_discourse_comments(859);
echo $discourse_comments;
Kommentare werden auf die gleiche Weise angezeigt, wie sie angezeigt werden, wenn Sie die Option „Discourse-Kommentare anzeigen/Kommentare anzeigen“ auswählen (auf der Registerkarte „Kommentareinstellungen“ des Plugins). Wenn diese Funktion verwendet wird, wird der Wert dieser Einstellung ignoriert, aber alle anderen Kommentareinstellungen werden berücksichtigt.
Fehlerbehebung
Das häufigste Problem bei Discourse-Kommentaren ist, dass sie möglicherweise nicht sofort nach der Veröffentlichung des Beitrags in Discourse angezeigt werden. Diese Verzögerung ist beabsichtigt, da das Plugin versucht, die Anzahl der Anfragen an Discourse zu reduzieren. Eine Anfrage bei jedem Seitenaufruf verlangsamt Ihre Website. Wenn Sie keine sofort erscheinenden Kommentare sehen, warten Sie 10 Minuten, bevor Sie die Seite erneut aktualisieren.
Probleme mit der Kommentarzählung bei Anzeige von Discourse- und WordPress-Kommentaren
Das wp-discourse-Plugin verwendet den WordPress-Filter-Hook get_comments_number, damit die Anzahl der für einen Beitrag erstellten Discourse-Kommentare im gesamten Theme angezeigt werden kann. Dies führt zu einem Konflikt, wenn sowohl Discourse- als auch WordPress-Kommentare für einen Beitrag angezeigt werden. Das Plugin kann diesen Konflikt an den meisten Stellen lösen. Ein Ort, an dem er nicht gelöst werden kann, ist die Kommentartitelzeile, die WordPress-Themes oft am Anfang des Kommentarbereichs anzeigen. Dies ist der Abschnitt, der mit etwas wie „2 Gedanken zu…“ beginnt.
Der einfachste Weg, dies zu tun, ist das Hinzufügen einer Regel zu Ihrer Theme-CSS-Datei.
.discourse-comments-area ~ .comments-area .comments-title {
display: none;
}
