SYSTEM REQUIREMENTS
-------------------
This has currently been tested on:
Mac OS X.5.7 with PHP 5.2.8 and Apache 2.2.11


PERMISSIONS
-----------
All of the file for this project should have only read permissions for the entire world.


USING THE FILE(S)
-----------------
THE SCRIPT (index.php):
The only things that should be changed are the settings in the settings section
This file should always have the name "index.php" in order for it to exclude itself from the listing
If the name is changed then this file will list itself in the directory listing
To use this file drop it in the directory you want a listing for
Your server will have to be set to look for an "index.php" for this to automatically work
This file searches for files for CSS, "favicon.ico" and the thumbnail files, but will ignore them if they do not exist
There are CSS classes for this script that would need to be added to your stylesheet if you choose to, they are in the included styles.css file
If you want to add custom instructions or messages to the directories you can use the HEADER.html, README.html, and FOOTER.html files
These are the same ones that Apache uses so it will inherit the same messages as the Apache listings
Just drop any of these three files into the same directory you want the message to show up in
The contents of the header.html file will show at the top of the listing
The contents of the readme.html file will show at the bottom of the listing
The contents of the footer.html file will also show at the bottom of the listing, but after the README.html file
The following files and directories are automatically excluded from the listing:
"index.php", "header.html", "readme.html", "footer.html", "robots.txt", "edl_settings.php" and all files beginning with "."
There are a total of 70 file types that have descriptions listed by this script
There are a total of 70 file types that have icons listed by this script

styles.css:
This file does not have to be used because there is internal CSS in the script, but it can be used if you want to match your themes of the rest of your website

OZZIEBURN_FREEWARE_LICENSE_v2.txt:
This is the license

readme.txt:
this file

dirlist folder:
this is the folder that contains the graphic files for the script

sample_file_listing folder:
this folder can be trashed, it is just for displaying the file types and icons the script acknowledges

edl_settings.php:
This is a file that you can use to override the global settings that are set in the script file itself.  For example, if you have the settings in the file set and you want to override them for a specific directory you can include this file in that directory and it will override the settings in the script file.  if this file is not in the directory it will just ignore it and use the ones in the script file.


The Settings
------------
$CSSToUse = "Internal"; // Options: Internal | External
This is to set whether the file uses the built in CSS or an external file for CSS

$WebStyles = "http://{$_SERVER['SERVER_NAME']}/settings";
This is for the path to the CSS file, the default is styles.css. (enter complete address without the trailing "/")

$CSSFileName = "styles.css";
This is the change the name of the CSS file to whatever name is desired.

$WebFavicon = "http://{$_SERVER['SERVER_NAME']}";
This is for the favicon.ico file (enter complete address without the trailing "/")

$WebAddress = "{$_SERVER['DOCUMENT_ROOT']}";
This is the domain or Document_Root for checking if the file icons exist (enter without the trailing "/")

$WebAddressPath = "/pagegraphics/dirlist";
This is the path to the icons (enter without the trailing "/")

$WebAddressLink = "http://{$_SERVER['SERVER_NAME']}";
This is the domain or Server_Name for displaying if the file icons exist (enter without the trailing "/")

$DirShift = "";
Enter the path that you would like to display (enter with the trailing "/").  This normally would be left empty.  If you would like to use this directory listing to show the contents of an alternate directory then place the relative path here
For example, if this script file is located at /testdir/index.php but you want to show a listing for /testdir/samplefiles/ then you would have to put in samplefiles/ in the $DirShift value.  It is worth noting that you can go to a higher level directory with this feature as well, but some things will not work seamlessly.

$ShowHeaderFile = "Yes";
This will dis/enable looking for a header.html file.

$ShowFooterFile = "Yes"; // Default is "Yes"  // Options: Yes | No
This will dis/enable looking for a footer.html file.

$ShowReadmeFile = "Yes"; // Default is "Yes"  // Options: Yes | No
This will dis/enable looking for a readme.html file.

$ShowParentMain = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the parent directory and main site links above the directory listing.

$ShowFlagPerms = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the flag half of the permissions column.

$ShowNumPerms = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the numeric half of the permissions column.

$ShowTotalItemCount = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the total count of files under the directory listing.

$ShowTotalSpace = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the total size next to the total item count under the listing.

$ShowPageReferer = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the page referer at the bottom of the page.

$ShowIPAddress = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the ip address at the bottom of the page.

$ShowHostname = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the hostname at the bottom of the page.

$ShowServerInfo = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the server information at the bottom of the page.

$ShowPageTimer = "Yes"; // Default is "Yes"  // Options: Yes | No
This will show/hide the page load timer at the bottom of the page.