You are on page 1of 4

Directory Listing 1.0.0.

0
This extension is based on original code by Ash Young at Evoluted - www.evoluted.net.

What is it?
The extension provides a customisable presentation of files and folders on your server. You can set an automatic display of image thumbnails if required, exclude folders and only show files, exclude specific files or file types, allow file uploads. The extension will require the page format to be PHP and therefore PHP is required to be installed on your server. Also, to take advantage of the auto generation of image thumbnails this extension requires GD2 to be installed on your server. This DEMO version shows the extension in use.

Properties
This extension has seven property areas that can be customised. These properties manage CSS and PHP options. a. Configuration Sets the capabilities of the extension. Start Directory. The default is set to '.' but this can be edited to start in any folder within your domain; for example you could set this to 'images' Show Thumbnails. The default is set to TRUE. This setting requires GD2 to be installed on your server. This auto-generates image thumbnails. Show Directories. The default is set TRUE. Set to FALSE to hide folders. Force Downloads. The default is set to FALSE. Set to TRUE if you require site visitors to download the file to their computer rather than viewing it in their browser.

Hide Files List. The default is set 'dlf', 'index.php', 'Thumbs', '.htaccess', '.htpasswd' but this can be edited to include any file names you do not want visible. Note however that the syntax requires 'filename', but the last item does not need a comma. Display File Types. The default is set to 'jpg', 'pdf', 'png', 'gif', 'zip', 'txt' but this can be edited to add or delete other file types. Note that the syntax is the same as the Hide Files List therefore the last item does not require a comma at the end. Show Index File. The default is set to FALSE. Set to TRUE if you require any index.html, index, htm or index.html to be shown rather than a directory listing. Allow Uploads. The default is set to FALSE. Set to true if you wish to provide site visitors to be able to upload files to the server. Once set to TRUE a separate upload box will be seen at the bottom of the file directory listing. WARNING: This setting should only be set to TRUE when the page is accessed from a secure folder or an area with username and password access. Upload File Types. The default is set to 'zip', 'gif', 'jpg', 'pdf', 'doc', 'png' but this can be edited to add or delete file types. Note that the syntax is the same as the Hide Files List and Display File Types setting therefore the last file type does not require a comma. Overwrite Files. The default is set to FALSE. This prevent users overwriting current files.

b. General Styling. Body Background Color. The default is set to WHITE (#FFFFFF or RGB 255,255,255) and this determines the background colour of the main listing area. c. Heading Stye. Settings here manage the color, font size, font family and font weight together with padding options. d. Breadcrumb Style. Settings here manage the color, font size, font family and font weight together with padding options. e. Listing Style. Settings here manage the color, font size, font family and font weight together with padding options and some border and background color options. f. Image Preview Style. Settings here manage the color and border style of the image preview box. g. Upload Panel Style. Settings here manage the color, font size, font family and font weight together with padding options and some border and background panel colors.

DEMO The DEMO version shows the extension in use.

Recommended Use:

I have used this code with several client sites that have username and password sections of their websites. This is ideal code to allow clients, their partners or members to view large directories of PDF files or other documents. In many cases I also provide a second admin style page that provides the upload facility to a named client. I was unable to find a method to display the extension within a normal WB7 page other than by creating a Directory Listing page and then calling that page into a WB7 page using either an iFrame, and expandable iFrame (using the expandable iFrame extension) or by using a PHP include statement. The most accurate representation was found using the PHP include. Therefore :1. Create a page called listing.php or whatever you chose to call it. Set the page to 650px wide and any depth 100px is sufficient. 2. Add in the extension and customise the settings. 3. Create a second page and call in listing.php (or whatever you called it) using either an iFrame, expandable iFrame or use HTML from the Advanced toolbox and use a PHP include (see image below). 4. Publish. 5. Upload both pages to the server to view results.

How to install this extension so it is available in WYSIWYG Web Builder? You can use the Extension Manager (Menu->Tools->Extension Manager) to install this extension. Alternatively you can manually copy all files from the zip file to the Web Builder extensions folder. Usually this folder is in this location: My Documents\WYSIWYG Web Builder\system\extensions\ Requirements WYSIWYG Web Builder 7.2 or higher PHP installed on your server. GD2 installed on your server if you intend to auto generate thumbnails of images.

Known limitations Display size is fixed. License Agreement This extension is free for registered users of WYSIWYG Web Builder. This extension may not be sold, rented, redistributed, sublicensed or modified without permission of the author. This extension is provided "AS IS" without warranty of any kind including, but not limited to, warranties of merchantability, fitness for a particular purpose and noninfringement. In no event will Pablo Software Solutions be liable for any direct, indirect, incidental, special, exemplary or consequential damages, including damages for loss of profits, loss or inaccuracy of data, incurred by any person from such person's usage of this extension if advised of the possibility of such damages.
This extension was created by Paul Burton of Aditerum Limited. Copyright 2011 Aditerum http://www.aditerum.co.uk