
################################################################################
#                  PopupEX Installation Instructions                           #
################################################################################
#                                                                              #
#               ############################################                   #
#               ##                                        ##                   #
#               ##               PopupEX                  ##                   #
#               ##             by MHF Media               ##                   #
#               ##    (e-mail webmaster@mhfmedia.com)     ##                   #
#               ##                                        ##                   #
#               ##             version:  1.0              ##                   #
#               ##           Windows NT & UNIX            ##                   #
#               ##      last modified:  11/15/2002        ##                   #
#               ##          copyright (c) 2002            ##                   #
#               ##                                        ##                   #
#               ##    latest version is available from    ##                   #
#               ##              MHF Media                 ##                   #
#               ##      http://www.mhfmedia.com           ##                   #
#               ##                                        ##                   #
#               ############################################                   #
#                                                                              #
################################################################################


             This script is designed for both NT & Unix Based Server!!!  

    PopupEX is a full featured automatic 120x60 banner exchange system that will popup a window 
on each members site displaying another members banner.  Increase traffic to your site tremendously 
just by running the exchange...  The script runs on a credit system that will keep statistics for 
each of your members to view.


You will need to know the exact path to your website and a writeable directory in your website.
   Example For NT:
    Writeable directory Example: c:/webs/eh393/html/cgi-bin/database/popupex
    This is assuming that the directory "database" has write permissions...
     You cant CHMOD in NT to give it write permission so you will have to ask your server admin
     which directory you can have scripts write to.  They usually put a directory in the cgi-bin
     called database or something like that... Then you can add directories under it and the will
     automatically have the same permissions...
       If you do not know what directory you can write to, just ask your server administrator...  
   Example For UNIX:
    Writeable directory Example: /home/r/a/rasnider/html/cgi-bin/popupex/files
    Unix is a little different than NT... You can create your directory then just CHMOD on that 
    directory to 777 to give it write permissions... So in this case, you will create the
    directory called files under the popupex directory and then CHMOD to 777


you will need to know the exact path to the servers mail program.  "Blat" for NT or "Sendmail"
for Unix.
   Example NT: c:/tools/blat/blat.exe
   Example Unix: /usr/sbin/sendmail

If you do not know these ask your servers administrator...

  I have included a script that will give you some help getting the paths to your server, perl, sendmail
  and other environments... This script will just get the Environments and print them out for you so if 
  you are unsure of what the full path to something is, you can run this script and it will tell you...
    Unix: upload the getenv.pl file to your cgi-bin and then CHMOD to 755..  Then just go the the url of
          the script...  http://www.yoursite.com/cgi-bin/getenv.pl
    NT: upload the getenv.pl file to your cgi-bin and then just go the the url of the script...
           http://www.yoursite.com/cgi-bin/getenv.pl  



Step 1:
UNIX:
  Create a folder under the cgi-bin called "popupex".
  This is where your going to upload all the .pl files to.
    CHMOD to 755 on the directory..
    
NT:
  Create a folder under the cgi-bin called "popupex".
  This is where your going to upload all the .pl files to.
    You cant CHMOD in NT so dont worry about changing permissions...


Step 2:
UNIX:
  Create a writeable directory called "files" under the popupex directory you created in step 1...
    CHMOD to 777 
     So the path to this is now "your/root/html/cgi-bin/popupex/files"
  This is where all the records will be kept.. The script will automatically write the files so it
  must be a writeable directory. 

NT:
  You will need to know what directory has write permissions on your server... If you dont know,
  ask you server administrator...  They usually make one directory with write permissions for you
  when they set up your cgi access so look for a directory that might be something like "database"
  or something.  Lets say you have a directory called "database" and the path
  is c:/websauto/eh393/html/cgi-bin/database...  Create a folder under that called "files".. It 
  will automatically have the same permissions as the database directory...
    *** Note, sometimes they make this a non-web directory... c:/websauto/eh393/database... The
        database directory is before the html directory making it a non-web directory...


Step 3:
  I have included a script that will give you some help getting the paths to your server, perl, sendmail
  and other environments... This script will just get the Environments and print them out for you so if 
  you are unsure of what the full path to something is, you can run this script and it will tell you...
    Unix: upload the getenv.pl file to your cgi-bin and then CHMOD to 755..  Then just go the the url of
          the script...  http://www.yoursite.com/cgi-bin/getenv.pl
    NT: upload the getenv.pl file to your cgi-bin and then just go the the url of the script...
           http://www.yoursite.com/cgi-bin/getenv.pl

