Setting Program Options


Notes:
All the color choices on this page can be overridden by using the style sheet in the page_top.html page.

DO NOT use parentheses () in any of the text areas. This will cause a server error.

In the Terms and Conditions text, if you use any single quotes you will need to escape the quote ( \' ) with a backslash, or you will get a javascript error on the listing forms.

If you want to use the PayPal IPN system for automatic user upgrades to paid, this is the address you use at your PayPal account options.
http://server/cgi-bin/bizdir/pp-ipn.pl

Place this link in your page top to use the style sheet.
<link rel="stylesheet" href="http://server/bizdir/lib/bizdir-style.css" type="text/css" />

Getting Started
I suggest you open 2 browsers. With 1 browser, set the options for your application, (this page).
With the 2nd browser have it on the main page of the program.
http://server/cgi-bin/bizdir/bizdir.pl As you make changes in this program and save the changes, then reload the main page to see the changes.


1st. Choose the type of layout you want to use for the program.

2nd. Set your page colors, go to the Left Column first. Even if you are not using the left column, set your colors first from there.
From there you can set all the page colors for all the tables the same time.

3rd. Then go to the Page Colors to complete the choices for the pages.
AND
If you are using the program as a Business Directory, Set the listing colors Here.

4th. Then edit the Page Top for your site.
You can also design your own Page Top, it is located in the main /bizdir folder page_top.html and page_bottom.html

The Color Picker for IE has 16 million colors, for FireFox or Netscape, the colors are limited to 256.

You can also opt to use the style sheet.
All of the page colors and fonts can be overridden by using the style sheet in your page top.     The style sheet is in the /lib folder and is called bizdir-style.css

Place this link in your page top to use the style sheet.
<link rel="stylesheet" href="http://server/bizdir/lib/bizdir-style.css" type="text/css" />

do not show this help again.

You can login to the user editor with your admin password. The easiest way is to go to the listing details page, click on 'edit this ad' and login with your admin password. This puts the program in ADMIN MODE and you can do anything from there.




You can not use parentheses ( ) in any area below.
 
Set Program Type.
Business Directory   Classified format


 
Enter the title for the program.
EXAMPLE: RLAJ.COM Business Directory


 
Enter a default description for the META Description tag.
EXAMPLE: Everything from Antiques and Collectables to Web Site Design


Currency
Currency
Currency Symbol


Registration
Do you want to require Registration to place ads  ? Yes   No                


Registration Required Fields   ?
First Name Yes   No                              
Last Name Yes   No
Address Yes   No
City Yes   No
State Yes   No
Post Code Yes   No
Country Yes   No
Phone Yes   No


Extra fields - not required to be filled in by user.

# For a text field, just enter the name for the field that will show on the reg. page.
# EXAMPLE -> What is your age? 
# If you want to use an option list for an extra field
# use a semi-colon between the names in the lable
# EXAMPLE -> field1 = How did you hear about us;Yahoo;Alta Vista;Go.Com; 
# EXAMPLE -> field1 = DD-LIST-LABLE;OPTION1;OPTION2;OPTION3:ETC;
Field1
Field2
Field3
Field4
Field5
 
Enter any text that you want in the email that is sent to the user when they register.
 
Subscribe to News Letter option Yes   No
News Letter Text
 
Enter any text that you want on the final page after the user registers. HTML Ok.
 




Terms and Conditions
# If you want the user to have to check the Terms and Conditions checkbox
# before they can place an ad, check the YES box below.
Require Terms Yes   No
 
Enter your terms and conditions in the box below. HTML Ok.
 




Listing Types
# Select the type of ads that you want to offer to your users
# 1. Text only ads
# 2. Photo only ads
# 3. Text ads and Photo ads
# (you can bill extra for photo ads, see paid ads below)
Select Listing Type/s Text Only   Photo Ads Only   Both Photo and Text ads
 




Free Ads
# Set the number of days that a FREE ad will run before it 
# is automatically removed by the system - the number of days
Free ads expire in Days.
 

# For the FREE posting program, set the fields that
# you want to be required to be filled in by the user.
Email Address Yes   No
Name Yes   No
Address Yes   No
City Yes   No
State Yes   No
Post Code Yes   No
Phone Yes   No
Web Site Yes   No
 
Do FREE Ads have the ability to place an image in their ad?
Free Image Ads Yes   No
 
Do you want to check for bad words to keep porn sites from posting?
Warning: this is buggy and may cause an occasional problem
with some listings.
Only use it if you are having trouble with porn sites.
Check for bad words? Yes   No
 
# USER BLOCKING - APPLIES TO FREE ads ONLY
# If you want to use the "email blocking" feature, set the variable
# below to 'yes'   This will stop a user with a certain email address
# from "spaming" your businessdir.
Use Email Blocking Yes   No
 
# If you want to use the "IP blocking" feature, set the variable
# below to 'yes'   This will stop a user, from a certain IP
#  Address, from "spaming" your businessdir.
Use IP Blocking Yes   No
 
# If you do not want postings from robots, set the variable
# below to 'No'   This will stop spam from the automated programs that
# post to businessdir.
Remote Access Yes   No
 
# Enter the number of free listings that a user is allowed to post. 
# This is required, if you want it unlimited, set to 1000.
# Free Ads Allowed
 
# Enter the free link color on category page.
# 0000FF is blue
# Free link Color
 
Enter any text that you would like to include in the email sent to user.
 
Enter any text that you would like at the top of the free listing page. HTML Ok.
 
 
Enter any text that you would like in the left column of the free listing page. HTML Ok.
 
 
Enter any text that you want the user to see if they exced the number of free ads allowed.
NO HTML, this will also get emailed to the user
 
 
# If you you want to allow your free listings to sell an item
# directly form their ad using Pay Pal, set the pay pal option
# below to YES
Pay Pal Option? Yes   No




Paid Ads
Paid Ad == Featured Ad
# Set the Ad durations that you want available for Paid Ads.
# Enter the NUMBER OF DAYS with a comma between durations
# ie - '60,120,180,360';
Ad Durations
 
# Enter the DOLLAR AMOUNTS for each of the above paid durations.
# This MUST correspond with the durations defined above.
# ie - '2.95,4.95,7.95,9.95';
Paid Charges
 
# If you are using Image Ads, enter the price of placing
# an image on the page for each of the above paid durations.
# If the AdType is set to "Photo Only", or "Text Only"
# Image_charges below is not used.

# The Image_charges MUST correspond with the durations defined above.
# ie - '2.00,4.00,7.00,9.00';
Image Charges
 
# Enter the DOLLAR AMOUNTS for Renewals.
# This MUST correspond with the durations defined above.
# ie - '2.95,4.95,7.95,9.95';
Renewal Charges
 
If you want to use the PayPal IPN system for automatic user upgrades 
to paid, this is the address you use at your PayPal account options.
http://server/cgi-bin/bizdir/pp-ipn.pl
See Your PayPal account for help with the IPN.
Your PayPal Email Address
Your PayPal Logo
PayPal return programhttp://server/cgi-bin/bizdir/paypal-return.pl
PayPal refused
 
Enter any text you would like on the top of the Pay Pal page.
You can use HTML tags if you like.
 
# For the PAID posting program, set the fields that
# you want to be required to be filled in by the user.
Email Address Yes   No
Name Yes   No
Address Yes   No
City Yes   No
State Yes   No
Post Code Yes   No
Phone Yes   No
Web Site Yes   No
 
# Do you want the paid ads always at the top of the category page?
Paid ads on top? Yes   No
 
Link Color for Paid ads   Use Hex, 0000FF is Blue
(Not used for Business Directory)
 
Enter any text that you would like to include in the email sent to user.
 
# If you are using both Free ads and Paid ads, 
# do you want an "upgrade your listing" link on the ad page?
# This allows users that have a free listing to upgrade to a 
# paid listing.
Upgrade your listing link? Yes   No
 
 
# If you you want to allow your users to sell an item
# directly form their ad using Pay Pal, set the pay pal option
# below to YES
Pay Pal Option? Yes   No
 




Email Reminders
# If you are sending email reminders to alert users that their ad is about
# to expire, enter the number of days that you want to start sending
# reminders before their ad expires.  Example '7' would
# start sending reminders 7 days before the ad expires.
# You can run this on a 'cron' or scheduled task.
# d:/aweb/cgi-bin/bizdir/cron-reminders.pl
Reminder Start days before ad expires.
 
Enter any text you would like in the reminder email
NO HTML tags.
 




Sudo Banner Rotation
# This option will print a table with a background image
# near the top of the category page. This is used to rotate Paid Ads in a 
# banner type look. These are actually text links, the Title of the 
# Paid ad is clickable to that ads details page.
# The banners are rotated by category, if no banner is found in
# the category selected, one will be printed at random from the paid ads.
# You can also rotate your own links, see below.
# Sample Banner
Use Sudo Banner Yes   No
# Enter the height and width of the table
Height Width 
# Enter the color for the text in the banner.
# Make sure this is a contrasting color for your background
Text Color 
# Enter the name of the background image to use as table background
# place this image in the /images folder. The image must be the same
# height and width you entered above.
# For more than one image, use a semi-colon between image names. 
# This will print the images at random.
# EXAMPLE
# image1.gif;image2.gif;image3.gif
Background Image Name 
# If you want the banner on the search results page
# set the variable below to 'Yes'
Show on Search Results Yes   No
# If you want the banner on the details page
# set the variable below to 'Yes'
Show on Details Page Yes   No
# Rotate your own "banner" by entering the text and link below.
Your Banner Text
Web Address 
# You can rotate as many links as you want with associated
# URL's. Enter each text you want to rotate with a semi-colon between 
# the text and links.
# EXAMPLE
# Your ad Here;Visit Ranson's Scripts;New EzSite Site Replication Program
# http://www.rlaj.com/yourad.html;http://rlaj.com/scripts

# You can also use the space where the banner appears
# to put any HTML you like there. This can be images, banner ads, 
# anything you would want to put there. The banner is replaced
# with the HTML code from the banner_space_html.html file.
# The banner_space_html.html file is located in the /logs folder.
# This will override the banner rotation
Alt use of banner space Yes   No
# Enter the HTML you would like to
# use in place of the banner.
HTML Code




Using Sub Categories

# If you want to use Sub Categories, check the yes box.
Use Sub Category Yes   No


Using Left Column

# If you use the left column, 
# the Categories and Sub-Categories will appear in the left column.
Use Category page Left Column Yes   No
 

# If you use the left column, 
# You can have the categories ALWAYS on the left.
Categories ALWAYS in the left column? Yes   No
 
Categories on the Details Page? Yes   No
 
# If you have a lot of categories, this will put
# just the active categories at the top of the left column.
# After there are more than 15 active categories, the categories
# print as normal.
Put Active Categories at the top Yes   No
 
Text for All categories
 

Left Column
Link and Background Color

    Category Link
    Inactive Link
    example table     
# Set the color options for the Left Column
Left Column Width
Left Column Color View Changes
Category link Color
Inactive link Color
Table Text Color
 
  To set all the page colors to your choice for the Left Column color Click Here
  This includes the Right Column and all Table Headers.
  To set the rest of the color options, Click Here 

# You can add HTML to the left column.
# THIS APPEARS ABOVE THE CATEGORY LISTINGS
# Just paste the text (HTML) in the box below that you
# want to appear before the Sub Categories.
# This can be images or text or both.
Left Column HTML 

# You can add HTML to the left column.
# THIS APPEARS BELOW THE CATEGORY LISTINGS
# Just paste the text (HTML) in the box below that you
# want to appear after the Sub Categories.
# This can be images or text or both.
Left Column HTML





Using Right Column

Use Category page Right Column Yes   No
 
Use Details page Right Column Yes   No
 
Shows Featured Listings in a right column on category page.
Uses the thumbnail images and title of the item.
Show Featured in Right Column Yes   No
Set the # of Featured Listings to show in right column  
 
# If you use the right column, the Featured Listings 
# will appear at the top of the right column.


# Set the color and size options for the Right Column
Right Column Width
Right Column Color
Right Column Text Color
           Set Right Column Color Same as Left Column
 

# You can add HTML to the right column.
# THIS APPEARS ABOVE THE FEATURED LISTINGS
# Just paste the text (HTML) in the box below that you
# want to appear before the featured listings.
# This can be images or text or both.
Right Column HTML 

# You can add HTML to the right column.
# THIS APPEARS BELOW THE FEATURED LISTINGS
# Just paste the text (HTML) in the box below that you
# want to appear after the featured listings.
# This can be images or text or both.
Right Column HTML




Page Colors and Look


All of the page colors and fonts can be overridden by using
the style sheet in your page top. 
The style sheet is in the /lib folder and is called
bizdir-style.css

Place this link in your page top to use the style sheet.

<link rel="stylesheet" href="http://server/bizdir/lib/bizdir-style.css" type="text/css" />


Background color for all program tables

# Enter the color for the table backgrounds.
# This is the color of the table backgrounds throughout
# the bizdir program. 
# Title background of the Ad Details page, register page, 
# password help, admin, etc..
# If you do not want a background color on the tables, set the
# TableBg color to your background color.
Table Background Color View Changes
 

# Enter a color for the text that appears against the table
# background. This should be a contrasting color to the
# table BG color defined above.
Table text Color View Changes
 

Category Page Title Bar   (does not apply if using templates)
There are 32 listings in Antiques Showing 1 to 25
ImageTitle (Bar) Featured

# Enter a color for the Title Bar on the category page
# Note: Does not apply if using templates
Title Bar Color View Changes

# Enter a color for the Sub Title Bar on the category page
# Note: Does not apply if using templates
Sub Title Bar Color View Changes

# Enter a color for the Sub Title Bar on the category page
# Note: Does not apply if using templates
Title Bar Text Color View Changes

# Enter the width of the main table for the businessdir pages
# This is a percentage of the available width of the screen.
Table Width 

# On the category page the listing backgrounds
# alternate background colors. You can define the colors below
# that you want to alternate. (not used in Business Dir)
Listing Background Color 1
Listing Background Color 2 

# If you want to use a horizontal rule between
# listings, set to YES below.
Use HR Between Listings Yes   No 

# If you want to show the program run time at the 
# bottom of the screens check the YES box.
Show Run time Yes   No




Using Your Own Templates

If you do not know what the templates are
use the default (no) for now.
Templates and help files are in the /templates folder.

# If you want to use your own template for the
# category page, check the yes box.
# requires 2 templates
# Template Help File
Use Category Templates Yes   No 

# If you want to use your own template for the
# ad details page, check the yes box.
# Details Page Help File
Use Details Template Yes   No 

# Category Template Wizard
# Important: Set all the options on this page and
# save the options before you use the wizard.

# If you are using your own templates, you can use up 
# to 5 additional text fields for your ad listing programs.
# Enter the field "lable" in the boxes below. The "lable"
# is what shows on the page, like - Additional Field 1 below.
Additional Field 1 <!spair1>
Additional Field 2 <!spair2>
Additional Field 3 <!spair3>
Additional Field 4 <!spair4>
Additional Field 5 <!spair5>
 




Coupon Images

# If you want to users to to be able to use coupons,
# check yes below and set the width for the coupon 
# image. In pixels
Use Coupon Yes   No
Free Listing Coupon Yes   No
 
Max Image Width 
# Enter the maxium image size for coupon images. This should
# be rather small in order to keep users from uploading
# images that are physically too large. 
# Enter size in bytes -> 50000 = 50K
Coupon Image Size




Thumbnail Images

# If you want to use thumbmnail images on the 
# category page, check yes below and set the width for the thumbnail 
# image. In pixels
Use Thumbnail Yes   No
Max Image Width   Height: 
# Enter the maxium image size for thumbnail images. This should
# be rather small in order to keep users from uploading
# images that are physically too large. 
# Enter size in bytes -> 4000 = 4K
Thumb Image Size

Using the GD Library 
# This version is capable of using the GD 
# library for automatically generating the thumbnail images.  
# GD for Perl must be installed on your server.
#
# If the GD library for Perl is not installed on the server,  
# You can ask your server admin to install the program for you 
# on the server. This is a very easy process that should only take
# a few minutes. GD Test
Use GD Thumbnail Yes   No
 
Image Quality 
# If you are using the GD module to create the thumbnail,
# set the type of image you want to use for the output. for
# an image that is 150 px by 150 px, the PNG output is about 35K
# The same image as a JPG @ 75% quality is about 5K
# All specs below are for an image 150 x 150 px.
Use PNG output File Size about 35K (Best Quality)
Use JPG output Quality:
 
 
Mini Banners 
# If you are using GD, then you can use the option of having the program
# create Mini Banners 'on the fly' for PAID ADS ONLY. View Sample
# Use the mini banner on your home page or any page where you would
# like to feature your ads.
# Usage: <A HREF="http://server/cgi-bin/bizdir/rotate3.pl?url">
<IMG SRC="http://server/cgi-bin/bizdir/rotate3.pl?img"></A>
Use Mini Banner Yes   No
 
Mini Banner Width 125 is the default width
Mini Banner Height 125 is the default height
 
# Default text to use in mini banner if the user does not enter text
# for their banner.
Default Text Line 1
Default Text Line 2




Misc Options

# Search Options
# Check the search options you want to use
Search Options City State Country 

# If you want to use thumbmnail images on the 
# category page, you may want to NOT show the Ad number.
# Not applicable if you are using the category template.
Show Ad Number Yes   No

# If you want to show the Date Posted on the 
# category page, set to yes below.
Show Posted Date Yes   No

# You can only use the short desc. with the thumbnail image option.
# Enter the limit you want to put on the length of the
# Short Description. The # of characters.
Use Short Desc Yes   No
Short Desc Limit 

# Set the optional fields that you want available
# on the Ad listing forms.
Use Price Field Yes   No
Use Condition Field Yes   No

## ** If you would like the program to delete the Ads after #? days 
## When there is a new entry, the program will remove all ads in
## that category that are expired.
Use Auto delete Yes   No

Do you want to show the search box above the listings?
Display Search Yes   No

Do you want to allow HTML in the users description?
Allow HTML Yes   No

# If you want to use the category link  
# that appears on all the screens.
# This is the java PopUp window for categories.
# home >> categories >> 'page_were_on'
Display Cat link Yes   No


# There are 2 options for the pop-up category list
# 1 - the list prints all of the categories 
# With both lists, only categories that have 
# entries will have active links.
# 2 - the list only prints the list of categories
# that have entries.
Category Type Print All   Print only actives

# If you want to use the counter option  
# on the ad details page, check Yes below
Display Counter Yes   No

# Enter the maxium number of entries for each category (required)
# If you want it unlimited, set to 1000000.
Maxium # of entries 

# Enter the number of Ads to display per page
# on the category list screen.
Maxium # items per page 

# Enter the limit you want to put on the length of the description 
# for the entry. The # of characters.
Description Limit 

# Enter the limit you want to put on the length of the title 
# for the entry. The # of characters.
Title Limit 

# Enter the maxium image width for the images on the Ad
# details page. (200 is a good width for the page)
Max Image Width 

# Enter the maxium image size for user images. This should
# be rather small in order to keep users from uploading
# images that are physically too large. 
# Enter size in bytes -> 10000 = 10K
Max Image Size



XML Feed
 
XML Description Limit : If you want the complete text, enter ALL
Number Entries in XML Feed :
XML Feed Type Paid Listings Only   All Listings
 
# Time Offset for XML Feed
# Eastern  -500
# Central  -600
# Mountain -700
# Pacific  -800
Time Offset :
 
XML Feed - Description:
 




Business Directory Specific Variables
Use Program as Business Directory  ?          Yes   No
If you use this format, you must use the Category Templates.
The templates for this option must be built by hand and cannot be generated
with the wizard.
Set to 'no' for classic look. (classifieds)
Set the listing colors below.
 
Allow a "bi line" under the title  ?            Yes   No
Max length for Bi Line  ?                
Help description for Bi Line  ?
 
Enter the Web Address to the map provider  ?Default: http://maps.yahoo.com/py/maps.py


Business Directory Format - Sample Listing

Title for the listing
This is the bi line for the listing, it should be about 60 charactors
This is the short description. The length of the short description is set on the administration options page. This can be any length you want, but should be kept relitively short. This is the short description. The length of the short description is set on the administration options page. This can be any length you want, but should be kept relitively short.
Contact Us  More Info
Ranson's Scripts  PO Box 98 Liberty TN 37095  615.536.5467  

Set Listing Colors (Business Directory Format Only)

Table Outline Color:View Changes
Title Background Color: 
Title Font Color: 
BiLine Background Color: 
BiLine Font Color: 
Short Description Color: 
Contact Info Background Color: 
Contact Text Color: 






Page Top Variables
If you want to keep the standard Page Top format,
Edit the variables below for your site.
Use link to Registration Yes   No
 
Use link to Paid Ad Program Yes   No
Type of List Radio Button   Select List 
The Type of List also controls the upgrade link.
 
The first text is on the left of the page top (logo - company name)
1st Line Left Text
2nd Line Left Text
 
The Center text is anything you want to say about your directory. Up to 4 lines.
Use up to 50 to 60 charactors per line.
1st Line Center Text
2nd Line Center Text
3rd Line Center Text
4th Line Center Text
Ranson's Scripts
  Example Text		Sample Text
For Page Top
Link1   Link2   Link3  
Header Background Color:View Changes
Header Font Color: 
Link bar Color: 
Link Color: 






Select Layout - Using Layout 5
These are built in layouts for your convience. There are literly 100's of possible layouts depending on the options you set on this page. Start with a layout you like, and then save the layout. Then edit the options again to set your colors, etc.
Using Layout 5
Business Dir. Layout 1
Business Dir. Layout 2
Layout 3
Layout 4
Layout 5
Layout 6
Layout 7














# NOTES:  

DO NOT use parentheses () in any of the text areas. This will cause
a server error.

In the Terms and Conditions text, if you use any single quotes
you will need to escape the quote  ( \' )  or ou will get
a javascript error on the listing forms.