User Tools

Site Tools


Archive Script

(from VPOP3 v6 onwards)

Archive scripting lets you indicate whether full message content should be stored in the message archive. This could be used, for instance, for filtering out messages containing credit card details.

The message headers will still be archived, along with the explanation text returned by the script.

The Lua script is stored in a file called archive.lua which is stored in the VPOP3 directory in VPOP3 v6.6 and earlier, or managed through the Settings → Scripts page in VPOP3 v6.7 and later.

VPOP3 calls a function called ArchiveRules which should have the following prototype:

ArchiveRules(<return path>, <subject>, <time>, <type>, <sender email>, <authenticated sender>, <ip address>, <message-id>, <size>, <attachments>, <recipients>, <references>, <header>, <content>)

This function should return a string which sets the explanation of why the message should not be archived - this explanation is stored in the archived message. If there isn't a return value, or the returned string is blank, VPOP3 will archive the message as normal.

A simple example would be:

function ArchiveRules(retpath, subject, time, type, from, authsender, ipaddr, msgid, size, attch, recipients, references, header, content)

if (subject == "bibble") then
	return "BibbleTest";


If you need, we can produce a script for you, but there would be a cost for this - contact with a specification for a quote.

reference/archive_script.txt · Last modified: 2018/12/05 12:54 by paul