Additions:
~This will place the message in the message queue. To actually send out the message, you will still have to click on the 'Process queue' link on the menu bar on the right, or let a [[SetupCronJob cron job]] process the queue. See also: [[ProcessQueueInfo Process the Message Queue]].
Deletions:
Additions:
~This will place the message in the message queue. You will have to click on the 'Process queue' link on the menu bar on the right, or let a [[SetupCronJob cron job]] process the queue. See also: [[ProcessQueueInfo Process the Message Queue]].
Deletions:
Additions:
**NOTE**: list selection is **not** taken into account when you send a test message.
Deletions:
Additions:
==[[PhplistDocumentation Phplist Documentation]] » [[MessageFunctionsInfo Message functions]] » [[SendMessageInfo Send a message]] » ==
Deletions:
Revision [636]
Edited on 2006-07-17 18:11:27 by HernoLAdditions:
[[PhplistDocumentation phplist Documentation]]
Deletions:
Additions:
**Related pages:**
[[ListAndUserFunctionsInfo Lists]]
[[ListAndUserFunctionsInfo Lists]]
Additions:
[[SendMessageAttachInfo Attach tab]]
Additions:
=====Send a Message: Lists tab=====
[[SendMessageCriteriaInfo Criteria tab]]
Lists tab
%%Please select the lists you want to send it to:
[checkbox] All Lists
[checkbox] list 1 (List is not Active)
[checkbox] list 2 (List is Active)
Select the lists to be excluded.
[checkbox] list 1 (List is not Active)
[checkbox] list 2 (List is Active)
The message will go to users who are a member of the lists above,
unless they are a member of one of the lists you select here.%%
(For an explanation of what an 'active' list is, see [[ListListsInfo lists]].)
The **lists** which are available are the lists which you **own**. See [[ListAndUserFunctionsInfo Lists]].
You can select to send your message to all the lists you own, or to any combination of lists. **You must choose at least one option** to send a message.
You can also select lists you want to **exclude**. If a user is on an excluded list, he/she will not receive your message, even if he/she is on lists which you have selected to send your message to.
//Example:// If a user is on 'list 1' and 'list 2', and you select to send your message to 'list 1' but you //exclude// 'list 2', then your user will **not** receive your message.
#%Send Message to the Selected Mailinglists#% button
**NOTE**: list selection is **not** taken into account when you send a test message. ''please verify! ! ''
[[SendMessageCriteriaInfo Criteria tab]]
Lists tab
%%Please select the lists you want to send it to:
[checkbox] All Lists
[checkbox] list 1 (List is not Active)
[checkbox] list 2 (List is Active)
Select the lists to be excluded.
[checkbox] list 1 (List is not Active)
[checkbox] list 2 (List is Active)
The message will go to users who are a member of the lists above,
unless they are a member of one of the lists you select here.%%
(For an explanation of what an 'active' list is, see [[ListListsInfo lists]].)
The **lists** which are available are the lists which you **own**. See [[ListAndUserFunctionsInfo Lists]].
You can select to send your message to all the lists you own, or to any combination of lists. **You must choose at least one option** to send a message.
You can also select lists you want to **exclude**. If a user is on an excluded list, he/she will not receive your message, even if he/she is on lists which you have selected to send your message to.
//Example:// If a user is on 'list 1' and 'list 2', and you select to send your message to 'list 1' but you //exclude// 'list 2', then your user will **not** receive your message.
#%Send Message to the Selected Mailinglists#% button
**NOTE**: list selection is **not** taken into account when you send a test message. ''please verify! ! ''
Deletions:
Criteria tab
[[SendMessageListsInfo Lists tab]]
Depending on your [[PhplistInstallation system configuration]], you can use a basic or advanced criteria selection process. In both cases, the choice of criteria is important if you wish to reach the proper audience.
The **attributes** which are available depend on the attributes which exist in your system.
**Important**: Only 'select', 'radio', 'checkbox', 'checkboxgroup' and 'date' attributes can be used. You cannot use 'textline' or 'textarea' attributes as a criterion. For more, see [[ConfigureAttributesInfo Configure Attributes]].
==Basic criteria selection==
%%Select the criteria for this message:
to use a criteria, check the box next to it
then check the radio button next to the attribute you want to use
then choose the values of the attributes you want to send the message to
Note: Messages will be sent to people who fit to Criteria 1 AND Criteria 2 etc%%
~This is self-explanatory.
Note that the **only** operator between several criteria is **AND**.
Also, please note that you can select **several values for each attribute**, in which case the operator will be **OR**, but you cannot choose the same attribute twice as a criterion (you cannot choose 'Criterion one: Country' AND 'Criterion two: Country').
//Example://
Imagine your system contains four attributes (the type of attribute is in parentheses):
-Name (textline)
-Country (select)
-Sex (radio)
-Allergies (checkboxgroup)
You can choose the following combination:
-Criteria one:
-Country: Papua New Guinea
-Country: Australia
-Criteria two:
-Sex: Female
-Criteria three:
-Allergies: pollen
-Allergies: cat hair
This will send a message ONLY to {Females} {who live either in Papua New Guinea OR in Australia}, AND {who are allergic to pollen OR cat hair}.
==Advanced criteria selection==
%%Match all of these rules [radiobutton] Match any of these rules [radiobutton]
[select attribute pulldown menu] [rule pulldown menu]%%
The **rules** which are available are:
is : the equivalent of AND
is not : the equivalent of NOT
is before : useful when you use a 'date' type attribute
is after : useful when you use a 'date' type attribute
#%Add criterion#% **button**
//Example://
Imagine your system contains four attributes (the type of attribute is in parentheses):
-Name (textline)
-Country (select)
-Sex (radio)
-Allergies (checkboxgroup)
You can send a message with the following combination:
-Match ALL of these rules
-'Country' IS NOT 'Australia'
-'sex' IS 'Female'
-'Allergies' IS 'pollen'
-'Allergies' IS 'cat hair'
This combination will send a message ONLY to {Females} {who live anywhere EXCEPT Australia}, AND {who are BOTH allergic to pollen AND cat hair}.
===Test message===
**NOTE**: criteria are **not** taken into account when you send a test message. ''please verify! ! ''
