FAQ (Frequently Asked Questions)

  1. The script doesn't work... what's wrong?
  2. Why do I get 'Unauthorized Domain' error?
  3. Why isn't the redirect working?
  4. The file upload doesn't work... what's going on?
  5. How do I use this script on multiple websites?
  6. What are the header and footer parts for?
  7. How do I send the form information to multiple email addresses?
  8. Did I install the script to the right directories?
  9. How do I get extra help?

 


 

1. The script doesn't work... what's wrong?

Each version of the script is tested on multiple sites. Chances are that the script does work. So, if we assume that the script works... let's look at some of the things that might be causing the problem

But first... have you set the $testing variable on? Setting $obj->testing = '1'; in the mailit.php script should give you a LOT of information about what's going on. This is one of the first things I will ask for if you need assistance.

FTP Upload: If you are using Cpanel or any web based system to edit and then upload your files, then there is a VERY strong chance that the longer lines of code will be chopped into smaller pieces so it can fit on the screen. When a line of code is split and spread out over multiple lines, the script will stop working.

Tip: Use a third party ftp client (software) like Cute FTP, FTP Surefer, FileZilla, etc.

Editing Software: The script has been designed so that WordPad and Notepad won't break the script by putting extra carriage returns into the script. If you use either of those two programs to edit the mailit.php file, then you shouldn't have any problems.

Tip: Use an html editor like Dreamweaver, Frontpage, or CoffeeCupHTML. If you don't have these programs, then use WordPad and Notepad to edit the mailit.php file.

No PHP on server: Any decent hosting company will have PHP available on their servers. I doubt that this could be the issue. But, if your hosting company doesn't have php available, then the script won't work. PHP is one of the most popular scripting languages. To see if you have php on your server, either ask your hosting company, or you can rename any html file with a php extension, upload it to your server, find the page with your browser, and see if it works. Example, rename home.htm to home.php

Tip: Change hosting companies if you don't have PHP on your server.

Weird istallation of PHP: To find out some of the details of your php installation, you can upload a file to your server:

<?php
phpinfo();
?>

Call it info.php and point your browser to the file after you upload it.

 

Back to Top

 

2. Why do I get 'Unauthorized Domain' error?

The code has been written so that the there is a verification that the website sending the info to the form is the same website as the one with the script. This happens automatically and should work without any effort on your part.

If it's not working, the most likely cause is that the site is new and hasn't fully propagated yet: In short, this means that the server isn't reading your website's url correctly.

Tip: Wait a few days for your site to fully propagate.

Tip: Reset $obj->referer_check = '0'; to turn it off... you don't really need it

Back to Top

 

3. Why isn't the redirect working?

The script is written to redirect the user to whatever page you put inside the parenthesis of $redirect in the mailit.php file.

Tip: Use a leading slash for your directories(/this/page.htm)... or use the full url (http://www.yoursite.com/this/page.htm).

Also, make sure the page exists, is uploaded to the server, and that you typed the name correctly.

Back to Top

 

4. The file upload doesn't work... what's going on?

In version 2.0 Beta, it's gone. That's because I'm looking for the best way to upload files and at the same time remove some of the problems that folks run into when configuring the script for file uploads. File upload will be back soon.

Permissions incorrectly set: In order for the script to upload a copy to your server just before emailing it to you, the permissions for the folder that the script is in needs to be set to 777. You can do this with just about any third party ftp client or with CPanel, if you have it.

Back to Top

 

5. How do I use this script on multiple websites?

Simple. You install one script per site (minimum) and edit the email address in the $obj->recipient variable.

Back to Top

 

6. What are the header and footer parts for?

This is a nice little feature you can use if you want your error page to look the same as the rest of your site. If you leave these two variables blank, everything will work just fine. But if you want to tailor the script a little further, then you are going to need to spit your html page in two.

Pull up the source code for one of your pages. Regardless of the layout of your site, the code is set up in linear fashion. In other words, whether your navigation for your site is at the top, right side, or left side, the html code has a begginning and an end. What we want to do is cut your source code into two pieces, discard the content of the page, and save the two pieces in what will become our header and footer files.

So find the spot in your source code where the content for your page starts. The content is the verbage that changes from page to page (so we're not talking about the navigation here... got it?). Highlight all of the code the comes BEFORE the first letter of your content and copy it to a new page and save it as "header.php". Now go to the last letter of your content and copy everything that comes AFTER it into a new file and "call it footer.php". Depending on your layout scheme, your navigation stuff might be in the header or footer file. It doesn't matter. The only stuff you should NOT have copied was your content. Everything else should have been put into one of the two files.

Now, the last step is to upload the two files to their own directory and to change the mailit.php file so that the $obj->header and $obj->footer variables point to these new files on the server. Don't forget to put the leading slash (/dir/header.php).

To test it out, pull up your form online and leave a field blank that should be required. If everything is working well, then your error page should look exactly like the rest of your site.

Back to Top

 

7. How do I send the form information to multiple email addresses?

Easy. You just open up the mailit.php file and change $obj->recipient by adding the new email to the comma delimited list. It should look like

$obj->recipient = array("mail@yoursite.com"," info@yoursite.com", "you@earthlink.net");

The above example is set up to send out emails to three addresses.

Back to Top

 

8. Did I install the script to the right directories?

There are some must do's and some should do's. You must have the mailit.php, class.phpmailer.php, class.smtpmailer.php, and class.UFMail.php in the same directory so that they can find each other. Actually, the server finds them... but let's move on. These files should NOT be in your main directory, but should be in their own directory: ufm/ or mailscript/ or whatever you want to call it. The form can be in the same directory or a different one, as long as you make the appropriate changes in the html for the form.

9. How do I get extra help?

You can go to the Ultimate Form Mail Forum and post your question.

Don't forget... I need a link to your form page, that page should have a link to us, and I will want you to post the information you get when you set $obj->testing='1';

Back to Top