MTVWebdesign MailPage v2.0

For the latest version of the script, click here.
Thank you for your interest in MTVWebdesign MailPage. Please notice the copyright notice in the scripts.

You should be very careful handling CGI files. If you type something wrong, it might be that the script will fail. We take good care of our scripts and all the script we place on the internet are tested. They work for us. If they don't work for you you'll see an error in the browser, sometimes with a detailed message. Read more about such problems by clicking here.
If you are not an experienced perl programmer, we advice you not to edit the code. (Except the things you need to change as described in "Getting the script to work". If you want to become a perl programmer, we advice you to look over as much scripts as you possibly can. This script included! Make sure you keep a copy of the script before you start changing things. Get to know certain routines etc., and visit sites like the MTVWebdesign Perl section, CGI-Resources.com (A lot of scripts and tutorials), Scriptsearch.com and Developer Daily. Also, we advice you too read messages in cgi-newsgroups.
Good luck!

I will try to give as much information as possible about the use of this script. Hope you understand it all. If not, you can always email me at cgi@mtvwebdesign.hypermart.net.


Features
What's new?
Downloading the script
Requirements
Getting the script to work
Demo of the script
Known problems
FAQ
About MTVWebdesign open source
Disclaimer

Features

You'll find more information about some of the features in the rest of this page.

Back to top


What's new?


Downloading the script

Note: All scripts come in .ZIP format.

Go to http://mtvwebdesign.hypermart.net/scripts/ for the latest version

Back to top


Requirements

You need a server which allows you to execute Perl scripts. (CGI access).

You need to have LWP installed on your server. Ask your webmaster.

The script is tested with success on the following system(s):
Pentium 133Mhz (32 Mb RAM), Apache 1.3.4 and Sambar Perl 5 (ActiveState) build 509 (January 4th 1999), Microsoft Internet Explorer 5.0.

Back to top


Getting the script to work.

Changes in the CGI files

Changes in the mailpage.conf file

Uploading the files

First: Be sure to have the directory read where you want to place your CGI script. Make sure this directory is CHMOD 777. See the FAQ for more information about CHMOD

UPLOAD IN ASCII FORMAT!

  1. mailpage.cgi
    Upload this file to the directory where you want it. CHMOD the file 755.
  2. mailpage.conf
    Upload this file to the place specified in each .cgi file under "require". CHMOD 777.
  3. mtvwebdesign.lib
    Upload this file to the place specified in $mtvwebdesignlib. CHMOD the file 777.
  4. tokenfile.html
    Upload this file to the place specified in $tokefile. CHMOD 644. (Just upload.)

Running the script

You simpley add a link to the script from the pages you want to be available for email:
<a href="/cgi-bin/mailpage/mailpage.cgi">Email this page!</a>
You can also email other pages:
<a href="/cgi-bin/mailpage/mailpage.cgi?url=http://mtvwebdesign.hypermart.net">Email the MTVWebdesign page to a friend!</a>
See the test.html file in the package.

Back to top


Demo of the script

I'm sorry, but there is no working demo of this script right now.

Back to top


Known problems

None at this moment

Back to top


FAQ

What is CHMOD?
CHMOD is changing the attributes of a file. (UNIX systems only.). You should do that when you have uploaded the file, or create a new directory. Most FTP clients (like WS_FTP and BulletProofFTP) have the feature, only they call it CHANGE ATTRIBUTES and won't really show number but instead they show READABLE, WRITEBLE and EXECUTABLE. You can find out what you need to do by using this:

BinaryDecimal
000 = 0
001 = 1
010 = 2
011 = 3
100 = 4
101 = 5
110 = 6
111 = 7

r = readable
w = writeble
x = executable

So to set the permission above, "rw-r--r-x", on the file "test.txt," you would figure out the decimal first:
rw- r-- r-x =
110 100 101 =
6 4 5

I get a 501 Internal server error. What should I do?
Well, you have a problem there....
What you should do first is checking if you uploaded the CGI file in ASCII format and not in BINARY format.
If that doesn't work, check if all the permissions (CHMOD) are set right.
If that doesn't work, check the server error log. Ask your webmaster for more information

What does "premature end of script headers mean"?
You probably uploaded the file in BINARY format. This should be ASCII format.
If that doesn't work, you should check the things you have changed in the script:
Is there a ";" at the end of lines? Are there any missing quotes (")? Etceteras.

How do I use a tokenfile?
First, take a look in the source of tokenfile.html. This is a page which has a tag in the source, which you cannot see when you view it in the browser. The tag is <!-- TOKEN --> (specified in setup.txt at $token). When you select that you want to use a template, Chat with me! will look for the $tokenfile (tokenfile.html) and that it 'll search for the $token. If it finds the token (WHICH NEEDS TO BE PLACE ON A SEPARATE LINE IN THE SOURCE OF THE HTML DOCUMENT!), it'll print it's output at that spot in the html document. This way you get your own nice layout for the Chat with me! service!
TIP: Try to use STYLE tags in the $tokenfile!

Back to top


About MTVWebdesign open source.

MTVWebdesign open source means that if you make a change to the script which you think makes the script run even better, we would like you to sent the change to us. This way, we can keep providing better and better scripts. Your help is very important.

We particularly point out our use of the English language. Since English is not our first language, we cannot make sure that there a no misspellings in the code.

If your made a change which you think makes the script run better, please email the change (script) to opensource@mtvwebdesign.hypermart.net

Back to top


Disclaimer

By using this code you agree to indemnify Maarten Veerman and MTVWebdesign from any liability that might arise from its use.
MTVWebdesign is not responsible for improper use of this script.
Copyright © MTVWebdesign 2000. Selling the code is prohibited.

Back to top


Copyright © MTVWebdesign scripts 2000.