Read Me for BizDirectory Program
Read Me for BizDirectory Program
Read Me for BizDirectory Program

bizdirectory (main folder)

 !FrameSet-IndexPage
 admin
 coupon
 cgi-bin (program files)                 
 images                   
 userimages

 index.redir  
 license.html
 biz-dir.html             
 config.txt (reference only)
 page_bottom.html         
 page_top.html            
 read-me.html             
 sample_coupon.html             

!FrameSet-IndexPage (folder)
Use this for the frameset opening page. This will create a left column with the categories listed in alpha order. The right column opening page is alt-biz-dir-page_top.html, you will want to customize this page for your site.

 index.html (frameset)  
 alt-biz-dir-page_top.html (right frame opening page)

admin (folder)
index.html - (Administration Page)

images (folder)
All images associated with this program.

coupon (folder)
All coupons for listings.

userimages (folder)
All user images associated with each listing. Banner and Image.

cgi-bin/bizdirectory

 add-category.pl                 Use to edit or add categories                  
 biz-dir-admin.pl                Main administration program to edit listings      
 biz-dir-coupon.pl               Coupon Wizard
 biz-dir-coupon-edit.pl          Coupon editor for users and admin
 biz-dir-edit.pl                 User editor to edit listing
 biz-dir-free-signup.pl          Free Signup program (free listings)  
 biz-dir-index-list.pl           Creates a single list of categories  (used for the frameset)
 biz-dir-index.pl                Creates a 3 column list of categories        
 biz-dir-listing.pl              Administrator listing program  
 biz-dir-search.pl               Search Engine
 biz-dir-setup.pl                Configuration File  
 biz-dir-signup.pl               Signup program - emails the Admin the information
 biz-dir-signup2.pl              Signup that posts the information to the DB
 biz-dir-upload.pl               Image Upload 
 biz-dir-uploadlogin.pl          Image Upload Login
 biz-directory.pl                Main Directory Progarm
 biz-library.pl                  Library of sub-routines
 SendMail.pm                     Win32 mail program (SMTP Mail for Windows)

cgi-bin/bizdirectory/data

 category.list                   List of Categories
 data.txt                        Data file for program  

Follow the directory structure in the .zip file (except cgi-bin)
Upload all the files in the same structure to your server. Upload the program files (.pl .pm) to cgi-bin/bizdirectory .
Be sure to keep working copies of all program files as a backup. Sample data and user images are included with the program for testing.

1. Upload pathtest.pl to your cgi-bin - ASCII mode!!
2. With your Browser run pathtest.pl to determine the path to the cgi-bin
   Make a note of the path we'll use it when settting up the config file.
   
3. Make a folder called bizdirectory under your cgi-bin - /cgi-bin/bizdirectory
4. Make a folder called data under the /cgi-bin/bizdirectory/data
5. Chmod data to 777 (unix only)
6. Upload category.list and data.txt to the /cgi-bin/bizdirectory/data directory
7. Chmod category.list and data.txt to 666 (unix only)
8. Upload all the program files (.pl .pm) to your /cgi-bin/bizdirectory (ASCII mode)
   For unix chmod all program files to 755
   
   
9. Make a folder called bizdirectory under your parent folder (home directory)
10. Make a folder called coupons under the main folder bizdirectory
11. Chmod coupons to 777 (unix only)
12. Make a folder called images under the main folder bizdirectory
13. Make a folder called userimages under the main folder bizdirectory
14. Chmod userimages to 777 (unix only)
15. Make a folder called admin under the main folder bizdirectory

16. Configure all the variables and options in the biz-dir-setup.pl
    For help with configuration, an FAQ is available at: http://rlaj.com/scripts/faq/.

If you want to use the 3 column list for your opening page, use the index.redir. This file will redirect the user to the biz-dir-index.pl - the script will print the page_top.html, create a 3 column list of all categories, then print the page_bottom.html. If you are using this file, rename it to index.html and place it in your main directory (bizdirectory/index.html)


Controling the look of your pages.

The file page_top.html is used to control the look of all the screens the user sees. The program will open this file and use it for the top section for all cgi pages.

The page_bottom.html is used for the bottom of all program pages.

The colors for the directory pages is controled with the biz-dir-setup.pl the configuration file for all the cgi's. Edit the configuration carefully. I suggest you edit the file changing one thing at a time. This way if you get an error, you will know where it is.


Operation

Each time the program runs:
user clicks on a category link or selects from the dropdown list

1. the file page_top.html is opened and printed to the screen
2. the data for the category the user chose is printed to the screen (biz-directory.pl)
3. the page_bottom.html is opened and printed to the screen, completeing the page.