DevCoder Search Directory version 2.01 release 2004/09/04
-------------------------------------------------------------------------------

DevCoder Web Application Development

www.devcoder.com

- Web Application Development
- CGI Script Development
- Linux / Unix Consulting
- Search Engine Optimization
- Script Installation Services

We have the experience and expertise to help with all your unix needs.

-------------------------------------------------------------------------------
Contents:
-------------------------------------------------------------------------------

1) Description and Notes
2) Perl Module Dependencies
3) Installation Instruction
4) FAQ
5) Bugs

-------------------------------------------------------------------------------
1) Description and Notes
-------------------------------------------------------------------------------

        This Search Directory script has been made free of charge to all
interested in using its power. This is considered Free Software and you may use
or modify at your at your own risk.

        DevCoder has developed a Search Directory that is capable of building
a Yahoo / Dmoz style Directory and use powerful boolean search functionality
to find the most relevant results in the directory.

-------------------------------------------------------------------------------
2) Dependencies:
-------------------------------------------------------------------------------

- MySQL 4.01 or newer
        this version of mysql is now pretty common but if you need to find the
        latest version please check.
        http://www.mysql.org/

- Template-Toolkit www.template-toolkit.org
        Download: http://www.template-toolkit.org/download.html

- CGI.pm
        Should already be installed in your perl distribution. If not check
        http://www.cpan.org/

- DBI.pm / DBD::Mysql
        Need to install Perl Mysql Connection Modules
        http://www.mysql.org

- URI::Escape
        Should already be installed in you perl distribution. If not check
        http://www.cpan.org/

-------------------------------------------------------------------------------
3) Installation Instructions
-------------------------------------------------------------------------------

1       Uncompress devdir tarball or zip file into directory.

2       if you are using a suexec or user execute enviroment on a server make
        sure the user has ownership of the directory and all files by using 
        command such as "chown -R devdir:devdir directory"

3       if you are using a non suexec enviroment and scripts get executed as
        nobody or the user of apache, please chmod 777 DEVDIR.pm and DB.pm for
        the install.cgi script to set the variables.

4       run install.cgi from the website,
                example: http://www.testdirectory.com/directory/install.cgi

5       Adjust the BASE URL and UNIX PATH Fields unless they default settings
        are correct.

6       Enter in the MySQL Connection Settings into the MySQL fields, this is
        required in order to tell DevDir where the Database is located and to
        login to the database.

7       Enter in a username and password for the Control Panel unless you want
        to use the default values which would be a security concern for your
        directory.

8       Now you should be able to login to the Control Panel which the
        link would have been provided upon success of install.cgi

--------------------------------------------------------------------------------
4) Frequently Asked Questions
--------------------------------------------------------------------------------

--------------------------------------------------------------------------------
5) Bugs
--------------------------------------------------------------------------------

This application is still under development as such there may be from time to
time a bug discovered. Please report all bugs immediately to Dev Coder at the
following address.

http://www.devcoder.com/

Bugs Submissions at http://www.devcoder.com/contact.cgi