Title: WaltersWorks File Library
Author: waltersworks
Published: <strong>November 19, 2026</strong>
Last modified: November 19, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/waltersworks-file-library.svg)

# WaltersWorks File Library

 By [waltersworks](https://profiles.wordpress.org/waltersworks/)

[Download](https://downloads.wordpress.org/plugin/waltersworks-file-library.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/waltersworks-file-library/#description)
 * [Reviews](https://wordpress.org/plugins/waltersworks-file-library/#reviews)
 *  [Installation](https://wordpress.org/plugins/waltersworks-file-library/#installation)
 * [Development](https://wordpress.org/plugins/waltersworks-file-library/#developers)

 [Support](https://wordpress.org/support/plugin/waltersworks-file-library/)

## Description

WaltersWorks File Library gives your site a small, dependable library of downloadable
files. Add a file, put it in one or more categories, and list a category anywhere
with a shortcode.

It is also a drop-in replacement for the Better File Download plugin. It reads the
same data, supports the same shortcodes, and keeps old `/bfd_download/{name}/` links
working, so you can switch without re-entering anything or editing your pages.

**Features**

 * A Downloads screen in the admin, with a File column and a category filter.
 * Upload a file or choose one from the Media Library.
 * `[wwfl_category]` lists every file in a category, newest first.
 * `[wwfl_file]` links to a single file.
 * PDFs open in the browser. Other file types download.
 * Clean, accessible list markup that inherits your theme’s styles.
 * Purges W3 Total Cache, WP Super Cache, WP Rocket and LiteSpeed Cache after a 
   change, so visitors see new files right away.
 * Never deletes your data. Deactivating or deleting the plugin leaves every file
   and category in place.

**Security**

WaltersWorks File Library refuses script and executable files, so a Download can’t
be used to put a program or web page on your site. It checks:

 * The file’s extension, including double extensions such as `report.php.pdf`.
 * Disguised names: right-to-left override and other hidden characters, control 
   characters, colons, and names ending in a dot or space.
 * The file’s contents, so a program renamed to `invoice.pdf` is still caught.

When a file is refused, or an upload fails because of a size limit or a server problem,
WaltersWorks File Library says what went wrong and how to fix it. These checks apply
only to Downloads. Uploads anywhere else on your site are unchanged.

**Shortcodes**

List the files in a category:

    ```
    [wwfl_category category="reports"]
    ```

Options:

 * `category` (required): the category’s slug.
 * `latest`: show only this many files. Default: all.
 * `orderby`: `date`, `title` or `menu_order`. Default: `date`.
 * `order`: `DESC` or `ASC`. Default: `DESC`.

Link to one file:

    ```
    [wwfl_file id="123"]
    ```

Options:

 * `id` (required): the Download’s ID, shown in the address bar when you edit it.
 * `title`: link text. Default: the Download’s title.

Better File Download’s `[download_category]` and `[download]` shortcodes work the
same way, so existing pages need no changes. WaltersWorks File Library only registers
them when no other plugin already uses those names.

## Installation

 1. Install and activate WaltersWorks File Library from Plugins > Add New, or upload
    the `waltersworks-file-library` folder to `/wp-content/plugins/`.
 2. Go to Downloads > Categories and add a category.
 3. Go to Downloads > Add New, give the file a title, choose the file, and pick its
    category.
 4. Add `[wwfl_category category="your-category-slug"]` to any page.

#### Switching from Better File Download

 1. Deactivate Better File Download. Don’t delete it until you’ve confirmed everything
    works, and don’t run both plugins at once.
 2. Install and activate WaltersWorks File Library.
 3. Your existing files, categories, shortcodes and links work as before.

WaltersWorks File Library stores its data under Better File Download’s names (the`
bfd_download` post type and `download-categories` taxonomy) so the switch needs 
no migration. New sites use the same names.

## FAQ

### Which file types are refused?

Server scripts (such as PHP), files that run in the browser (such as HTML, SVG and
JavaScript), programs and installers (such as EXE, MSI, DMG, APK and JAR), macro-
enabled Office files (such as DOCM and XLSM), and server configuration files. Documents,
spreadsheets, presentations, images, audio, video and archives are fine.

Developers can change the list with the `wwfl_blocked_extensions` filter.

### What if a Download already points to a blocked file?

Files saved before WaltersWorks File Library was installed were never checked. The
Downloads list marks any with a blocked file type, and the edit screen explains 
why. Replace the file to clear the warning.

### Why was my upload refused for its size?

Your server sets the largest file it accepts. WaltersWorks File Library shows the
limit on each Download’s edit screen and names it in the error. To upload larger
files, ask your hosting provider to raise PHP’s `upload_max_filesize` and `post_max_size`.

### Does WaltersWorks File Library count downloads?

No. Links go straight to the file. If your site has an existing Better File Download
count, WaltersWorks File Library leaves it untouched.

### Can I turn off the cache purge?

Yes. Add `add_filter( 'wwfl_purge_page_cache', '__return_false' );` to your theme
or a small plugin. To purge a cache WaltersWorks File Library doesn’t know about,
hook into the `wwfl_after_purge_page_cache` action.

### Does WaltersWorks File Library contact any outside service?

No. It sends no data anywhere and loads nothing from other sites.

### Is WaltersWorks File Library affiliated with Better File Download?

No. WaltersWorks File Library is an independent plugin that reads the same data,
so sites can keep their files after Better File Download stopped being maintained.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WaltersWorks File Library” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ waltersworks ](https://profiles.wordpress.org/waltersworks/)

[Translate “WaltersWorks File Library” into your language.](https://translate.wordpress.org/projects/wp-plugins/waltersworks-file-library)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/waltersworks-file-library/),
check out the [SVN repository](https://plugins.svn.wordpress.org/waltersworks-file-library/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/waltersworks-file-library/)
by [RSS](https://plugins.trac.wordpress.org/log/waltersworks-file-library/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * First public release.

## Meta

 *  Version **1.0.0**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [document library](https://wordpress.org/plugins/tags/document-library/)[downloads](https://wordpress.org/plugins/tags/downloads/)
   [file download](https://wordpress.org/plugins/tags/file-download/)[file manager](https://wordpress.org/plugins/tags/file-manager/)
   [shortcode](https://wordpress.org/plugins/tags/shortcode/)
 *  [Advanced View](https://wordpress.org/plugins/waltersworks-file-library/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/waltersworks-file-library/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/waltersworks-file-library/reviews/)

## Contributors

 *   [ waltersworks ](https://profiles.wordpress.org/waltersworks/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/waltersworks-file-library/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://ko-fi.com/waltersworks)