Web-based Directory Lister (WDL)

WDL is a nice-looking Web-based Directory Lister written in PHP. More info why i build this script. Check the blog post (written in Dutch).

Screenshot WDL — Click on the image to view demo.

Features

Clean directory listings with file names, sizes and timestamps
Nice-looking extension icons
Sorting
Search/Filter
Easy configuration and adjustment
Free to use – No license needed!
- Of course a donation is appreciated

Download WDL (.zip) – version: 2505.05
5 downloads so far

How to use

Just upload the index.php file and the files that are in de assets folder in the same directory that contains files you want use the Web-based Directory Lister (WDL). With a zero configuration, drag-and-drop installation you’ll be up and running in less than a minute!

Configuration

The script works well out-of-the-box, and generally you want to leave it as it is. However if you have some adjustments, there are some PHP variables placed in the first lines of index.php you can edit.

You can enable navigation into subfolders using:

$browseDirectories = true; // Navigate into sub-folders

1	$browseDirectories = true; // Navigate into sub-folders

You can change the page title (and subtitle) providing strings that can contains some placeholders that will be parsed at runtime:

$title = 'Index of {{path}}'; // Header title
$subtitle = '{{files}} objects in this folder, {{size}} total'; // Empty to disable

1 2	$title = 'Index of {{path}}'; // Header title $subtitle = '{{files}} objects in this folder, {{size}} total'; // Empty to disable

You can make breadcrumb links if titles contain {{path}}, useful when navigating into subfolders:

$breadcrumbs = true; // Make links in {{path}}

1	$breadcrumbs = true; // Make links in {{path}}

You can tell the script how to build the files list using:

$showParent = false; // Display a (parent directory) link
$showDirectories = true; // Speaks for itself
$showDirectoriesFirst = true; // Lists directories first when sorting by name
$showHiddenFiles = false; // Display files starting with "." too

$showParent = false; // Display a (parent directory) link

$showDirectories = true; // Speaks for itself

$showDirectoriesFirst = true; // Lists directories first when sorting by name

$showHiddenFiles = false; // Display files starting with "." too

And how that list should look:

$showIcons = true; // Speaks for itself
$dateFormat = 'Y-m-d H:i'; // Used in date() function (Examples: d/m/y H:i or d-m-Y H:i)
$sizeDecimals = 1; // Example 10.3 KB if 2 Decimals: 10.33 KB

$showIcons = true; // Speaks for itself

$dateFormat = 'Y-m-d H:i'; // Used in date() function (Examples: d/m/y H:i or d-m-Y H:i)

$sizeDecimals = 1; // Example 10.3 KB if 2 Decimals: 10.33 KB

You can customize the content of the meta-tag “robots” if you want to give some search engine hints:

$robots = 'noindex, nofollow'; // Avoid robots by default

1	$robots = 'noindex, nofollow'; // Avoid robots by default

Finally, you can hide or change the credits / footer:

$showFooter = true; // Display the "Powered by" footer
$textFooter = 'Proudly served by <a href="https://i37.eu/WDL" class="footer" target="_blank" rel="noreferrer noopener">WDL</a> at '.$_SERVER['HTTP_HOST']; // Text footer

1 2	$showFooter = true; // Display the "Powered by" footer $textFooter = 'Proudly served by <a href="https://i37.eu/WDL" class="footer" target="_blank" rel="noreferrer noopener">WDL</a> at '.$_SERVER['HTTP_HOST']; // Text footer

Of course, if PHP is a friend of yours you can easily understand the whole script source code, so the only limit to customization is your imagination.

Showcase

Do you have WDL running? Great! This way even more practical demos can be shown.

Want to be on the list? Get in touch!