Free Directory Script
Login/Password:
demo/demo
Instructions: Support:
Installation Requirements:
The Free Directory Script was designed to run on just about any PHP-enabled web server with very minimal requirements. Unlike most directory software, no SQL database is required; as all directory data is stored in flat-file ASCII databases.

The Free Directory Script does require:

  • PHP version 4.1 (or higher)
  • PHP installation requires Zlib + Curl (normally installed with PHP on most servers)

Installation Instructions:
Step 1. Unpacking The Files
The Free Directory Script comes packaged as a Zip file that needs to be unpacked prior to use. Once you have downloaded the script to your local machine, first unpack the entire zip so the contents (individual files) are located in a folder on your hard drive.

Step 2. Uploading The Files
Upload the files to your web server in a new folder above your root directory, i.e. http://www.yourdomain.com/directory/. You may use whatever name you want for this new folder, you'll alter that a couple of steps later in the configuration file. All files should be kept in their respective sub-folders during unpacking and uploading.

Step 3. Setting File Permissions
Set permissions on all the .cgi files in the /_Data/ folder (a sub directory within your new script folder) to writable (chmod 777). Note that the .cgi extensions are just to prevent direct browser access, these particular files are actually the ASCII databases containing your directory contents, and do not 'run' or contain any Perl (they're basically text files).

Step 4. Edit The Configuration File
Edit the configuration file located in /directory/_config/config.php file to reflect the proper settings for your website. There are three instances that need to be changed:
  1. Setting 1: This is the full path for the root directory of your website, without a trailing slash. For example: /www/home/html
  2. Setting 2: This is the home page of your Web site (not the directory in particular). This is most often your base domain, i.e. http://www.mydomain.com/, but may also be a sub-directory or wherever you want to point to as your home page.
  3. Setting 3:
    4. This is the directory/folder you placed the script files in during Step 2, with both a beginning and trailing slash. Using the same example, if the scripts reside in http://www.yourdomain.com/directory/, this value would be /directory/. If you uploaded to a folder with a different name, simply use that instead.
Step 5. Test Out The Admin Section
At this point the basic installation is complete, and you should be able to see your default directory and access the admin area through your browser. Assuming you installed the script in a folder named /directory/, the respective URL's would be:
  • Directory Front End: http://www.yoursite.com/directory/
  • Administration area: http://www.yoursite.com/directory/_admin
Go ahead and verify both areas are working properly, then proceed to the next step below to password protect your administration area.

Password Protecting The Administration Area:
This is done through the use of standard .htaccess and .htpasswd files located within the /_admin/ sub-directory. You should have already uploaded both files during the initial installation, but they will require a couple of quick changes to work properly.

First, open the .htaccess file located in the /_admin/ directory, and change the AuthUserFile reference on line 3 to match the actual server path to your .htpasswd file.

(The root and script directories are the same information you used in Step 4 when editing your config file.)

  • Save the file and upload the revised version to your server in the same /_admin/ folder.
  • Now try to access your administration area through your browser (http://www.yoursite.com/directory/_admin), and it should be password protected.

The default username is admin, and the password is directory. These are stored directly in the .htpasswd file you just referenced in the .htaccess file above, though the password is encrypted. (It will look like this: admin:1$SwR28GK6i.Y)

You should change both the username and password right away to prevent unauthorized access. Here's how to do it:

  • Open the .htpasswd file for editing.
  • Create a new username and encrypted password. You can use our .htpasswd generator to create this easily and cut-and-paste, or alternatively via command line if you have shell access and are comfortable with the process.
  • Replace the single line admin:1$SwR28GK6i.Y with your new username and encrypted password and save. (Not necessary if you used the command line option)

Now when you re-visit your administration area, you will be prompted for this new username and password. If you ever want to change your login, simply create a new username/password and repeat the process.

That's it, you're done! If you'd like, you can however make more 'search engine friendly' directory pages using mod-rewrite functions. Click Here For Mod-Rewrite Instructions.
All Rights Reserved, FreeDirectoryScript.com