From 8069ad6fd2e1a2cf2deaaaf0de0006d4b1f3b296 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felix=20Sch=C3=A4fer?= <felix@thegcat.net>
Date: Tue, 8 Feb 2022 20:25:13 +0100
Subject: [PATCH] Add more help messages

---
 pretix_matrix_inviter/forms.py                | 14 ++++-
 .../locale/de/LC_MESSAGES/django.po           | 57 ++++++++++++++-----
 .../locale/de_Informal/LC_MESSAGES/django.po  | 57 ++++++++++++++-----
 pretix_matrix_inviter/locale/django.pot       | 57 ++++++++++++++-----
 4 files changed, 139 insertions(+), 46 deletions(-)

diff --git a/pretix_matrix_inviter/forms.py b/pretix_matrix_inviter/forms.py
index a323fbb..37a2324 100644
--- a/pretix_matrix_inviter/forms.py
+++ b/pretix_matrix_inviter/forms.py
@@ -17,24 +17,36 @@ class MatrixInviterForm(SettingsForm):
         label=_("Ask Matrix ID for"),
         required=True,
         choices=[],
+        help_text=_("These products will ask for a Matrix ID."),
     )
     matrix_inviter_authorization_token = CharField(
         label=_("Authorization token"),
         strip=True,
+        help_text=_(
+            "This should be the authorization token of a user that can invite attendees to the target Room or Space. "
+            "Please note that other administrators of this event will be able to see this token, it should not be from "
+            "your own Matrix account but from a dedicated Matrix account."
+        ),
     )
     matrix_inviter_matrix_server = CharField(
         label=_("Matrix server"),
         strip=True,
+        help_text=_("The matrix server the above authorization token is valid for."),
     )
     matrix_inviter_hint = I18nFormField(
         widget=I18nTextInput,
-        label=_("Help text for the Matrix ID field"),
+        label=_("Matrix ID field help text"),
         required=True,
+        help_text=_(
+            "This will be shown as help text on the Matrix ID field. It is recommended to inform your attendees to "
+            "which room they will be invited to and what that room will be used for."
+        ),
     )
     matrix_inviter_reason = I18nFormField(
         widget=I18nTextInput,
         label=_("Invitation message"),
         required=False,
+        help_text=_("This message will be added to the invitation to the Matrix room."),
     )
     matrix_inviter_matrix_room = RegexField(
         label=_("Matrix room"),
diff --git a/pretix_matrix_inviter/locale/de/LC_MESSAGES/django.po b/pretix_matrix_inviter/locale/de/LC_MESSAGES/django.po
index cda417f..e3118d6 100644
--- a/pretix_matrix_inviter/locale/de/LC_MESSAGES/django.po
+++ b/pretix_matrix_inviter/locale/de/LC_MESSAGES/django.po
@@ -2,7 +2,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-02-08 00:44+0100\n"
+"POT-Creation-Date: 2022-02-08 20:24+0100\n"
 "PO-Revision-Date: \n"
 "Last-Translator: Felix Schäfer\n"
 "Language-Team: \n"
@@ -21,52 +21,79 @@ msgid ""
 "Space."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:14
+#: pretix_matrix_inviter/forms.py:17
 msgid "Ask Matrix ID for"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:19
-msgid "Authorization token"
+#: pretix_matrix_inviter/forms.py:20
+msgid "These products will ask for a Matrix ID."
 msgstr ""
 
 #: pretix_matrix_inviter/forms.py:23
+msgid "Authorization token"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:26
+msgid ""
+"This should be the authorization token of a user that can invite attendees "
+"to the target Room or Space. Please note that other administrators of this "
+"event will be able to see this token, it should not be from your own Matrix "
+"account but from a dedicated Matrix account."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:32
 msgid "Matrix server"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:28
-msgid "Help text for the Matrix ID field"
+#: pretix_matrix_inviter/forms.py:34
+msgid "The matrix server the above authorization token is valid for."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:38
+msgid "Matrix ID field help text"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:41
+msgid ""
+"This will be shown as help text on the Matrix ID field. It is recommended to "
+"inform your attendees to which room they will be invited to and what that "
+"room will be used for."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:33
+#: pretix_matrix_inviter/forms.py:47
 msgid "Invitation message"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:46
+#: pretix_matrix_inviter/forms.py:49
+msgid "This message will be added to the invitation to the Matrix room."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:52
+msgid "Matrix room"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:66
 #, python-brace-format
 msgid "\"{name}\" (<code>{canonical_alias}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:48
+#: pretix_matrix_inviter/forms.py:68
 #, python-brace-format
 msgid "\"{name}\""
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:52
+#: pretix_matrix_inviter/forms.py:72
 #, python-brace-format
 msgid ""
 "\"{name}\" (<code>{room_id}</code>, main alias: <code>{canonical_alias}</"
 "code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:55
+#: pretix_matrix_inviter/forms.py:75
 #, python-brace-format
 msgid "\"{name}\" (<code>{room_id}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:58
-msgid "Matrix room"
-msgstr ""
-
 #: pretix_matrix_inviter/signals.py:22
 msgid "You will be invited to the event's Matrix Space."
 msgstr ""
diff --git a/pretix_matrix_inviter/locale/de_Informal/LC_MESSAGES/django.po b/pretix_matrix_inviter/locale/de_Informal/LC_MESSAGES/django.po
index cda417f..e3118d6 100644
--- a/pretix_matrix_inviter/locale/de_Informal/LC_MESSAGES/django.po
+++ b/pretix_matrix_inviter/locale/de_Informal/LC_MESSAGES/django.po
@@ -2,7 +2,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-02-08 00:44+0100\n"
+"POT-Creation-Date: 2022-02-08 20:24+0100\n"
 "PO-Revision-Date: \n"
 "Last-Translator: Felix Schäfer\n"
 "Language-Team: \n"
@@ -21,52 +21,79 @@ msgid ""
 "Space."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:14
+#: pretix_matrix_inviter/forms.py:17
 msgid "Ask Matrix ID for"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:19
-msgid "Authorization token"
+#: pretix_matrix_inviter/forms.py:20
+msgid "These products will ask for a Matrix ID."
 msgstr ""
 
 #: pretix_matrix_inviter/forms.py:23
+msgid "Authorization token"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:26
+msgid ""
+"This should be the authorization token of a user that can invite attendees "
+"to the target Room or Space. Please note that other administrators of this "
+"event will be able to see this token, it should not be from your own Matrix "
+"account but from a dedicated Matrix account."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:32
 msgid "Matrix server"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:28
-msgid "Help text for the Matrix ID field"
+#: pretix_matrix_inviter/forms.py:34
+msgid "The matrix server the above authorization token is valid for."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:38
+msgid "Matrix ID field help text"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:41
+msgid ""
+"This will be shown as help text on the Matrix ID field. It is recommended to "
+"inform your attendees to which room they will be invited to and what that "
+"room will be used for."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:33
+#: pretix_matrix_inviter/forms.py:47
 msgid "Invitation message"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:46
+#: pretix_matrix_inviter/forms.py:49
+msgid "This message will be added to the invitation to the Matrix room."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:52
+msgid "Matrix room"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:66
 #, python-brace-format
 msgid "\"{name}\" (<code>{canonical_alias}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:48
+#: pretix_matrix_inviter/forms.py:68
 #, python-brace-format
 msgid "\"{name}\""
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:52
+#: pretix_matrix_inviter/forms.py:72
 #, python-brace-format
 msgid ""
 "\"{name}\" (<code>{room_id}</code>, main alias: <code>{canonical_alias}</"
 "code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:55
+#: pretix_matrix_inviter/forms.py:75
 #, python-brace-format
 msgid "\"{name}\" (<code>{room_id}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:58
-msgid "Matrix room"
-msgstr ""
-
 #: pretix_matrix_inviter/signals.py:22
 msgid "You will be invited to the event's Matrix Space."
 msgstr ""
diff --git a/pretix_matrix_inviter/locale/django.pot b/pretix_matrix_inviter/locale/django.pot
index f5ed7e3..152eb7c 100644
--- a/pretix_matrix_inviter/locale/django.pot
+++ b/pretix_matrix_inviter/locale/django.pot
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-02-08 00:44+0100\n"
+"POT-Creation-Date: 2022-02-08 20:24+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -27,52 +27,79 @@ msgid ""
 "Space."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:14
+#: pretix_matrix_inviter/forms.py:17
 msgid "Ask Matrix ID for"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:19
-msgid "Authorization token"
+#: pretix_matrix_inviter/forms.py:20
+msgid "These products will ask for a Matrix ID."
 msgstr ""
 
 #: pretix_matrix_inviter/forms.py:23
+msgid "Authorization token"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:26
+msgid ""
+"This should be the authorization token of a user that can invite attendees "
+"to the target Room or Space. Please note that other administrators of this "
+"event will be able to see this token, it should not be from your own Matrix "
+"account but from a dedicated Matrix account."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:32
 msgid "Matrix server"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:28
-msgid "Help text for the Matrix ID field"
+#: pretix_matrix_inviter/forms.py:34
+msgid "The matrix server the above authorization token is valid for."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:38
+msgid "Matrix ID field help text"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:41
+msgid ""
+"This will be shown as help text on the Matrix ID field. It is recommended to "
+"inform your attendees to which room they will be invited to and what that "
+"room will be used for."
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:33
+#: pretix_matrix_inviter/forms.py:47
 msgid "Invitation message"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:46
+#: pretix_matrix_inviter/forms.py:49
+msgid "This message will be added to the invitation to the Matrix room."
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:52
+msgid "Matrix room"
+msgstr ""
+
+#: pretix_matrix_inviter/forms.py:66
 #, python-brace-format
 msgid "\"{name}\" (<code>{canonical_alias}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:48
+#: pretix_matrix_inviter/forms.py:68
 #, python-brace-format
 msgid "\"{name}\""
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:52
+#: pretix_matrix_inviter/forms.py:72
 #, python-brace-format
 msgid ""
 "\"{name}\" (<code>{room_id}</code>, main alias: <code>{canonical_alias}</"
 "code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:55
+#: pretix_matrix_inviter/forms.py:75
 #, python-brace-format
 msgid "\"{name}\" (<code>{room_id}</code>)"
 msgstr ""
 
-#: pretix_matrix_inviter/forms.py:58
-msgid "Matrix room"
-msgstr ""
-
 #: pretix_matrix_inviter/signals.py:22
 msgid "You will be invited to the event's Matrix Space."
 msgstr ""
-- 
GitLab