Index of /_Tests/asp/CodeGirl Classifieds v1.2

CodeGirl Classifieds Installation Instructions

*If you are upgrading from a previous version, you may copy and paste your configuration variables into the new classifieds.cgi file, upload it, and chmod 755. You will also need to upload index.txt as it has changed also. Always backup your scripts before making any changes. An easy way to do this is to rename your old script classifieds.cgi.BAK.cgi

Requirements

• A website with access to a CGI directory.
• Perl 5.003 or higher.
• A FTP uploading utility that allows you to select ASCII or binary mode. If you do not already have an FTP utility you might try WS-FTP or CuteFTP.

Creating Directories

• Make a directory on your server where the data will be stored. For security reasons it is best to make this folder in a directory that it isn't web accessable. If you do not have access to a directory that is not web accessable, you should use .htacess and .htpasswd files to protect the data from being seen by visitors (contact your web host for more information about password protection on your server). You should also upload an index.html file to this directory if it is web accessable. If you are on a Unix server, chmod the folder to 777. If you are using NT, give this folder full rights.
  
  
• Within the directory that you just created, make a directory named bannedmail. Chmod this directory to 777 (or give full rights on NT).



• Create a directory where uploaded images will be stored. Chmod this directory to 777 (or give full rights on NT). This directory does not have to be in your CGI directory and if your web host does not allow images in the CGI directory you will want to make this directory under your public html directory.

Configuring Script Variables

The first line of classifieds.cgi is the path to Perl. Change this to the path to Perl on your server. Be sure that this line starts with #!. Contact your web host if you do not know the path to Perl on your server.

In the configuration section of classifieds.cgi (below the copyright notice) you will need to set the following variables:

$config{'basepath'}

The path of the data directory you created. Be sure to include the trailing slash.

$config{'closedir'}

The name of the directory for storing expired ads. This will allow you to keeps ads for records and also allows users to repost their ads when they receive an ad expiration e-mail. There is no need to create this directory, the script will create it when run.

$config{'regdir'}

The name of the directory for storing users' registration files. There is no need to create this directory, the script will create it when run. You may also choose not to require registration by setting this variable to $config{'regdir'} = '';.

$config{'adminpass'}

The password for accessing the administrative functions. You should change this password immediately to a password of your choice.

$config{'mailprog'} or $config{'mailhost'}

These are your mail program and mail host variables. Choose only one of these variables and comment the other line out by placing a # at the beginning of the line. It is preferable to use a mail program and this is possible with nearly all web hosts. Contact your web host for the path to your mail program.

$config{'admin_address'}

The e-mail address where you would like to receive administrative mail such as new user registration and new ad listing notifications. It is also the address that will be listed on the e-mails that are sent to users.

$config{'scripturl'}

Your website address. This is not the address to your script. Do not include http:// or a trailing slash.

$config{'colortablehead'}

The color of the table heading.

$config{'colortablebody'}

The color of the table body.

$config{'colortableborder'}

The border color for tables.

$config{'sitename'}

The name of your site. If your site name includes a possessive with an apostrophe (i.e, Jim's), you should include a slash before the apostrophe (i.e, Jim\'s).

$config{'pagebreak'}

The number of titles to display on each ad listing page.

$config{'searchpagebreak'}

The number of titles to display on each search results page. This does not limit the number of search results, it simply limits the number of results shown on a page.

$config{'adlimit'}

The number of ads each user is allowed to post. This does not include expired ads.

$config{'flock'}

Allow file locking. This should be set to 1 unless you are receiving file locking errors.

$config{'newokay'}

Set to 1 to allow users to post ads.

$config{'imageuploaddir'}

The path to your directory where uploaded images will be stored..

$config{'imageuploadurl'}

Complete URL to your directory where uploaded images will be stored. Include http://

$config{'header'}

The HTML code that will be appended to the top of your script. Be sure to leave <<"EOF"; intact. Also be sure to include the HTML, HEAD, TITLE, and BODY tags as wells as the EOF at the end of your HTML. See the HTML Customization section for additional tips for customizing your script.

$config{'footer'}

The HTML code that will be appended to the bottom of your script. Be sure to leave <<"EOF"; intact. Also be sure to include the BODY and HTML tags as wells as the EOF at the end of your HTML. See the HTML Customization section for additional tips for customizing your script.

To configure the ad duration choices a user has, search for <select name=DAYS size="1"> in the script. After this you will see the options for ad duration. You may change these to any amount of time you like. The values are equal to the amount of days (1 week = 7 days).

If you would like to allow users to place an ad for longer than one year you will also need to search for 366 in the script and change this number to 1 above the number of days you would like to allow the user to place the ad. For example, if you would like users to be able to place an ad for 2 years you would change this number to 731 (365 days * 2 + 1).

Open upload.cgi and change the first line to reflect your server's path to perl.

In the configuration section of upload.cgi you will need to set the following variables: