Commit | Line | Data |
---|---|---|
d8356d0b CW |
1 | {* |
2 | +--------------------------------------------------------------------+ | |
2c4c49ca | 3 | | CiviCRM version 4.7 | |
d8356d0b | 4 | +--------------------------------------------------------------------+ |
2a73d3b0 | 5 | | Copyright CiviCRM LLC (c) 2004-2017 | |
d8356d0b CW |
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="name"} | |
27 | <p> | |
28 | {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} | |
29 | </p><p> | |
30 | <strong>{ts}General Monthly Newsletter: 200709{/ts}</strong> | |
31 | </p> | |
32 | {/htxt} | |
33 | ||
34 | {htxt id ="from_email"} | |
35 | <p>{ts}Select the "FROM" Email Address for this mailing from the dropdown list. Available email addresses are configurable by users with Administer CiviCRM permission. EXAMPLE: "Client Services" <clientservices@example.org>{/ts}</p> | |
36 | {if call_user_func(array('CRM_Core_Permission','check'), 'administer CiviCRM') } | |
37 | {capture assign="fromConfig"}{crmURL p="civicrm/admin/options/from_email_address" q="reset=1"}{/capture} | |
38 | <p>{ts 1=$fromConfig}Go to <a href='%1'>Administer CiviCRM » Communications » FROM Email Addresses</a> to add or edit email addresses. Make sure these email addresses are valid email accounts with your email service provider.{/ts}</p> | |
39 | {else} | |
40 | {ts}Contact your site administrator if you need to use a "FROM" Email Address which is not in the dropdown list.{/ts} | |
41 | {/if} | |
42 | {/htxt} | |
43 | ||
44 | {htxt id="html"} | |
45 | <p>{ts}You can choose to send BOTH an <strong>HTML</strong> and a plain <strong>TEXT</strong> version of your mailing, OR you can send a <strong>TEXT</strong> version only.{/ts}</p> | |
46 | <p>{ts}If you create only an <strong>HTML</strong> version, CiviMail will automatically create a <strong>TEXT</strong> version for your recipients who have chosen NOT to receive HTML email.{/ts}</p> | |
47 | <h1>{ts}Required Elements{/ts}</h1> | |
48 | <p>{ts}CiviMail email messages must include an <strong>opt-out</strong> link ("Opt out via web page"), and the <strong>postal address</strong> of your organization. These elements help reduce the chances of your email being categorized as SPAM. They can be included in the main message body OR in a re-usable <strong>message footer</strong>. Refer to the online documentation for details on how to include required links and contact information as well as sample messages.{/ts} {docURL page="Sample CiviMail Messages" resource="wiki"}</p> | |
49 | {/htxt} | |
50 | ||
51 | {htxt id="text"} | |
52 | <p>{ts}You can send your email as a simple text-only message, as an HTML formatted message, or both. Text-only messages are sufficient for most email communication - and some recipients may prefer not to receive HTML formatted messages.{/ts}</p> | |
53 | <p>{ts}HTML messages have more visual impact, allow you to include images, and may be more readable if you are including links to website pages. However, different email programs may interpret HTML formats differently - so use this option cautiously unless you have a template format that has been tested with different web and desktop email programs.{/ts}</p> | |
54 | {/htxt} | |
55 | ||
56 | {htxt id="header"} | |
57 | <p>{ts}You may choose to include a pre-configured Header block above your message.{/ts}</p> | |
58 | {/htxt} | |
59 | ||
60 | {htxt id="footer"} | |
61 | <p>{ts}You may choose to include a pre-configured Footer block below your message. This is a good place to include the required unsubscribe, opt-out and postal address tokens.{/ts}</p> | |
3edc9b05 CW |
62 | {/htxt} |
63 | ||
64 | {htxt id="dedupe_email"} | |
65 | <p>{ts}Multiple people -- such as spouses, parents, or children -- may sometimes share the same email address.{/ts}</p> | |
66 | <p>{ts}To send only one message to the shared address, enable this option. Mail-merge tokens will be filled for only one person.{/ts}</p> | |
67 | <p>{ts}To send separate messages for each person, disable this option. Mail-merge tokens will be filled separately for each person.{/ts}</p> | |
68 | {/htxt} | |
69 | ||
70 | {htxt id="visibility"} | |
71 | <p> | |
72 | {ts}This option controls who can view the contents of this email on your website. The link can be included by inserting the "Mailing permalink" token (place it in a link when composing in HTML mode).{/ts} | |
73 | </p><p> | |
74 | {ts}The options for mailing visibility are:{/ts} | |
75 | </p> | |
76 | <ul> | |
77 | <li> | |
78 | {ts}"Public Pages" will make the content of this mailing viewable everyone who has the permission "view public CiviMail content". Note that even people who did not receive the mailing would be able to find it via search engines.{/ts} | |
79 | </li> | |
80 | <li> | |
81 | {ts}"User and User Admin Only" means that only users that received the mailing or administrators can view this email on your website; users must be logged in to view the message.{/ts} | |
82 | </li> | |
83 | </ul> | |
84 | {/htxt} | |
85 | ||
86 | {htxt id="test"} | |
87 | <p>{ts}It's a good idea to test your mailing by sending it to yourself and/or a selected group of people in your organization.{/ts}</p> | |
88 | <p>{ts}Things to check in a test mailing:{/ts}</p> | |
89 | <ul> | |
90 | <li>{ts}Verify the content and formatting looks consistent across various email clients.{/ts}</li> | |
91 | <li>{ts}If you are using mail-merge tokens, check that they have been replaced with expected values.{/ts}</li> | |
92 | <li>{ts}Click on each included link to make sure they go to the expected web pages.{/ts}</li> | |
93 | </ul> | |
1dda695b CW |
94 | {/htxt} |
95 | ||
96 | {htxt id="url_tracking"} | |
97 | <p> | |
98 | {ts}Track the number of times recipients click each link in this mailing.{/ts} | |
99 | </p><p> | |
640dc3e5 | 100 | {ts}NOTE: When this feature is enabled, all links in the message body (including mailtos) will be automatically re-written to route through your CiviCRM website prior to redirecting to the target page.{/ts} |
1dda695b CW |
101 | </p> |
102 | {/htxt} | |
103 | ||
104 | {htxt id="open_tracking"} | |
105 | <p> | |
106 | {ts}Track the number of times recipients open this mailing in their email software.{/ts} | |
107 | </p> | |
108 | {/htxt} | |
109 | ||
110 | {htxt id="override_verp"} | |
111 | <p> | |
112 | {ts}Recipients' replies are sent to a CiviMail specific address instead of the sender's address so they can be stored within CiviCRM.{/ts} | |
113 | </p> | |
114 | {/htxt} | |
115 | ||
116 | {htxt id="auto_responder"} | |
117 | <p> | |
118 | {ts}If a recipient replies to this mailing, send an automated reply using the selected message.{/ts} | |
119 | </p> | |
120 | {/htxt} | |
121 | ||
122 | {htxt id="forward_replies"} | |
123 | <p> | |
124 | {ts}If a recipient replies to this mailing, forward the reply to the FROM Email address specified for the mailing.{/ts} | |
125 | </p> | |
d8356d0b | 126 | {/htxt} |