CRM-12325 Corrected erroneous help info on message template page and form, and consol...
authorDave Greenberg <dave@civicrm.org>
Mon, 15 Apr 2013 20:07:14 +0000 (13:07 -0700)
committerDave Greenberg <dave@civicrm.org>
Mon, 15 Apr 2013 20:07:14 +0000 (13:07 -0700)
----------------------------------------
* CRM-12325: Correct and clarify help regarding use of tokens for events, memberships, and activities in message templates
  http://issues.civicrm.org/jira/browse/CRM-12325

templates/CRM/Admin/Form/MessageTemplates.tpl
templates/CRM/Admin/Page/MessageTemplates.hlp
templates/CRM/Admin/Page/MessageTemplates.tpl
templates/CRM/Admin/Page/ScheduleReminders.tpl

index 99bdfba8672b6e5151241c9e9f73164f66deeb33..1d97ce9668664a01b383ba386dbdaebd189ebe53 100644 (file)
@@ -29,7 +29,7 @@
 <h3>{if $action eq 1}{ts}New Message Template{/ts}{elseif $action eq 2}{ts}Edit Message Template{/ts}{else}{ts}Delete Message Template{/ts}{/if}</h3>
 {if $action neq 8}
 <div id="help">
-    {ts}Use this form to add or edit re-usable message templates.{/ts} {help id="id-msgTplIntro" file="CRM/Admin/Page/MessageTemplates.hlp"}
+    {ts}Use this form to add or edit re-usable message templates.{/ts} {help id="id-intro" file="CRM/Admin/Page/MessageTemplates.hlp"}
 </div>
 {/if}
 
index 28035f8703e584724bad7c62deb43463f22188af..8c24b0123f27debab137981c84e4560ec7d299ad 100644 (file)
  +--------------------------------------------------------------------+
 *}
 {capture assign=tokenDocLink}{docURL page="user/common-workflows/tokens-and-mail-merge"}{/capture}
-{capture assign=memberTypesDocLink}{docURL page="user/membership/setup"}{/capture}
+{capture assign=schedRemindersDocLink}{docURL page="user/current/email/scheduled-reminders/"}{/capture}
+{capture assign=schedRemURL}{crmURL p='civicrm/admin/scheduleReminders' q="reset=1"}{/capture}
 
 {htxt id="id-intro-title"}
-  {ts}Message templates{/ts}
+  {ts}Message Templates{/ts}
 {/htxt}
 {htxt id="id-intro"}
 <p>
-{ts}Templates allow you to save and re-use messages with layouts. You can use them when sending email to one or more contacts. If you are using the CiviMail component - you can use templates for your messages. If you are using the CiviMember component, you will need to create one or more message templates for membership renewal reminders.{/ts} {$memberTypesDocLink}
+{ts}Templates allow you to save and re-use messages with layouts. You can use them when sending email or letters to one or more contacts. If you are using CiviMail for enewsletters, newsletter templates take care of the layout so authors can focus on content.</p>{/ts}
+<p>
+{ts}You may include tokens to represent fields (like a contact's "first name") in the message subject and body. These will be replaced with the actual value of the corresponding field in the outgoing message. Click "Insert Tokens" for a searchable list of available tokens.{/ts} {$tokenDocLink}
 </p>
 <p>
-{ts}You may include tokens to represent fields (like a contact's "first name") in the message subject and body. These will be replaced with the actual value of the corresponding field in the outgoing message EXAMPLE: Dear {ldelim}contact.first_name{rdelim}.
-{/ts} {$tokenDocLink}
+{ts 1=$schedRemURL}Messages used for membership renewal reminders, as well as event and activity related reminders generally use tokens specific to membership, participant or activity records. For example, a membership renewal reminder may include the membership type and end date tokens. The <a href="%1">Scheduled Reminders</a> screen includes these tokens in the "Insert Tokens" tool, so it is best to create reminder templates there.{/ts} {$schedRemindersDocLink}
 </p>
 {/htxt}
 
 </p>
 {/htxt}
 
-{htxt id="id-msgTplIntro-title"}
-  {ts}Message Templates{/ts}
-{/htxt}
-{htxt id="id-msgTplIntro"}
-<p>
-{ts}Use this form to add or edit re-usable message templates. Once you save a message template, you can use it when sending mail to one or more contacts. If you are using the CiviMember component, you can also use a message template to send Membership Renewal Reminders. You may include tokens to represent fields (like a contact's "first name") in the message subject and body. These will be replaced with the actual value of the corresponding field in the outgoing message. EXAMPLE: Dear{ldelim}contact.first_name{rdelim}.
-{/ts} {$tokenDocLink}
-</p>
-{/htxt}
-
 {htxt id="id-view_system_default-title"}
   {ts}Default{/ts}
 {/htxt}
index abd4853590d54ad6bcf01a1d82145de5986b79ad..d1db68227d57d905b1e194f9fdaa921c796a7209 100644 (file)
       <div id="{if $type eq 'userTemplates'}user{else}workflow{/if}" class='ui-tabs-panel ui-widget-content ui-corner-bottom'>
           <div class="help">
           {if $type eq 'userTemplates'}
-            {ts}User-driven message templates allow you to save and re-use messages with layouts. They are useful if you need to send similar emails to contacts on a recurring basis. You can also use them in CiviMail Mailings and they are required for CiviMember membership renewal reminders.{/ts} {help id="id-intro"}
+            {capture assign=schedRemURL}{crmURL p='civicrm/admin/scheduleReminders' q="reset=1"}{/capture}
+            {ts 1=$schedRemURL}User-driven message templates allow you to save and re-use messages with layouts. They are useful if you need to send similar emails or letters to contacts on a recurring basis. You can also use them in CiviMail mailings. Messages used for membership renewal reminders, as well as event and activity related reminders should be created via <a href="%1">Scheduled Reminders</a>.{/ts} {help id="id-intro"}
           {else}
-            {ts}System workflow message templates are used to generate the emails sent to consituents and administrators for contribution receipts, event confirmations and many other workflows. You can customize the style and wording of these messages here.{/ts} {help id="id-system-workflow"}
+            {ts}System workflow message templates are used to generate the emails sent to constituents and administrators for contribution receipts, event confirmations and many other workflows. You can customize the style and wording of these messages here.{/ts} {help id="id-system-workflow"}
           {/if}
           </div>
         <div>
index 7cc39e35fc635fe8e61479bc2ae0bbd1b41e514d..6499909da7bf14e2ae31d9d2c9a9973779020fbb 100644 (file)
 {if $action eq 1 or $action eq 2 or $action eq 8 or $action eq 16384}
    {include file="CRM/Admin/Form/ScheduleReminders.tpl"}
 {else}
+{capture assign=schedRemindersDocLink}{docURL page="user/current/email/scheduled-reminders/"}{/capture}
+<div class="help">
+  {ts}Scheduled reminders allow you to automatically send messages to contacts regarding their memberships, participation in events, or other activities.{/ts} {$schedRemindersDocLink}
+</div>
 {if $rows}
     <div id="reminder">
       {include file="CRM/Admin/Page/Reminders.tpl"}