|
|
Attachment Mailer Plus List of Categories
Attachment Mailer Plus - Formmail Manager supporting unlimited form and file attachments
- How do I customize the "Back" and "Submit" buttons on the Preview Page?
- How do I add a link for uploaded files to the email notifications?
- How can I customize the Preview Page?
- My Customers are not receiving their Autoresponder, why?
- How do I exclude the Progress Meter if I have no file Upload fields?
- What rights does the Subordinate Administrator have and how do I log in as the Subordinate?
- How do I implement the onSubmit event handler in my form?
- I'm receiving a 404 error when trying to Export submissions, why?
- What happens when filenames contain invalid characters?
- Can a User select a recipient from a list to direct Admin notifications to?
-
How do I customize the "Back" and "Submit" buttons on the Preview Page?
These buttons can be rendered by editing the bbuttemplate.ftf (Back Button) and nbuttemplate.ftf (Next or Submit Button) files respectively. The files are located, from your home page directory, in a folder named:
/psjs_datalogs/amp[$FolderPass]/default
where $FolderPass is the $FolderPass you set in the amp_key.cgi file. The code in these files is used for all of your Forms. Both buttons are printed in a table set to the same width as the Preview Table and aligned to the right.
The Preview Table's width can be defined in each Form's Settings in the "Preview Page Template" Settings area.
-
How do I add a link for uploaded files to the email notifications?
You can use the following markers in both the customer notification and your notification by editing the Email templates found in the Form Settings.
Remember to use the same numeral used in your Upload field
To print just the uploaded file name :
%%%FILE1%%%
To print the URL for the uploaded file :
%%%FILE1Href%%%
To print an HTML link for the uploaded file :
%%%FILE1Link%%%
To print the server's path for the uploaded file :
%%%FILE1Path%%%
To print the size of the uploaded file :
%%%FILE1Size%%%
Notes :
- Plain text email notifications should make use of %%%FILE1Href%%% rather than %%%FILE1Link%%% as all HTML is tripped from Plain Text messages.
- If you've set AMP to delete files after emailing them, using the link markers would be pointless.
-
How can I customize the Preview Page?
While the Preview Page header and footer is completely customizable, and the Preview Table embeded within the page can have it's background colors, width and custom message defined, the fields that appear within the table are auto-generated.
Attachment Mailer Plus will parse your Form and gather all Form fields found. It will then print the gathered fields in the order you have defined in the Form's "Form Field Sorting Order" template.
Each Form field has it's name printed in the left table cell and the value entered by the User in the right table cell. As such, we suggest naming your Form fields descriptively (as described in the User Guide in the What you should do chapter).
-
My Customers are not receiving their Autoresponder, why?
Several Settings affect Autoresponder functionality. First, if possible, try using a different email address as the Customer's email address. If the message still does not arrive, check all of the following :
- Your HTML Form must contain a form field named "email" in lowercase. This is the most common mistake. Be sure your Website Form has this tag :
<input type="Text" name="email">
- Be sure your Form's Settings have a Valid E-mail Address defined in the "Admin Email" field. The Customer's Autoresponder uses the "Admin Email" value as the sender.
- Be sure your Form's Settings, in the "Customer Notification Template" sub-section, have "Send Autoresponder" set to "Yes".
- In the same area just beneath the "Send Autoresponder" setting, make sure you have entered a message to send in the large text box.
- If sending File Attachments in the Customer's Autoresponder, try a submission without the Attachment to see if the message comes in.
- Check you have entered the correct path in the "Path to Mail Program" in your Form's Settings. Try some other common sendmail paths.
- If on a Windows server, you may need to set an "Admin Email" address in the Settings that matches your Path to Mail Program Setting, and also matches the domainname you're running the Scripts on. For example :
Admin Email : you@yoursite.com
Path to Mail Program : mail.yoursite.com
Your Website Address : http://www.yoursite.com
- On Linux/Unix/Mac type servers employing sendmail, you could try utilizing the -f switch. You'll need to edit the amp_cfg.cgi file and search for the following line of code :
if(open(M, qq~|$CONFIG{mailprogram} -t ~)){
then change it to :
if(open(M, qq~|$CONFIG{mailprogram} -t -f "you\@yoursite.com"~)){
Take care with the syntax involved in the new code. You're only adding the red code shown above, a copy and paste would be safest, then replace the "you\@yoursite.com" with one of your email accounts, but be sure to retain the escape slash (\) before the @ sign in your email address. Upload the changes, try your luck.
- This Free Mail Testing Script does nothing but send a message to the email address specified within it, then prints whether or not sendmail was invoked and any server returned errors that may have been spawned. You may want to try it, then point your host to it and ask them where your messages are:
- Download the Mail Server Tester CGI Script
- Edit in your email address using a Plain Text editor
- Upload the Mail Server Tester CGI Script to your server in ASCII Mode
- I say ASCII Mode because if you don't, last step will yield Server 500 Error.
- CHMOD the Mail Server Tester CGI Script to 755
- Load the Mail Server Tester in your Web browser
If after checking and trying all of the above your server still fails to deliver the Customer's Autoresponder, I have only these three remaining streams of thought to offer :
- The Mail Server you're sending the Message to: has blacklisted your server; has Mail Filters such as Spam Assassin deployed by either the Host or the Customer which is deeming your message to be Spam and is deleting before it reaches the recipient; cannot be reached by your server; or is in some other way not handling your Message in the correct manner.
- Your server has trouble delivering successive messages. The mail program may fail to Shutdown after processing the first message; The mail server may not be running (Qmail is notorious for shutting down for hours for no apparent reason); The mail server may be jammed with mail or there may be a huge queue and your message has to wait it out.
- The intended recipient of the Message: has a full inbox; has their mail forwarded to another account; has not even created the account you're testing; has not properly configured the account in their Mail Client (Outlook, Eudora, etc.).
Still no Customer email? Only your host can help you resolve this problem now.
-
How do I exclude the Progress Meter if I have no file Upload fields?
The Progress Meter will not appear at all if you set "Use Progress Meter" to "No" in the Form's Settings. If you have it set to "Yes" and also have "Initial State" set to "Hidden" and your Form contains no file transfer fields, the Progress Meter will not appear.
Note: in either case, you must still include the generated <script> somewhere in your HTML document for the Form to be processed. When "Use Progress Meter" is set to "No" only a few lines of Javascript code are transparently printed to your web page so the download time is not discernibly affected.
-
What rights does the Subordinate Administrator have and how do I log in as the Subordinate?
When you set up Attachment Mailer Plus, a Subordinate Administrator was automatically created with the following log in details:
Username: 222222
Password: 222222
If you're already logged in, click the "Log out" link in the Admin Control Panel and log back in using 222222/222222
The subordinate Administrator cannot :
Delete any Form's submissions
Edit any Form's submissions
Delete any forms
Cannot send any mail using the internal mail program
Cannot create, edit or view the Multi-Page Form Manager
Cannot view or edit any Form's Settings nor the Default Settings
-
How do I implement the onSubmit event handler in my form?
Each Form, whether processing file uploads or not, must not include a Submit input tag. Instead a regular Button input tag is used. The code generated in the Admin Section produces a Button input tag which evokes a function named transInit() when it's clicked.
<input type="button" value="Submit" onclick=" transInit( this ) ">
The Button can be labelled Submit in the value attribute, though the Button type must be Button. The <script> tag generated will define the Form's dynamic values and Submit the Form once all checks1 are successfully passed.
To execute a JavaScript function you've written, to validate your Form for example, specify it as the 2nd argument of the transInit() function. If your function is named validateForm(), then the code should look like such :
<input type="button" value="Submit" onclick=" transInit( this , validateForm() ) ">
Take note of the newly included comma (to delimit the two arguments) and the number of parenthesis used. The transInit() function will first process your function, and break or terminate if your function returns a false value. If your function returns true, positive, or nothing at all, the transInit() function will continue processing the Form. Following is the code for a complete Form including a custom function, set to be executed when the Form is submitted, which will check to see if the User has entered a First Name.
The Form's HTML
<form action="http://www.web.com/amp/amp.cgi?process" enctype="multipart/form-data" method="post" style="display:inline;">
<input type="Hidden" name="required" value="fname,email">
<input type="Hidden" name="id" value="1141398164">
<input type="Text" name="fname"> First Name
<input type="Text" name="email"> E-mail
<input type="button" value="Submit" onclick="transInit(this, validateForm(this.form))" value="Submit">
</form>
<script src="http://www.web.com/amp/amp.cgi?printjs=1141398164" language="JavaScript"></script>
The Form's Custom Validation function and JavaScript
<script>
function validateForm( f ){ // we pass the form object for easy reference
if( f.fname.value.length < 1 ){ // check the character length of the input
alert( "Please enter your First Name" );
return false; // return false
} // if the script gets this far, it returns nothing and the transInit() function takes over
}
</script>
Notes :
- The generated <script> tag transparently prints all required JavaScript to your web page.
- The generated <script> tag's transInit() function will check the File Upload fields, if any, for : duplicate file names to avoid unnecessary processing of file transfers; check to ensure any selected file names have an extension permitted by you in the Admin Section settings and then prepare the Form data for transmission. All of these checks take place prior to the Form's submission, immediately trapping any errors, alerting your Customers of the corrections required and saving them a potentially long and possibly disappointing wait.
- Once the Form has been submitted, AMP immediately checks the Form's total data size against the permitted size set by you in the Admin Section settings. If the Form's data size (including files selected for upload) exceeds that allowed, AMP will again immediately exit rather than force your Customers to sit out the wait and agonizingly try again.
-
I'm receiving a 404 error when trying to Export submissions, why?
Open up your copy of amp_key.cgi and edit the following found on line 34 :
$ExportURL = "http://www.YOURSERVERNAME.com/psjs_datalogs/amp$FolderPass/data";
Enter your actual domain name in place of "YOURDOMAINNAME". Then upload the script to your server so that it overwrites your current copy.
-
What happens when filenames contain invalid characters?
Filenames that contain any character other than alpha-numeric characters, dashes or periods (.) automatically have the illegal characters replaced with an underscore (_). Illegal characters include spaces, plus signs and foreign language characters. The files do not need to be renamed by your Users.
-
Can a User select a recipient from a list to direct Admin notifications to?
Yes, by adding a field named "toemail" to your forms, the User can either pull in, or override the Admin email Setting defined in the Form's Settings.
To pull in the email addresses defined in the Admin email Setting use :
<input type="Hidden" name="toemail" value="2,4">
This will direct email notifications to the 2nd and 4th email addresses defined in the Admin Email Setting in the back end. Multiple email addresses can be separated by commas. Additionally, corresponding names can be assigned for each email address by using a field named "toname".
<input type="Text" name="toname" value="2,4">
If you have the following email addresses defined in the Admin Email Setting :
a@a.a, b@a.a, c@a.a, d@a.a
Then the above example would send email notifications to b@a.a and d@a.a
Both of these fields can also be defined as drop down select menus, or radio buttons allowing Users to select from multiple recipients. For example :
<select name="toemail">
<option value="2">Mark
<option value="2,4">Lisa and James
</select>
To override the email addresses defined in the Admin email Setting use :
<input type="Hidden" name="toemail" value="mark@yourserver.com,lisa@yourserver.com">
Multiple email addresses can be separated by commas. Additionally, correlative names can be assigned for each email address by using a field named "toname".
<input type="Text" name="toname" value="Mark Thompson, Lisa Williams">
Both of these fields can also be defined as drop down select menus, or radio buttons allowing Users to select from multiple recipients. For example :
<select name="toemail">
<option value="mark@yourserver.com">Mark
<option value="lisa@yourserver.com">Lisa
</select>
|
|
|