ADD-ON PLUGIN for “WP Document Revisions” (WPDR)!
Want to offer public file downloads? Just use “WP Document Revisions” plus this little add-on plugin! This small and lightweight add-on plugin just adds a few specific additions to the awesome WPDR base plugin which does all the heavy lifting for you!
For my own projects I needed a new but robust and future-proof plugin with a custom post type solution to replace an old, unsupported download counter plugin. With its many benefits I wanted WPDR as a base foundation for that. Now, that I’ve finally found my solution, I hope it may help you as well :-).
What this Add-On does – General Features
- All the benefits of “WP Document Revisions” plugin! (see below)
- Simple, basic download counter included!
- Use “Downloads” wording instead of “Documents” (changeable via options); plus Downloads icon.
- 2 additional taxonomies for download files: “File Categories” and “File Tags”.
- 3 additional Widgets:
- Display most popular/ accessed Downloads with “Popular Downloads”.
- Simple taxonomy listings with “Download File Categories / Tags”.
- To Downloads restricted search with “Search Downloads”.
- Own plugin settings page.
- Help tabs included.
- Fully internationalized!
- Fully Multisite compatible!
Special Features of this Add-On
- Ability to load fully custom translations for WPDR!
- Load “Downloads” specific translations/ wording – formal/ informal variants supported!
- Full German translations included, formal and informal versions – you can choose via options (default is ‘formal’).
Benefits of using “WP Document Revisions” as the base plugin
- In general: fantastic plugin, awesome developer! :)
- Really simple, yet very effective! Does just one thing, but does it right!
- Really secure & robust!
- Revision management by default.
- Workflow Status management by default.
- Uses known WordPress interface – just concentrate on file management :).
- Extendable via Hooks & Filters – very developer friendly.
- Support for “Edit Flow” plugin already included.
- Well developed and coded with Coding Standards and WordPress best practices.
- WordPress 3.4+ — latest version 3.5+ always recommended!
- Already installed plugin “WP Document Revisions”
Recommended Settings & Usage Instructions
Third-party compatibility included
- Genesis Framework: For Child Themes – Display post meta on the frontend for the post type.
- English (default) – always included
- German (de_DE) – always included
- .pot file (
wpdr-simple-downloads.pot) for translators is also always included :)
- Easy plugin translation platform with GlotPress tool: Translate “WP Document Revisions Simple Downloads”…
- Your translation? – Just send it in
- I am open for your suggestions and feedback – Thank you for using or trying out one of my plugins!
- Drop me a line @deckerweb on Twitter
- Follow me on my Facebook page
- Or follow me on +David Decker on Google Plus ;-)
- Also see my other plugins or see my WordPress.org profile page
- Tip: GenesisFinder – Find then create. Your Genesis Framework Search Engine.
Download Latest Version
DOWNLOAD WP Document Revisions – Simple Downloads
v1.0.0 [zip file] // Downloaded 10779 times yet.
- Upload the entire
wpdr-simple-downloadsfolder to the
/wp-content/plugins/directory — or just upload the ZIP package via ‘Plugins > Add New > Upload’ in your WP Admin
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to “Documents”/ “Downloads” > Download Settings to set a few options – or just be happy with the default settings :)
- Go and manage your downloas files :)
Please note, this plugin requires WordPress 3.5 or higher in order to work!
Go the add-on plugin’s settings page (located under “Documents”/ “Downloads” > Download Settings):
- Set downloads slug — via WPDR
- Set upload directory for download files/ documents — via WPDR
- Use “Downloads” wording instead of “Documents”
- Use additional taxonomies and widgets
- Set the preffered translations variant to load
- To insert a download file link into a Post, Page or Custom Post Type, use the regular “Insert Link” feature, search for your Download/ Document file (searches for title!) and insert the actual link. Really simple, yeah!
- To display Download files on the frontend you can also use the included widgets or the shortcodes of WPDR (see the WPDR Wiki for the shortcode documentation – scroll down a bit there…).
- To update an existing file/ document just open the existing item and upload a new version (revision). The file/ document peramlink will always point to the latest revision! Yeah, it’s so easy :)
- You can also use third-party plugins or widgets that support custom post types to query, display or do anything you want with the “Document” post type, that we use for the download files. Pretty simple again, yet very effective and standards compliant.
- List of reccommended third-party plugins:
- Count Shortcode – simple count posts or post types
- Faceted Search Widget – sidebar widget to allow filtering indexes by builtin and custom taxonomies
- Display Posts Shortcode – display a listing of posts or post types using the
- Edit Flow – for even more workflow & team/staff management
- Members – for user roles & capability management
Multisite install: Of course, it’s fully compatible but have a look in the FAQ section here for more info :)
Own translation/wording: For custom and update-secure language files please upload them to
/wp-content/languages/wpdr-simple-downloads/ (just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like
wpdr-simple-downloads-en_US.mo/.po to achieve that (for creating one see the tools on “Other Notes”).
If you ever want to uninstall the add-on (i.e. “WP Document Revisions Simple Downloads”) you can use your stuff like before. All will work like normal as this plugin does NOT make any permanent modifications! Good to know, right?! :)
· Minimum WordPress version required: 3.4+
· Tested up to WordPress version: 3.5.2
Q. Does this plugin work with latest WP version and also older versions?
A. Yes, this plugin works really fine with the LATEST WordPress branch 3.5+! :-)
It was also tested with WordPress version 3.4.2 and worked like a charm! It may work with versions before but this was NOT tested. I always recommend to run the latest version of WordPress anyways :).
Q. Why on earth do I need this plugin along with WPDR?
A. Good question, hehe :). — “WP Document Revision” (WPDR) already does all the heavy lifting for you, and in reality is your actual download manager! This add-on plugin here (a.k.a. “WP Document Revisions Simple Downloads”) does minor adjustments and additions for more comfort, even easier (admin) usage and provides specific “Downloads” specific wording/ translations. The add-on fully leverages the existing hooks & filters of its base plugin as well as from WordPress itself. So, in reality it does not make any (permanent) modifications. With this approach we avoid performance issues and load things only where and when needed. — Also, the add-on adds 3 nice little widgets which may help to improve your site/ download manager on the front end.
Q. Alternatives for inserting downloads/ documents?
A. To insert download files (URLs) into posts, pages, other post types, sidebars or templates just use any of the following alternatives:
2) 2 base shortcodes of WPDR:
[document_revisions] — see Wiki for more info (scroll down a bit…)
3) 4 available widgets: 1 from WPDR, plus 3 from this add-on plugin.
4) Any third-party plugin or widget that does support custom post types by WordPress. I highly recommend one of these: Display Posts Shortcode – display a listing of posts or post types using the
[display-posts] shortcode // Count Shortcode – simple count posts or post types
5) For developers: shortcodes can also be used with their template tag equivalent:
<?php do_shortcode( '[your_shortcode ...]' ); ?>
Q. What’s going on, “Downloads” or “Documents”?
A. You decide, which wording or which translations will be loaded! In my opinion it’s better to use purpose-specific and consistent wording throughout both plugins which will avoid confusions in day to day usage with your team.
The add-on DOESN’T modifiy the actual post type that’s used as the base. This post type is by WPDR and has the ID “document”, therefore some admin urls and such still reflect this ID. But in the end this just doesn’t matter :).
Q. Is this plugin Multisite compatible?
A. Of course it is! :) Works really fine in Multisite invironment.
Q. In Multisite, can I “network activate” this plugin?
A. Yes, you can! Activating on a per-site basis is also possible. — I recommend activating on a per-site basis in combination with “WP Document Revisions” plugin.
Q. Where are the Hooks & Filters documented?
A. Currently as Gist on GitHub. They will also be published on my own Knowledge Base Site coming soon.
Final note: I DON’T recommend to add customization code snippets to your main theme’s/child theme’s
functions.php file! Please use a functionality plugin or an MU-plugin instead! This way you can also use this better for Multisite environments. In general you are then more independent from theme/child theme changes etc. If you don’t know how to create such a plugin yourself just use one of my recommended ‘Code Snippets’ plugins. Read & bookmark these Sites:
- “What is a functionality plugin and how to create one?” – blog post by WPCandy
- “Creating a custom functions plugin for end users” – blog post by Justin Tadlock
- DON’T hack your
functions.phpfile: Resource One – Resource Two (both by Thomas Griffin Media)
- “Code Snippets” plugin by Shea Bunge – also network wide!
- “Code With WP Code Snippets” plugin by Thomas Griffin – Note: Plugin currently in development at GitHub.
- “Toolbox Modules” plugin by Sergej Müller – see also his plugin instructions.
All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/4395899 (you can also add your questions/ feedback there :)
- Initial release