crm.fsf.org/20131203/files/sites/all/modules-old/civicrm/templates/CRM/Mailing/Form/Group.hlp

   1 {*
   2  +--------------------------------------------------------------------+
   3  | CiviCRM version 4.6                                                |
   4  +--------------------------------------------------------------------+
   5  | Copyright CiviCRM LLC (c) 2004-2015                                |
   6  +--------------------------------------------------------------------+
   7  | This file is a part of CiviCRM.                                    |
   8  |                                                                    |
   9  | CiviCRM is free software; you can copy, modify, and distribute it  |
  10  | under the terms of the GNU Affero General Public License           |
  11  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  12  |                                                                    |
  13  | CiviCRM is distributed in the hope that it will be useful, but     |
  14  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  15  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  16  | See the GNU Affero General Public License for more details.        |
  17  |                                                                    |
  18  | You should have received a copy of the GNU Affero General Public   |
  19  | License and the CiviCRM Licensing Exception along                  |
  20  | with this program; if not, contact CiviCRM LLC                     |
  21  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  22  | GNU Affero General Public License or the licensing of CiviCRM,     |
  23  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  24  +--------------------------------------------------------------------+
  25 *}
  26 {htxt id="mailing-name-title"}
  27   {ts}Name{/ts}
  28 {/htxt}
  29 {htxt id="mailing-name"}
  30 {ts}Assign a unique name to each of your mailings. Select a naming convention that will help keep your mailings organized and easy to find when you want to review and compare mailing results. For example, if you do a monthly general-interest newsletter - you might use the following naming convention:{/ts}
  31 <div class="status">
  32 {ts}General Monthly Newsletter: 200709{/ts}
  33 </div>
  34 <p></p>
  35 {/htxt}
  36
  37 {htxt id="base-group-title"}
  38   {ts}Group{/ts}
  39 {/htxt}
  40 {htxt id="base-group"}
  41 <h3>{ts}Search-based mailings require an "unsubscribe tracking" group.{/ts}</h3>
  42 <p>{ts}Because this mailing is using the results of a search to provide the recipient list, you need to specify a group to track people who unsubscribe in response to this mailing.{/ts}</p>
  43 <p>{ts}If a recipient unsubscribes from this mailing, they will be excluded from future mailings which use the same "Unsubscription Group". This is achieved through actually marking the contact as "unsubscribed from the group". If a contact in your search results has already been marked as unsubscribed from that group, they will be excluded from this mailing.{/ts}</p>
  44 <p>{ts}If a recipient clicks the unsubscribe link they will see the "Unsubscription Group" title on the unsubscribe page. The selected group should have a title that corresponds to the content / type of mailing being sent.{/ts}</p>
  45 <p>{ts}NOTE: Contacts who are in the "Unsubscription Group" but do not match your search critera will not be included in the mailing regardless of their status in that group. This is a change from previous versions which used the term "Base Group".{/ts}</p>
  46 {/htxt}
  47
  48 {htxt id="dedupe-email-title"}
  49   {ts}Dedupe{/ts}
  50 {/htxt}
  51 {htxt id="dedupe-email"}
  52 <p>{ts}CiviCRM will always dedupe your mailing based on unique contact records. For example, if a contact is in three of the groups you are including in your mailing, they will only be sent one copy of the email.{/ts}</p>
  53 <p>{ts}However, if the same email is used by multiple contacts, that email address will receive multiple copies of the email -- one for each contact using that address.{/ts}</p>
  54 <p>{ts}Selecting this option will ensure only one email is sent to each address. Note that when using this option and including contact tokens in your email content, the email with it's respective tokens will only be created for one of the matching contacts.{/ts}</p>
  55 {/htxt}
  56
  57 {htxt id="email-selection-title"}
  58   {ts}Email selection{/ts}
  59 {/htxt}
  60 {htxt id="email-selection"}
  61 <p>{ts}Some of your contacts may have more than one email address. By selecting a location and a selection method, you can tell CiviCRM which email address to use for this mailing.{/ts}</p>
  62 <p>{ts}Automatic: If you choose automatic for both the location and the selection method, CiviCRM will choose the best option for each user: If an email is marked "Bulk" then it will be used; otherwise, the email marked "Primary" will be used.{/ts}</p>
  63 <p>{ts}If "Only send to email addresses assigned to the specified location" is selected, then the recipients will be restricted to only include contacts that have an email address assigned to the given location. This option may limit the number of recipients in your mailing.{/ts}</p>
  64 <p>{ts}If "Prefer email addresses assigned to the specified location" is selected, then recipients that have an email address assigned to the given location will have that email used. Other recipients will have their email selected using the automatic method.{/ts}</p>
  65 <p>{ts}If "Exclude email addresses assigned to the specified location" is chosen, then recipients who only have an email address assigned to the given location will be excluded. Everyone else will have their email chosen from the list of emails that are not assigned to the given location, using the automatic method.{/ts}</p>
  66 {/htxt}
  67
  68 {htxt id="include-groups-title"}
  69   {ts}Include Groups{/ts}
  70 {/htxt}
  71 {htxt id="include-groups"}
  72 <p>{ts}Determine the contacts in your database who should receive this mailing by first selecting one or more <strong>Included Groups</strong>. (Groups must be assigned the <strong>Mailing List</strong> type to be available on this screen - you can update this for an existing group from <strong>Manage Groups &raquo; Settings</strong>.){/ts}</p>
  73 <p>{ts}You also have the option to <strong>Exclude</strong> some contacts from your included groups by selecting one or more <strong>Excluded Groups</strong>. Contacts who are in both groups will NOT receive the mailing (they are 'excluded').{/ts}</p>
  74 <p>{ts}If you have sent other mailings - you can additionally Include (or Exclude) contacts who received those mailings. CiviCRM will eliminate any duplications so that contacts who are in an Included Group AND were recipients of an Included Mailing will only be sent one copy of this mailing.{/ts}</p>
  75 <p>{ts}After you click <strong>Next</strong> - the total number of selected recipients will be displayed on the next screen. Use this as a 'reality-check' to help you confirm that you've targeted (and excluded) the desired recipients.{/ts}</p>
  76 {/htxt}
  77
  78 {htxt id="exclude-groups-title"}
  79   {ts}Exclude Groups{/ts}
  80 {/htxt}
  81 {htxt id="exclude-groups"}
  82 <p>{ts}You also have the option to <strong>Exclude</strong> some contacts in your included groups by selecting one or more <strong>Excluded Groups</strong>. Contacts who are in both groups will NOT receive the mailing (they are 'excluded').{/ts}</p>
  83 {/htxt}
  84
  85 {htxt id="include-mailings-title"}
  86   {ts}Include Mailings{/ts}
  87 {/htxt}
  88 {htxt id="include-mailings"}
  89 <p>{ts}If you have sent other mailings - you can additionally Include (or Exclude) contacts who received those mailings. CiviCRM will eliminate any duplications so that contacts who are in an Included Group AND were recipients of an Included Mailing will only be sent one copy of this mailing.{/ts}</p>
  90 {/htxt}
  91
  92 {htxt id="exclude-mailings-title"}
  93   {ts}Exclude Mailings{/ts}
  94 {/htxt}
  95 {htxt id="exclude-mailings"}
  96 <p>{ts}If you have sent other mailings - you can additionally Include (or Exclude) contacts who received those mailings. CiviCRM will eliminate any duplications so that contacts who are in an Included Group AND were recipients of an Included Mailing will only be sent one copy of this mailing.{/ts}</p>
  97 {/htxt}