The Directory Listing plugin allows to render the content of a directory in a friendly HTML interface when an index file do not exists. Take as an example the following Virtual Host directory content:
/var/www/example/
/bar.zip
/foo.tar.gz
/sample.txt
When hitting the example directory through the http://localhost/example/ URL, the server will try to lookup an index file, as described in the Server Core section, the IndexFile key defines which files can be an index, a few examples would be:
If one of the entries on the IndexFile exists, the server will modify the target path /var/www/example/ and append the right index file. If no one exists, the server will return a 403 Forbidden HTTP error code.
To enable the Directory Listing plugin, please follow the steps mentioned on Plugins section. The plugin name is monkey-dirlisting.so, so make sure the plugin entry is Load and the absolute path is correct.
Once the plugin is loaded, you need to define which Theme the plugin will use to render the directory content in HTML. At the moment the only Theme available is called Guineo.
The main configuration file resides in conf/plugins/dirlisting/dirlisting.conf, and it contain the following schema:
[DIRLISTING]
Theme guineo
The principal section is [DIRLISTING] and allows just one key called Theme to specify which theme should be loaded. The theme directory must exists in the same path than dirlisting.conf exists.