﻿=== WP-Filebase Download Manager ===
Contributors: fabifott
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=money%40fabi-s%2ede&item_name=WP-Filebase&no_shipping=0&no_note=1&tax=0&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8
Tags: filebase, filemanager, file, files, manager, upload, download, downloads, downloadmanager, traffic, widget, filelist, list, thumb, thumbnail, attachment, attachments, category, categories, media, template, ftp, http, mp3, id3
Requires at least: 3.1
Tested up to: 3.1.2
Stable tag: 0.2.9

Adds a powerful downloads manager supporting file categories, download counter, widgets, sorted file lists and more to your WordPress blog.

== Description ==

WP-Filebase is an allround file manager for Wordpress.
It keeps files structured in categories, offers a template system to create sortable, paginated file lists and can sideload files from other websites.
The plugin is made for easy management of many files and consistent output using templates.

With WP-Filebase you can...

*	create dynamic paginated and sortable file lists
*	build photo galleries
*	embed flash (or other formats) videos using a template player
*	easily publish MP3 and other audio files with automatic ID3 tag detection
*	restrict downloads for certain user roles

Some more features:

*	Category / child category / file taxonomy
*	Automatic thumbnail
*	Built-in download counter
*	File List Widget
*	Ajax file tree browser
*	Reads ID3 Tags and other file info of the most common file types (JPEG, videos etc...)
*	Customizable template system
*	Insert flexible shortcodes with the Visual Editor Plugin
*	Sortable paginated file lists
*	Associate files to posts and automatically attach them to the content
*	User level restrictions
*	Upload files in your browser, with FTP or from URL (sideloading)
*	Traffic limits and bandwidth throttle
*	Permalink structure
*	Hotlinking protection
*	Range download (allows users to pause downloads and continue them later)
*	Custom JavaScript download tracking (e.g. Google Analytics)
*	Many file properties like author, version, supported languages, platforms and license
*	Search integration
*	Automatic synchronization of file system and database


