In der neuesten Discourse-Version defekt
Ich habe kürzlich Discourse aktualisiert, und dieses Plugin hat die Seite lahmgelegt. (Um es klarzustellen, dies ist wahrscheinlich eher auf meine schrecklichen Hacks zurückzuführen als auf Discourse selbst. Ich habe derzeit nicht die Zeit, die Lösung zu finden, daher hinterlasse ich diese Warnung nur für andere.)
 |
Zusammenfassung | Fügt oben in jedem Thema mit dem Tag contact ein Kontaktformular hinzu. Die über das Formular übermittelten Informationen werden an die Gruppe oder Kategorie gesendet, die für den Empfang konfiguriert ist. |
 |
Repository-Link | https://github.com/jericson/discourse-contact-plugin |
 |
Installationsanleitung | So installieren Sie Plugins in Discourse |
Funktionen
Wenn das Kontaktformular-Plugin aktiviert ist, wird ein Kontaktformular oben in jedem Thema mit dem Tag contact platziert. Daten, die über das Formular übermittelt werden, werden an eine Kategorie oder Gruppe gesendet, die so konfiguriert ist, dass sie E-Mails von contact_form_email empfängt.[1] Wie bei herkömmlichen Kontaktformularen ist kein Konto auf der Website erforderlich, um eine Nachricht zu senden.
Hier ist, was ein Besucher sehen könnte:
Beachten Sie, dass dies ein regulärer Beitrag ist, der beliebige Anweisungen enthalten kann, die Sie im Text einfügen möchten.[2] Derzeit sind die Feldnamen fest codiert und es wird keine echte Validierung durchgeführt. Weitere Informationen finden Sie jedoch im Abschnitt TODO unten. Nachdem die Nachricht gesendet wurde, wird sie im Nachrichtenfeed der konfigurierten Gruppe angezeigt:
Abhängig davon, wie ihre E-Mail-Benachrichtigungen konfiguriert sind, erhalten Mitglieder der konfigurierten Gruppe möglicherweise auch eine E-Mail von Discourse:
Konfiguration
Um dieses Plugin nutzen zu können, müssen Sie eingehende E-Mails so konfigurieren, dass neue Themen oder Gruppenmeldungen erstellt werden. Es ist nicht erforderlich, Antworten per E-Mail einzurichten, da das Plugin tatsächlich keine E-Mails sendet. Es kapert die API, um eingehende E-Mails zu simulieren. (Allerdings ist die Antwort per E-Mail eine nützliche Funktion!)
Insbesondere erfordert dieses Plugin:
email_inundenable_staged_users
aktiviert zu sein.
Sobald sie aktiviert sind, wird jedem Thema mit dem Tag contact ein Kontaktformular zum topic-above-posts-Plugin-Outlet hinzugefügt.
An eine Gruppe senden
Da Personen dieses Formular zur Übermittlung ihrer persönlichen Daten verwenden werden, ist das Senden der Ergebnisse an eine geschlossene Gruppe die sicherste Option.
- Erstellen Sie eine neue Gruppe für die Personen, die sich um Kontakte kümmern werden. (Ich nenne sie der Einfachheit halber normalerweise „Kontakt“, aber es könnte jede Gruppe sein, einschließlich einer bestehenden Gruppe.)
- Fügen Sie Mitglieder hinzu, die Kontaktinformationen erhalten sollen.
- Aktivieren Sie keine der Zugriffsoptionen. Dies sollte eine geschlossene Gruppe sein.
- Ändern Sie die Sichtbarkeit der Gruppe nach den Anforderungen Ihrer Organisation.
- Stellen Sie die „Benutzerdefinierte eingehende E-Mail-Adresse“ auf denselben Wert wie die Einstellung
contact_form_emailein. (Standardmäßig ist dies „contact@example.com“.)
…
An eine Kategorie senden
Das Senden an eine Kategorie ist auch über die Kategorieeinstellung „Benutzerdefinierte eingehende E-Mail-Adresse“ möglich. Stellen Sie außerdem sicher, dass „E-Mails von anonymen Benutzern ohne Konten akzeptieren“ aktiviert ist.
Das Senden an eine Kategorie wird jedoch für Kontaktinformationen nicht empfohlen! Sollte sich aus irgendeinem Grund die Zugriffsberechtigung für die Kategorie ändern, könnten persönliche Informationen an Personen (oder Suchmaschinen) preisgegeben werden, die keinen Zugriff haben sollten. Es ist viel unwahrscheinlicher, dass dies geschieht, wenn Kontakte stattdessen an Gruppenmeldungen gesendet werden.
Einschränken, wer Kontaktformulare hinzufügen kann
Es könnte ziemlich seltsam sein, wenn überall Kontaktformulare auftauchen. Sie möchten also möglicherweise einschränken, wer das Tag contact verwenden kann. Erstellen Sie dazu eine neue Tag-Gruppe:
- Wählen Sie auf der Seite
/tagsdas Schraubenschlüssel-Symbol oben rechts aus. - Wählen Sie „Tag-Gruppen verwalten“ und dann „
Neue Gruppe“. - Geben Sie einen geeigneten Namen ein (z. B. „Nur Mitarbeiter“), fügen Sie das Tag
contacthinzu und wählen Sie „Tags sind für alle sichtbar, aber nur die folgenden Gruppen können sie verwenden“. - Wählen Sie die Gruppe aus, der Sie das Hinzufügen eines Kontaktformulars gestatten möchten (normalerweise „Mitarbeiter“ oder „Administratoren“) und speichern Sie die Tag-Gruppe.
ÄNDERUNGSPROTOKOLL
-
- April 2024: Alpha-Version.
ZU ERLEDIGEN
- Ich möchte Tests einrichten, um sicherzustellen, dass beim Ändern nichts kaputt geht. Ich möchte insbesondere überprüfen, ob Personen ohne Konten ihre Daten übermitteln können.
- Beim Testen habe ich ein großes Datenleck entdeckt. Ich habe diese spezielle Schwachstelle behoben, aber ich könnte wirklich Hilfe beim Testen gebrauchen.
- Das Formular führt keine Validierung durch. Die einzig wirkliche Anforderung ist, dass das E-Mail-Feld wie eine E-Mail aussieht. Wenn jemand eine Antwort hinterlässt, ohne eine E-Mail hinzuzufügen, schlägt das Formular stillschweigend fehl.
- Es gibt keinen Schutz vor Spam oder Missbrauch.
- Der Code ist größtenteils von der Qualität „mein-erstes-Plugin“ basierend auf Beispielen, die veraltete Konventionen verwendet haben. Vorschläge zum Stil sind willkommen.
- Ich möchte, dass das Kontaktformular mit einem Thema verknüpft ist, das mit „contact“ getaggt ist, aber es ist umständlich und wahrscheinlich unnötig. Ich ziehe in Erwägung, einen neuen Routenpunkt hinzuzufügen, der nur das Kontaktformular für mehr Einfachheit ist.
- Die Kontaktdaten werden in der Datenbank gespeichert, aber es wäre hilfreich, ein Admin-Panel zu haben, um eine Liste der Kontakte anzuzeigen.
- Das Formular ist auf meine aktuellen Anforderungen zugeschnitten, aber es wäre praktisch, etwas Flexibilität bei den Feldern zu haben, nach denen es fragt.
