CashMail Documentation

CashMail Documentation *

Description *

Installation *

Running *

Description

CashMail allows you to run a pay per email Opt-in list like the big boys for a fraction of the costs! What this script does is allow webmasters to signup as affiliates of your program and place the code for your program on their pages, which allows surfers to enter their email addresses to join your mailing list. Each time a surfer enters their email, the refering webmaster gets paid a set amount. Example: 5 cents per email addy.

Installation

#1. edit add.cgi signup.cgi remove.cgi and shared.pm... toward the top there are a few variables you need to set. also make sure the #!perl path is correct at the top of all the scripts.

#2. edit all templates that you see fit to edit... ill give you a short run down on them all.

all %word%'s are replaced by somthing or another by the script automaticly

templates/confirmed.tmpl
This is displayed after a user clicks the confirmation link in the email that is sent and they are added to the list.

templates/mail/confirm.tmpl
This is the email that is sent to users after they signup from one of your advertisers pages. should include the %confirmurl% that is in there. as that is where they have to go to confirm thier wanting to join.

templates/mail/webmaster.tmpl
this is the mail that is sent to new webmasters when they signup for your program. should include url to thier stats page and sample form and such.

templates/stats/header.tmpl
top of webmaster stats page. If you need anything added lemme know.

templates/stats/new_line.tmpl
this is the html code for 1 line of thier stats... date, raw, confirmed, amt earned...

templates/stats/footer.tmpl
bottom of webmaster stats page.

templates/stats/login.tmpl
this is the webmaster login page...

templates/stats/edit.tmpl
page for webmasters to change thier info.

templates/stats/user_updated.tmpl
shown to webmaster after they update stats.

templates/errors/*
allready_added.tmpl: email is allready on mailing list.
invalid_code.tmpl: confirmation code in confirm.cgi is invalid.
invalid_username.tmpl: webmaster inputted invalid username.
bad_email.tmpl: invalid email passed to add.cgi
username_in_use.tmpl: webmaster username is allready in use.


templates/admin/*
payout_report.tmpl: format of payout reports...
main_(head|foot|stat_line).tmpl: header/footer/stat lines for main admin page.

templates/admin/stats/*
admin stats... same as the ones in templates/stats but for admin use...

#3. file permissions and .htaccess
chmod 777 data/ data/users/
chmod 666 data/emails.txt data/errors.log data/pending.db
chmod 755 *.cgi

all other files should be readable by apache

ive included an example.htaccess which password protects the admin.cgi and blocks access to .htaccess .htpasswd and all the perl modules (*.pm) there are also .htaccess's in data/ and data/users/ blocking all files in those directories...

Running

signup.cgi is the webmaster signup script, there is an example form in example.join.html.

add.cgi is where webmasters send thier emails to... theres a basic form in the template that is mailed to webmasters(templates/mail/webmaster.tmpl). to redirect incoming surfers back to the webmasters page you can do somthing like this:

in the cgi, make the $thankyoupage, $thankyoupage="thanks.shtml?$ENV{HTTP_REFERER}"; then create thanks.shtml, and use SSI and the query string to send them back.. eg:

<html>
<body>
Thanks for joining. you have been sent a confirmation email... follow
the directions in the email to signup...<br>

<a href="<!--#echo var="QUERY_STRING"-->">Click here to return to the page you were at.</a>
</body>
</html>

remove.cgi, this is how people remove themselves from your list... sample form:

<form action=remove.cgi method=get>
<input type=text name=email>
<input type=submit value="Remove">
</form>

stats.cgi, webmaster stats cgi... called with no args or invalid username/pass brings up login screen.

last but not least admin.cgi, view stats, payouts, mail users and view payout reports... for the mail, From name: is sent as your name, From address is the reply email address, the rest should make sense. give it a test run if u dont understand, should make sense once u try it. to view a page with all the totals and addresses for a given month, choose the month/year and click the button on the bottom of the page. output is changable in the templates/admin/payout_report.tmpl file.


Proud suppliers of perl cgi and php applications created from the webmasters point of view. PerlCoders supplies top quality CGI scripts at membership warehouse prices every day. This is the only webmaster resource you need to build traffic and add interactive content to any website.

Need custom programming or website development? We do it all. Just use our contact form and let us know what you need.

Perlcoders.com - Copyright © 2003 by PerlCoders Group
Privacy policy       Licensing policy       Site Usage Terms
Not a member yet?
Click Here
User:
Pass:
I forgot my password
  HomePage
Current News
Our Products
Our Services
FAQ & Docs
Support
Contact
Make Money!
Affiliate Login
 
Right now get access at a special rate of only $160 which includes more than 156 of our top quality CGI scripts and get deep discounts on many others. You also get full access to our members area which is slam packed with webmaster goodies.

  · Read more...


 
Get the latest News at
the Perlcoders group.

 
What our clients say
Tell us what you think
Projects in the works
Free scripts to members
Free self help ebooks
Free Tip of the Day
Free Support
Custom programming
Myth of Caesar
SEO Resources
Cellulean
Image Hosting
Google Forum
SEO Forum
Click here to join ArticleDistribution
Click to join Article Distribution