You can see a [live demo on my Website](http://fabi.me/downloads/ "WP-Filebase demo")
For support, please [leave a message on my blog](http://fabi.me/wordpress-plugins/wp-filebase-file-download-manager/#postcomment "Post comment"). When having trouble don't forget to post PHP and Wordpress version! Any ideas/feature requests are welcome.

**Note when updating to 0.2.1:** Since 0.2.1 WP-Filebase uses a different shortcode format. Old tags can be easily converted with the built-in converter. Please backup your database and run the converter right after the update. You should also run a filebase sync!
**Important:** Don't upgrade to 0.2.1 if you are still running old PHP 4! WP-Filebase 0.2.1 only runs on PHP 5 and later!

If you want to translate WP-Filebase in your language, open `wp-filebase/languages/template.po` with [Poedit](http://www.poedit.net/download.php) and save as `wpfb-xx_YY.po` (`xx` is your language code, `YY` your country). Poedit will create the file `wpfb-xx_YY.po`. Put this file in `wp-filebase/languages` and share it if you like (attach it to an email or post it on my blog).

**Note:** If you only want to limit traffic or bandwidth of media files you should take a look at my [Traffic Limiter Plugin](http://wordpress.org/extend/plugins/traffic-limiter/ "Traffic Limiter").

== Installation ==

1. Upload the `wp-filebase` folder with all it's files to `wp-content/plugins`
2. Create the directory `/wp-content/uploads/filebase` and make it writable (FTP command: `CHMOD 777 wp-content/uploads/filebase`)
3. Activate the Plugin and customize the settings under *Settings->WP-Filebase*

== Frequently Asked Questions ==

= How can do I get the AJAX tree view like on http://fabi.me/downloads/ ? =

This feature is called File Browser. Go to WP-Filebase settings and click on the tab 'File Browser'. There you can select a post or page where the tree view shoud appear.

= How do I insert a file list into a post?  =

In the post editor click on the *WP-Filebase* button. In the appearing box click on *File list*, then select a category. Optionally you can select a custom template.

= How do I list a categories, sub categories and files?  =

To list all categories and files on your blog, create an empty page (e.g named *Downloads*). Then goto *WP-Filebase Settings* and select it in the post browser for the option *Post ID of the file browser*.
Now a file browser should be appended to the content of the page.

= How do I add files with FTP? =

Upload all files you want to add to the WP-Filebase upload directory (default is `wp-content/uploads/filebase`) with your FTP client. Then goto WP-Admin -> Tools -> WP-Filebase and click *Sync Filebase*. All your uploaded files are added to the database now. Categories are created automatically if files are in sub folders.

= How do I customize the appearance of filelists and attached files? =

You can change the HTML template under WP-Filebase -> Settings. To edit the stylesheet goto WP-Admin -> Tools -> WP-Filebase and click *Edit Stylesheet*.
Since Version 0.1.2.0 you can create your custom templates for individual file lists. You can manage the templates under WP-Admin -> Tools -> WP-Filebase -> Manage templates. When adding a tag to a post/page you can now select the template.

= How can I use custom file type/extension icons? =

WP-Filebase uses WordPress' default file type icons in `wp-includes/images/crystal` for files without a thumbnail. To use custom icons copy the icon files in PNG format named like `pdf.png` or `audio.png` to `wp-content/images/fileicons` (you have to create that folder first).

= What to do when downloading files does not work? =

Goto WP-Filebase Settings and disable Permalinks under "Download". Try to disable other plugins. Disable WP_CACHE. Enable WP_DEBUG to get more info about possible errors.

== Screenshots ==

1. Example of an embedded download box with the default template
2. The WP-Filebase Widgets
3. AJAX file tree view
4. The Editor Button to insert tags for filelists and download urls

== Changelog ==

= 0.2.9 =
* New Feature: Files are scanned for ID3 tags and other data that can be displayed in templates
* Automatic thumbnails out of MP3 cover arts
* New default templates for MP3 files
* New default template for FLV videos (including player)
* Added option for disabling HTTP Caching
* Re-structured setting tabs
* Thumbnail fix

= 0.2.8.5 =
* Added support for multiple embedded AJAX file tree views (file browsers)
* Edit links for changed files when syncing
* Added file extension blacklist
* Fixed an issue with CKEditor
* Better syncing of file dates
* Disabled cron sync by default

= 0.2.8.4 =
* Fixed JavaScript enqueue issues conflicting other plugins

= 0.2.8.3 =
* Fixed context menu for file links pointing to the associated page/post
* Images are considered as thumbnails for files with the same name when syncing
* Attachment listing now works outside the loop on a single post/page

= 0.2.8.2 =
* New file browser sort options
* Files can be sorted by ID
* Search integration fixed
* Fixed issues for multi site support
* Fixed template management tabs

= 0.2.8.1 =
* Fixed File Browser sorting
* Improved filename version detection

= 0.2.8 =
* New sort option `file_category_name` to sort files by the name of their category
* Editor Plugin: Added option to include all categories in a file list
* Post selector lists private posts now
* Added warning in content if list template does not exists (only visible for editors)
* New option `Send HTTP-Range header`
* New option `Redirect to referring page after login`
* Fixed search SQL: search was listing drafts with attached files

= 0.2.7 =
* Fixed sideload bug and improved support for large files
* Fixed file form presets bug
* Shortcode without quotes to increase compatibility with custom visual editors

= 0.2.6 =
* Made Editor Plugin compatible with [CKEditor](http://wordpress.org/extend/plugins/ckeditor-for-wordpress/)
* Fixed AJAX response when using WP-Minify
* Fixed script enqueue bug in editor_plugin.php

= 0.2.5 =
* Fixed several bugs occurring with MySQL strict mode
* Fixed compatibility issue in the Editor Popup with other plugins

= 0.2.4 =
* Added search form for file list (use `%search_form%` in list template footer or header)
* New option `Automatic Sync` which enables hourly synchronizations
* Files are now hidden when offline if `Hide inaccessible files` is enabled
* Fixed file browser
* Fixed post browser

= 0.2.3 =
* File browser is sorted with default settings now
* Existing files can now be attached to a post in editor plugin
* New option `Protect upload path`
* Fixed issue with AJAX file tree in `wpfb-ajax.php`
* Fixed broken delete function in context menu
* Some JavaScript optimizations

= 0.2.2 =
* Scrollbars in post browser
* Fixes Title issues in post browser
* Fixed admin dashboard form
* Fixed download_denied bug

= 0.2.1 =
* Sortable, paginated file lists
* New tree view post browser
* WP Search integration (search includes post attachments)
* Categories can be exluded from file browser
* Improved Widgets (you can specify a category for the file list now)
* Swedish translation by Håkan
* Russian translation by [L4NiK](http://lavo4nik.ru/plagin-zagruzki-fajlov-dlya-wordpress-wp-filebase-na-russkom/)
* Added context menu to file links for direct editing and deletion
* New Admin Menu Bar integration
* Admin Dashboard Widget
* Improved editor plugin
* New tree view file browser
* New Option *Hide download links*
* Added support for remote files (sideload and redirect)
* Template preview
* Removed deprecated user level system, using Roles for file and category permissions now
* New TPL vars `%post_id%`, `%file_type%`, `%file_extension%`
* Output buffering fix to trim any interfering output when downloading
* File name version detection (i.e: `sample-v1.2.ext`)
* Small thumbnails in admin file list
* Added RAR file type
* Fixed 404 bug when home url differs from site url
* Added anchor to category links
* Fixes, fixes and new bugs ;)

= 0.1.3.4 =
* Fixed blank tools page caused by empty Wordpress upload path
* Added notice if WP-Filebase upload path is rooted

= 0.1.3.3 =
* Brazillian Portuguese translation by [Jan Seidl](http://www.heavyworks.net/)
* French translation by [pidou](http://www.portableapps-blog.fr/)

= 0.1.3.2 =
* Added daily user download limits
* JavaScript errors caused by jQuery tabs function are suppressed if not supported by the browser
* Added support for custom file type icons. Copy your icons to `wp-content/images/fileicons` (see FAQ).

= 0.1.3.0 =
* Added option *Parse template tags in RSS feeds*
* New Widget: Category list
* Settings are organized in tabs now
* Conditional loading of WP-Filebase's JS
* Automatic login redirect
* Validated template output (**Note**: line breaks are not converted to HTML anymore, so please add &lt;br /&gt;'s or reset your settings to load the default template)
* Added localization support
* German translation
* Editor Button code changes
* Changed default file permissions from 777 to 666
* Fixed file date bug causing a reset of the date

= 0.1.2.4 =
* New option *Category drop down list* for the file browser
* Fixed sync bug

= 0.1.2.3 =
* Added support for custom Category Icons
* Fixed `file_url` in the download JavaScript for proper tracking
* Fixed a thumbnail upload bug

= 0.1.2.2 =
* Files and categories in the file browser are sorted now
* Category directories are now renamed when the folder name is changed
* Fixed file browser query arg
* Fixed Permalink bug

= 0.1.2.1 =
* New feature: category template for category listing
* New feature: added file browser which lists categories and files
* Added option to disable download permalinks
* New option *Decimal file size prefixes*
* Fixed a problem with download permalinks
* Fixed an issue with auto attaching files
* Fixed a SQL table index issue causing trouble with syncing
* Fixed a sync bug causing categories to be moved into others

= 0.1.2.0 =
* Added multiple templates support (you can now create custom templates for file lists)
* Added option *Hide inaccessible files* and *Inaccessible file message*
* When resetting WP-Filebase settings the traffic stats are retained now
* Fixed *Manage Categories* button
* Enhanced content tag parser
* Added support for HTTP `ETag` header (for caching)
* Improved template generation

= 0.1.1.5 =
* Added CSS Editor
* Added max upload size display
* Fixed settings error `Missing argument 1 for WPFB_Item::WPFB_Item()`
* Fixed widget control
* Fixed an issue with browser caching and hotlink protection

= 0.1.1.4 =
* Download charset HTTP header fixed
* Editor file list fixed
* New file list option `Uncategorized Files`

= 0.1.1.3 =
* Added FTP upload support (use `Sync Filebase` to add uploaded files)
* Code optimizations for less server load
* File requirements can include URLs now
* Fixed options checkbox bug
* Fixed an issue with the editor button
* Fixed form URL query issue
* Some fixes for Windows platform support

= 0.1.1.2 =
* Fixes - for PHP 4 only

= 0.1.1.1 =
* Now fully PHP 4 compatible (it is strongly recommended to update to PHP 5)
* Fixed a HTTP header bug causing trouble with PDF files and Adobe Acrobat Reader
* New option *Always force download*: if enabled files that can be viewed in the browser (images, videos...) can only be downloaded (no streaming)
* Attachement lists are sorted now
* The MD5 hash line in the file template is now commented out by default
* Fixed `Fatal error: Cannot redeclare wpfilebase_inclib()`

= 0.1.1.0 =
* Added simple upload form with less options which is shown by default
* Fixed editor button
* Changed editor tag box
* Selection fields in the file upload form are removed if there are no entries
* You can now enter custom JavaScript Code which is executed when a download link is clicked (e.g. to track downloads with Google Analytics)
* If no display name is entered it will be generated from the filename
* Removed the keyword `private` in class property declarations to make the plugin compatible with PHP 4
* Serveral small bug fixes
* CSS fixes
* Optimized code to decrease memory usage

= 0.1.0.3 =
* Added file list sorting options
* Rearranged options
* Fixed `Direct linking` label of upload form
* Added HTML link titles of the default template (to enable this change you must reset your options to defaults)

= 0.1.0.2 =
* Fixed a HTTP cache header
* Added support for HTTP If-Modified-Since header (better caching, lower traffic)

= 0.1.0.1 =
* Added download permissions, each file can have a minimum user level
* New Editor Tag `[filebase:attachments]` which lists all files associated with the current article
* Fixed missing `file_requirements` template field. You should reset your WP-Filebase settings if you want to use this.

= 0.1.0.0 =
* First version

== Upgrade Notice ==

= 0.2.0 =
PHP 5 or later required! This is a big upgrade with lots of new features. You have to convert old content tags to new shortcodes. Go to WP-Filebase management page and you should see a yellow box with the converter notice (backup the Database before!). And sync the filebase after that!