UNIX:
 Configure the settings.pl
 Open the settings.pl file with something like notepad or wordpad...
  Change all the lines that start with a $variables...
 Open the other admin.pl, ads_members.pl and the ads.pl files and change the first line to the path 
 to perl for your server..
  Example #!/usr/bin/perl

NT:
 Configure the settings.pl
 Open the settings.pl file with something like notepad or wordpad...
  Change all the lines that start with a $variables...


Step 4:
UNIX:
 Upload all the files to the directory you created in step 1.
 CHMOD on all the .pl files to 755

NT:
 Upload all the files to the directory you created in step 1.


Step 5:
Add the links for your signup and login for your members to your existing webpage...
   The link will point to the ads_members.pl file.
      http://www.yourwebsite.com/cgi-bin/popupex/ads_members.pl

Thats it... Your Done...

You can access the Admin area by going to the admin.pl file.
   http://www.yourwebsite.com/cgi-bin/popupex/admin.pl


#######################################################################################

You can customize your sign-up and logins by inserting the forms below into your existing html pages...

If you want to have a custom login in your html pages here is the code for it... Change the url of the "POST" 
to your websites ads_members.pl file... If not just link them to the ads_members.pl...

          <form method="POST" action="http://www.yourwebsite.com/cgi-bin/popupex/ads_members.pl">
            <input type="hidden" name="action" value="login"><p align="center">
            <b><font size="1" face="Arial">Login: <br>
            </font>
            </b><font color="#FF0000">
            <input type="text" name="member_name" size="10"></font><br>
            <b><font size="1" face="Arial">Password:
            </font><font size="1" color="#FF0000" face="Arial"><br>
            </font></b><font size="2" color="#FF0000">
            <input type="password" name="member_pass" size="10"></font></p>
            <p align="center"><input type="submit" value="Login" name="B1"></p>
          </form>


If you want to have a custom sign-up in your html pages here is the code for the form you need in the page... 
Change the url of the "POST" to your websites ads_members.pl file... If not just link them to the ads_members.pl...
You must have all of the form fields in your page or else the account will not be created...  If you dont want a
custom sign-up page just point a link to the ads_members.pl file...

          <form method="POST" action="http://www.yoursite.com/cgi-bin/popupex/ads_members.pl">
            <input TYPE="hidden" NAME="action" VALUE="add"><div align="center">
                  <center>
                  <table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="41%" id="AutoNumber29">
                    <tr>
                      <td width="46%">&nbsp;</td>
                      <td width="60%" align="center">
                      &nbsp;</td>
                    </tr>
                    <tr>
                      <td width="46%">Account Name:</td>
                      <td width="60%" align="center">
                      <input type="text" name="account_name" size="20"></td>
                    </tr>
                    <tr>
                      <td width="46%">Password:</td>
                      <td width="60%" align="center">
                      <input type="password" name="account_pass" size="20"></td>
                    </tr>
                    <tr>
                      <td width="46%">Confirm Password:</td>
                      <td width="60%" align="center">
                      <input type="password" name="account_cpass" size="20"></td>
                    </tr>
                    <tr>
                      <td width="46%">Email Address:</td>
                      <td width="60%" align="center">
                      <input type="text" name="account_email" size="20"></td>
                    </tr>
                    <tr>
                      <td width="46%">Website URL:</td>
                      <td width="60%" align="center">
                      <input type="text" name="account_url" size="20" value="http://"></td>
                    </tr>
                    <tr>
                      <td width="46%">Banner URL:</td>
                      <td width="60%" align="center">
                      <input type="text" name="account_banner" size="20" value="http://"></td>
                    </tr>
                    <tr>
                      <td width="46%">&nbsp;</td>
                      <td width="60%" align="center">
                      &nbsp;</td>
                    </tr>
                  </table>
                  </center>
                </div>
                <p align="center">
                <input type="submit" value="Create Account" name="B1"></p>
        </form>

#######################################################################################

                                  MHF Media
                                 Chris Bruce
                            http://www.mhfmedia.com
                            webmaster@mhfmedia.com






