PopMonger Manual

>> Home > M5 PopMonger: Powerful Inbound Email Processing

PopMonger Home | My Mach5 | Download | Support | Buy Popmonger

Online Manual
Welcome Mailboxes Tasks -Task Wizard -Task Rules -Task Actions -Task Examples Logging Scripting JScript PHP Scripts Visual Basic Survey Handling Debugging Run as Service General Information
PopMonger Links
PopMonger Home Download Popmonger Version History See what's new in the latest version Contact Support We are here to help you via email. We will do our best to get back to you right away.

Untitled Document

Explore M5 Mailer

Take the bulk out of email! ^TM

Use your own data

Personal email merge

Send individual email

HTML and/or text

Handy email templates

Explore M5 Subscriber

Web-based list management made simple!

Simple subscribe tool

Opt-in confirmed

Track reads and clicks

Custom matching look

Free for up to
5000 contacts

PopMonger Scripting Details

With a PopMonger Gold license, included with all paid versions of Mach5 Mailer, Popmonger gains built-in scripting capabilites to handle inbound email in complex ways.

You can script your inbound email handling with VBScript, JScript, or PHP. Please Note: All scripts can start and end with Mailer's scripting delimiters: <? and ?>. As of PopMonger 3, this is no longer necessary for VBScript and JScript scripts, but is generally conventional for PHP.

For each language, PopMonger provides a predefined context variable that makes a number of functions and properties conveniently available to you, as well as the entire contents of the email message. This information comes through the PopMonger object, which PopMonger initializes for you before executing your script.

PopMonger can return various parts of the content of each email through three separate function calls: HeaderText, BodyText, and MessageText.

HeaderText returns the entire message header as a string, with one header per line and a colon separating the name from the content.
BodyText returns the entire message body as a string.
MessageText returns the entire raw text of the email message including headers, html and text portions of the body, and any MIME encoded attachments.

When a message bounces, you can get the original mailing address with the FailedAddress property.

You can get the content of any specific header field with the HeaderField function. For example PopMonger->HeaderField("To") will return the recipient email address.

You can get the number and types of sections in an email with the MimePartsCount and the MimePart functions. The MimePartsCount function returns the number of MIME sections in the email, and the MimePart function returns that section as a string.

If your task includes field parsing with delimiters, you can access the field data and number of fields present through the Field function and FieldsCount property.

You can also instruct PopMonger to send messages (see note). RedirectMessage will redirect the message to an alternative address or addresses, unaltered. ReplyWithText will send a text reply. SendMail will send an arbitrary message. The Extra Headers variable of SendMail shoud include one header per line.
The SaveToFile function is a convenience available for you to save information during scripting to any file.

The class definitions for JScript, PHP, and VBScript are:

JScript

class object Popmonger

String HeaderText;
String BodyText;
String MessageText;
String FailedAddress;
String HeaderField(String sHeader_name);
String Field(int iFieldNumber);
int FieldsCount;
String MIMEPart(int iPartNumber);
int MIMEPartsCount;
void RedirectMessage(String "sTo_address1,To_address2,To_address3");
void ReplyWithText(String sFrom_address, String sSubject, String sReply_text);
void SendMail(String sFrom_address, String sTo_address,
String sSubject_text, String sBody_text, String sEx_headers);
void SaveToFile(sFile_name, sText_to_save, bIsAppend);

PHP

class object Popmonger

string HeaderText;
string BodyText;
string MessageText;
string FailedAddress;
string HeaderField($sHeader_name);
string Field($iFieldNumber);
int FieldsCount;
string MIMEPart($iPartNumber);
int MIMEPartsCount;
void RedirectMessage("sTo_address1,To_address2,To_address3");
void ReplyWithText($fsFom_address, $sSubject, $sReply_text);
void SendMail($from_address,$sTo_address,$sSubject_text,$sBody_text,$sEx_headers);
void SaveToFile($sFile_name, $sText_to_save, $bIsAppend);

VBScript

object Popmonger

Public Property HeaderText
Public Property BodyText
Public Property MessageText
Public Property FailedAddress
Public Function HeaderField (sHeader_name)
Public Function Field (iFieldNumber)
Public Property FieldsCount
Public Function MIMEPart (iPartNumber)
Public Property MIMEPartsCount
Public Function RedirectMessage ("sTo_address1,To_address2,To_address3")
Public Function ReplyWithText (sFrom_address, sSubject, sReply_text)
Public Function SendMail (sFrom_address, sTo_address, sSubject_text, sBody_text, sEx_headers)
Public Function SaveToFile (sFile_name, sText_to_save, bIsAppend)

NOTE: Sending messages from within Popmonger requires a licensed copy of Mach5 Mailer. The Gold, Regular, and Free versions of Mach5 Mailer all meet this requirement. The unregistered Trial version does not. Go back to top of page