####################################
# PROFILE MANAGER 1.13 
# 
# Aytekin Tank
# email: aytekin@interlogy.com
# http://www.interlogy.com/scripts/pm
# 
#-------------------------------------
# COPYRIGHT NOTICE:
#
# Copyright 1999-2001 Aytekin Tank.
#
# This program may be used and modified free of charge by anyone, so
# long as this copyright notice and the header above remain intact.
# Selling the code for this program without prior written consent is
# expressly forbidden. Obtain permission before redistributing this
# program over the Internet or in any other medium.  In all cases
# copyright and header must remain intact.
#
# This program is distributed "as is" and without warranty of any
# kind, either express or implied. All responsibility is belong to 
# you if any damage or loss occurs.
#
# To use this script, you must have basic CGI installation and HTML skills. 
# 
####################################
 
####################################
# Installation:
####################################


1) Make sure the first line of "pm.cgi" is pointing to a perl interpreter. 
   ('whereis perl' will answer this question on telnet. It is probably "/bin/perl" or "/usr/bin/perl") 

2) If you are an Windows NT user, place the root of the script into the second line of "pm.cgi":
   $root =  "/place/of/the/public/directory/pm/";

3) Create a folder in your public directory and call it something like "pm".

3) Upload all of the files to the directory(pm). 
   Make sure your FTP client uploads cgi, cfg and lib files in ASCII mode.

4) Change permissions for these:
   chmod a+rw(766) data (make data folder readable and writable)
   chmod a+rx(755) pm.cgi (make the script readable and executable)

5) Should work! Go to register.htm and test everything. 



####################################
# Oops! I've got a problem:
####################################
Go to the bottom of this page: Troubleshooting


####################################
# Customization:
####################################
6) Open and customize the "pm.cfg" with a text editor
   Modify templates under "templates" folder. 
   If you change database fields, modify registration/modification templates.

7) For easier manipulation of the templates, you can install "HOW?". 
   It is a web based HTML editor, and comes with the script. Check under "templates" folder.

8) Back-up your database file "pm.dat" periodically.

9) Password protect your data file as showed below.

10) Read this article. I have written it for Premium customers, 
but it might be helpful for the Free version too:

Setting Up Your Own Database
http://www.interlogy.com/scripts/pmpre/setting-up-database/




####################################
# Links:
####################################
Send your feedback here:
http://www.interlogy.com/scripts/feedback

Purchase installation and/or support for only $45 here:
http://www.interlogy.com/scripts/pm/payment.shtml

Check this page for most updated FAQ:
http://www.interlogy.com/scripts/pm/faq.shtml

For more features, see the other versions:
Premium version: 	http://www.interlogy.com/scripts/pmpre/
Professional version: 	http://www.interlogy.com/scripts/pmpro/


####################################
# Troubleshooting:
####################################

* It says "internal server error"?
  - You might have made a syntax error in "pm.cfg". Like forgetting a quote.
  - Make sure your FTP client uploads .CFG, .CGI and .LIB format files in ASCII mode.
  - Re-installing the script might the fastest way to solve this 
  kind of problem, if you don't have any perl/cgi debugging skills. 
  - Make sure the first line of the "pm.cgi" is pointing to a perl5 in your server 
  (ask your ISP or use command "whereis perl5" in your telnet screen).

* Got a blank screen or error 404? 
  This is the most popular error, so don't panic. It is not a syntax error or 
  compile time error but a runtime(or interpreter time) error:
  - Make sure your FTP client uploads .CFG, .CGI and .LIB format files in ASCII mode.
  - You might not really pointing to the place of the template files.
  - Something wrong with the template file. Either a location mislink form "pm.cfg" 
  or the template does not exist.
  - If you are on NT server, place 
  $root = "/place/of/the/script/"; 
  in the second line of "pm.cgi"
  - Check the directory information, most probably you are pointing to wrong place.

* Got a text "No such file or directoryNo such file or directory"? 
  If this is your first test after installation of the script, this is OK. This
  shows that it could not found the data file and trying to create a new one.
  If you get this message everytime that means it cannot create the database, you
  are probably pointing to wrong place for data file or you simply did not make 
  writable the data folder.

  Another problem might be a missing table tag in the profile if you are using a 
  netscape browser. To detect this use an explorer browser for the same page. I have fixed 
  all of errors in template, please report if you see any.


---------------------------------------------------------------------------
From: lparis<info@eminencedesign.com>

I would like to suggest the following faq/instruction additions, 
as my server seems to be the 'weird child', 
but ive seen this weird child before when dealing with client sites.
to the user:
1- you will have to create data and staticfolder directories and chmod them appropriately
2- your server may not auto-write files so you may have to create a 
blank text file named pm.dat and upload it to your data directory.
3- if a pm.dat file was created manually be sure to chmod it to make it writeable. 
4- if the provided directory structure remains intact, 
you will need to add this: '../' at the beginning of your file names in 
the file titled temp_list.txt .
5- in pm.cfg you will have to specify your base path. if it contains a '@' symbol 
be sure to place a '\' before the @.
---------------------------------------------------------------------------





Thank you for using Profile Manager.
