To get to this page, go to Utilities -> VPOP3 Extensions.
VPOP3 Extensions are external programs which are run when certain events occur.
Note that in VPOP3 V2 and later, we recommend the use of Plugins where possible, as these are more tightly integrated with VPOP3, and allow more flexibility in operation.
VPOP3 supports four possible extensions.
External Router This is a program which is used to programmatically route incoming POP3 messages from the Internet. See here for details on External Router operation.
OutMail
Pre-processor This is a program which is executed for each
message which is sent to the VPOP3 SMTP service. See here
for details on OutMail Pre-processors.
Run OutMail Processor for Local Mail If this is enabled,
then the OutMail Pre-processor will be executed for messages to local
recipients as well as outgoing messages. (This works for local and incoming
SMTP mail)
SMTP Client Processor This is a program which is executed each time VPOP3 sends a message to the ISP. This program is run whilst VPOP3 is online, so it will increase the online time. This means that the program can access other Internet resources because it knows it has an active Internet connection. See here for details on SMTP Client Processors.
Post-Connect Command This is a program which is executed just after VPOP3 has connected to an ISP.
Pre-Disconnect Command This is a program which is executed just before VPOP3 has disconnected from an ISP.
The VPOP3 extensions are defined by entering the program to run and any parameters to use in the VPOP3 Extensions window:
If the extension is an executable program (.EXE) then just enter the full path to the program (e.g. c:\myprogs\myextension.exe).
If the extension is a batch file (.BAT) then enter COMMAND.COM (Windows 95) or CMD.EXE (Windows NT) with the parameters /c followed by the batch file name (e.g. c:\windows\command.com /c c:\vpop3\myextension.bat).
If the extension is a PERL script (.PL) then enter PERL.EXE with the script name as the parameter (e.g. c:\perl\bin\perl.exe "c:\program files\myextension.pl")
(Note: if there are any spaces in the path to the program or script, then that path must be surrounded by double quotes, as in the PERL example above)
The Timeout settings tell VPOP3 how long each program should be allowed to run before being terminated by VPOP3. The values are in seconds.
The Ignore Return Code settings let you tell VPOP3 that the extension program may return a DOS errorlevel code which should be ignored. If you do not have these checkboxes checked, then VPOP3 will assume that the program failed if it returns an errorlevel code other than 0 (zero).
These commands are run just after VPOP3 connects or just before it disconnects from the ISP. The same program is run for each Connection, but the environment variable CONNECTION is set to the appropriate connection number (1 - 10) depending on which connection has been made or is about to be closed.
