Revision [1493]
Last edited on 2008-01-18 04:19:34 by AlStillero [added note on HTML multi-part messages]Additions:
**Format tab**
~This allows you to choose the **format** of the message (HTML/text only/both). Please note that depending on the options you have offered on your [[EditSubscribePageInfo subscribe page]], your users will have been able to choose messages in either text or HTML format. You can find additional explanations when you click on the question mark ('**?**'):
-**HTML** : HTML to users who have indicated that they want to receive their emails in HTML format, and text to everyone else.
-**text** - text-only to everyone
-**text and HTML** - One single email that contains both the HTML and the text-only formats (this 'multi-part message is larger, but is more likely to work for most users). **Note:** Since version 2.10.5 the "Text and HTML" option is no longer displayed. Instead, all HTML messages will be multi-part messages, i.e. containing both the HTML and the text-only format of the message.
-**PDF** - The text message as a PDF attachment
-**text and PDF** - One email that contains the text only message with a PDF attachment. **Note:** the PDF version will be a conversion of the text message, not of the HTML message. PDF generation requires that you activate this feature when you [[PhpListConfiguration install and configure]] phplist.
~This allows you to choose the **format** of the message (HTML/text only/both). Please note that depending on the options you have offered on your [[EditSubscribePageInfo subscribe page]], your users will have been able to choose messages in either text or HTML format. You can find additional explanations when you click on the question mark ('**?**'):
-**HTML** : HTML to users who have indicated that they want to receive their emails in HTML format, and text to everyone else.
-**text** - text-only to everyone
-**text and HTML** - One single email that contains both the HTML and the text-only formats (this 'multi-part message is larger, but is more likely to work for most users). **Note:** Since version 2.10.5 the "Text and HTML" option is no longer displayed. Instead, all HTML messages will be multi-part messages, i.e. containing both the HTML and the text-only format of the message.
-**PDF** - The text message as a PDF attachment
-**text and PDF** - One email that contains the text only message with a PDF attachment. **Note:** the PDF version will be a conversion of the text message, not of the HTML message. PDF generation requires that you activate this feature when you [[PhpListConfiguration install and configure]] phplist.
Deletions:
~This allows you to choose the **format** of the message (HTML/text only/both). Please note that depending on the options you have offered on your [[SubscribePageInfo subscribe page]], your users will have been able to choose messages in either text and/or HTML format. For most emails, it is recommended to select "##Text and HTML##". You can find additional explanations when you click on the question mark ('**?**'):
**HTML** : HTML to users who have indicated that they want to receive their emails in HTML format, and text to everyone else
**text** - text-only to everyone
**text and HTML** - One big email that contains both the HTML and the text only format (larger emails, but more likely to work for most users)
**PDF** - The text message as a PDF attachment
**text and PDF** - One email that contains the text only message with a PDF attachment
Please note: the PDF version will be a conversion of the text message, not of the HTML message. PDF generation requires that you activate this feature when you [[PhplistInstallation install]] phplist.
Additions:
==[[PhplistDocumentation Phplist Documentation]] » [[MessageFunctionsInfo Message functions]] » [[SendMessageInfo Send a message]] » ==
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
Note: you will receive automatically **two** test messages: one in plain text, one with HTML formatting. When you send the message normally, users will only receive one version (the one they prefer/you chose for them).
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
Note: you will receive automatically **two** test messages: one in plain text, one with HTML formatting. When you send the message normally, users will only receive one version (the one they prefer/you chose for them).
Deletions:
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
Note: you will receive automatically **two** test messages: one in plain text, one with HTML formatting. When you send the message normally, users will only receive one version (the one they prefer/you chose for them).
Additions:
Additionally to [CONTENT], you can add [FOOTER] and [SIGNATURE] to insert the footer information and the signature of the message, but they are optional. Remember to clear the footer of the message if you are using the [FOOTER] placeholder, otherwise you will receive the footer twice.
Deletions:
Revision [630]
Edited on 2006-07-17 17:55:15 by HernoLAdditions:
[[PhplistDocumentation phplist Documentation]]
Deletions:
Additions:
Note: you will receive automatically **two** test messages: one in plain text, one with HTML formatting. When you send the message normally, users will only receive one version (the one they prefer/you chose for them).
Additions:
~This allows you to choose the **format** of the message (HTML/text only/both). Please note that depending on the options you have offered on your [[SubscribePageInfo subscribe page]], your users will have been able to choose messages in either text and/or HTML format. For most emails, it is recommended to select "##Text and HTML##". You can find additional explanations when you click on the question mark ('**?**'):
**If this message has been formatted in HTML**, indicate how you want to send it:
**HTML** : HTML to users who have indicated that they want to receive their emails in HTML format, and text to everyone else
**text** - text-only to everyone
**text and HTML** - One big email that contains both the HTML and the text only format (larger emails, but more likely to work for most users)
**PDF** - The text message as a PDF attachment
**text and PDF** - One email that contains the text only message with a PDF attachment
Please note: the PDF version will be a conversion of the text message, not of the HTML message. PDF generation requires that you activate this feature when you [[PhplistInstallation install]] phplist.
**##? Use Template: [pulldown menu] ##**
~If you use a [[ConfigureTemplatesInfo template]], this message will be placed where the [CONTENT] [[SendMessageInfo placeholder]] is in your template.
Additionally to [CONTENT], you can add [FOOTER] and [SIGNATURE] to insert the footer information and the signature of the message, but they are optional.
**Related pages:**
~[[ConfigureTemplatesInfo Templates]]
~[[PhplistInstallation PDF feature]]
**If this message has been formatted in HTML**, indicate how you want to send it:
**HTML** : HTML to users who have indicated that they want to receive their emails in HTML format, and text to everyone else
**text** - text-only to everyone
**text and HTML** - One big email that contains both the HTML and the text only format (larger emails, but more likely to work for most users)
**PDF** - The text message as a PDF attachment
**text and PDF** - One email that contains the text only message with a PDF attachment
Please note: the PDF version will be a conversion of the text message, not of the HTML message. PDF generation requires that you activate this feature when you [[PhplistInstallation install]] phplist.
**##? Use Template: [pulldown menu] ##**
~If you use a [[ConfigureTemplatesInfo template]], this message will be placed where the [CONTENT] [[SendMessageInfo placeholder]] is in your template.
Additionally to [CONTENT], you can add [FOOTER] and [SIGNATURE] to insert the footer information and the signature of the message, but they are optional.
**Related pages:**
~[[ConfigureTemplatesInfo Templates]]
~[[PhplistInstallation PDF feature]]
Deletions:
Revision [287]
Edited on 2005-05-21 20:27:29 by YanBAdditions:
[[SendMessageAttachInfo Attach tab]]
Additions:
=====Send a Message: Format tab=====
Other tabs:
Format tab
===Description===
**##? Send As: HTML [radiobutton] text [radiobutton] Text and HTML [radiobutton]##**
~This allows you to choose the format of the message. Please note that depending on the options you have offered on your [[SubscribePageInfo subscribe page]], your users will have been able to choose messages in either text and/or HTML format. ''verify -- and document possible problems''
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
Other tabs:
Format tab
===Description===
**##? Send As: HTML [radiobutton] text [radiobutton] Text and HTML [radiobutton]##**
~This allows you to choose the format of the message. Please note that depending on the options you have offered on your [[SubscribePageInfo subscribe page]], your users will have been able to choose messages in either text and/or HTML format. ''verify -- and document possible problems''
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
Deletions:
This is the central feature of Phplist. There are several **options** to send a message using phplist, depending on your needs. For the documentation pages, we will replicate the division by "tabs" you can find in the ##send a message## page:
[[SendMessageFormatInfo Format tab]]
We will begin with "Preliminary remarks" before dealing with the **Content** tab. For the other tabs, please click on the links above.
====Preliminary remarks====
To send a message using Phplist, there are a minimum of four rules to follow:
~1) You have to have a message: you can't send an empty message! So the ##[[SendMessageInfo Content]]## page must be appropriately filled in.
~1) You have to choose one or several lists you will send the message to. So you must choose something in the ##[[SendMessageListsInfo Lists]]## page.
~1) Do not forget to click on #%Save changes#% when you go from one tab to the next.
~1) You have to ##[[ProcessQueueInfo process queue]]## to actually send out the message. See the link for more.
Note: whenever you send a **test message**, none of the rules above apply. It is highly recommended to send yourself a test message if you are unfamiliar with Phplist. Please note that a test message will **not** take into account any [[SendMessageCriteriaInfo Criteria]], but it **will** replace placeholders by the values of the file of the user specified in the address field.
===Tips===
~1) Send yourself a test message before sending our your message. This is particularly true if you send out complex messages with [PLACEHOLDERS] and/or HTML formatting.
~1) Try using [PLACEHOLDERS] whenever you can. This is useful to personalize your emails. See below for more.
~1) Allow people to return to their personal file by adding a [PREFERENCES] link somewhere in your message.
====Content tab====
%%To send a message fill out the information below. The minimum requirement for a valid message
is the information in the "Content" tab. Make sure to save your changes before going to a new tab or
they will be lost. To finish your message and send it for real, choose the "Lists" tab,
select your lists and click the button "Send Message to Selected Mailinglists"%%
~This is self-explanatory :)
**##? Subject: [empty field]##**
~This corresponds to the 'Subject' of your message/email. You cannot use placeholders here.
**##? From Line: [empty field]##**
~If you click on the question mark ('**?**'), you will understand how this field can be appropriately filled in:
~You can use three different methods to set the ##from line##:
~**One word**: this will be reformatted as ##the_word@domain.com##
~~For example: //information// will become ##information@domain.com##, if ##domain.com## is the domain in your [[ConfigurePhplistInfo configuration]].
~~In most email programs this will show up as being from ##information@domain.com##
~**Two or more words**: this will be reformatted as ##the words you type
~~For example: //list information// will become ##list information
~~In most email programs this will show up as being from ##list information##
~**Zero or more words and an email address**: this will be reformatted as ##Words
~~For example: //My Name my@email.com// will become ##My Name
~~In most email programs this will show up as being from ##My Name##
~It is important to **choose your "from line" wisely**, as anyone who wishes to **reply** to the message will reply to this address.
===The text of the message===
**##? Message. [empty text field]##**
~You can write or paste your message in this text field. You can use [PLACEHOLDERS] which will be replaced by the appropriate values for each user. Click on the question mark ('**?**') for the list of placeholders which you can use on your system.
For example if you have an attribute "First Name" put [FIRST NAME] in the message somewhere to identify the location where the "First Name" value of the recipient needs to be inserted.
To send the contents of a webpage, add the following to the content of the message:
[URL:http://www.example.org/path/to/file.html]
You can include basic user information in this URL, not attribute information:
[URL:http://www.example.org/userprofile.php?email=[email]]
//Example://
Imagine your system contains the following attributes: First Name, City, Favorite food. You can send a message formatted like this (please respect the formatting style):
%%Hello [FIRST NAME],
You live in [CITY] and you like to eat [FAVORITE FOOD].
Well we have just what you need!
Please pick up your e-invitation [URL:http://www.pasta.com/user.php?email=[email]]
If you wish to change your settings,
please click on: [PREFERENCES]%%
Once this message is sent, the placeholders are replaced by values for each user, for example:
%%Hello John,
You live in Bigtown and you like to eat Spaguetti with meatballs.
Well we just have just what you need!
Please pick up your e-invitation http://www.pasta.com/user.php?email=john@doe.com
If you wish to change your settings,
please click on http://www.mysite.com/lists/?p=preferences&uid=9589sb938ag93...%%
**##Message Footer.##**
**##Use [UNSUBSCRIBE] to insert the personal unsubscribe URL for each user.
Use [PREFERENCES] to insert the personal URL for a user to update their details.##**
~This is self-explanatory. The default message footer is defined in your [[ConfigurePhplistInfo system configuration]]. In your message, you are free to do what you wish with your message footer: keep it, delete it, change it...
This feature is particularly useful if you have complex messages with several placeholders, links or HTML formatting. What you see is not necessarily what you get, so send yourself a test message to see what the message looks like. The placeholders will be replaced by the values in the file of the user who will receive the test message. If the user is John Doe, and you send John Doe the test message, the placeholder [NAME] will be replaced by... John Doe.
**Related pages**
~-[[ConfigurePhplistInfo system configuration]]
~-[[ProcessQueueInfo process queue]]
