From 94cc262c2170ee74881d474ed8f901ed53bd6b1a Mon Sep 17 00:00:00 2001
From: Jens Schuppe <schuppe@systopia.de>
Date: Fri, 14 Aug 2020 10:25:04 +0200
Subject: [PATCH] [#36] Add help text for the Newsletter Double-Opt-In setting

---
 templates/CRM/Twingle/Form/Profile.hlp |  4 ++++
 templates/CRM/Twingle/Form/Profile.tpl | 19 ++++++++++++++++++-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/templates/CRM/Twingle/Form/Profile.hlp b/templates/CRM/Twingle/Form/Profile.hlp
index 8a89223..12136cb 100644
--- a/templates/CRM/Twingle/Form/Profile.hlp
+++ b/templates/CRM/Twingle/Form/Profile.hlp
@@ -38,6 +38,10 @@
     {ts domain="de.systopia.twingle"}Select which financial type to use for recurring contributions.{/ts}
 {/htxt}
 
+{htxt id='id-newsletter-double-opt-in'}
+    {ts domain="de.systopia.twingle"}Select whether to use CiviCRM's Double-Opt-In feature for subscribing to mailing lists. Note that this only works for public mailing lists. Any non-public mailing list selected above will be ignored when this setting is enabled.{/ts}
+{/htxt}
+
 {htxt id='id-membership-postprocessing-call'}
     {ts domain="de.systopia.twingle"}Some organisations have specific conventions on how a membership should be created. Since the Twingle-API can only create a "bare bone" membership object, you can enter a API Call (as 'Entity.Action') to adjust any newly created membership to your organisation's needs.{/ts}
     {ts domain="de.systopia.twingle"}The API call would receive the following parameters:<ul>
diff --git a/templates/CRM/Twingle/Form/Profile.tpl b/templates/CRM/Twingle/Form/Profile.tpl
index 83dc4cb..ec51647 100644
--- a/templates/CRM/Twingle/Form/Profile.tpl
+++ b/templates/CRM/Twingle/Form/Profile.tpl
@@ -214,7 +214,24 @@
         </tr>
 
         <tr class="crm-section">
-          <td class="label">{$form.newsletter_double_opt_in.label}</td>
+          <td class="label">
+            {$form.newsletter_double_opt_in.label}
+            <a
+                    onclick='
+                            CRM.help(
+                            "{ts domain="de.systopia.twingle"}Newsletter Double Opt-In{/ts}",
+                    {literal}{
+                      "id": "id-newsletter-double-opt-in",
+                      "file": "CRM\/Twingle\/Form\/Profile"
+                    }{/literal}
+                            );
+                            return false;
+                            '
+                    href="#"
+                    title="{ts domain="de.systopia.twingle"}Help{/ts}"
+                    class="helpicon"
+            ></a>
+          </td>
           <td class="content">{$form.newsletter_double_opt_in.html}</td>
         </tr>