Curtiss Grymala

<p>This WordPress plug-in allows users to easily list all of the attachments associated with a specific post or page within WordPress. For instance, if you want to create a long list of Word documents or PDF documents, you can simply attach them to the page or post, then insert the shortcode where you’d like that list to appear.</p>
<h4>Usage</h4>
<p>The simplest way to use this plug-in is just to use the shortcode. That will, by default, list the attachments with the most recent upload at the top of the list and the oldest upload at the end of the list. No heading will be included above the list. The list will be created as an unordered list with the CSS class of “attachment-list”.</p>
<p>[list-attachments]</p>
<h4>Options</h4>
<ul>
<li>type – a comma-separated list of file extensions that should be included in the list. If this is left empty, all attachments will be included<br />
orderby – any of the values that can be used with the WordPress query_posts() function</li>
<li>order – indicate whether the list should be sorted in ascending or descending order</li>
<li>groupby – if you would like the list split into specific groups, you can indicate any of the WordPress post object parameters as the value of this property. For instance, you can use a common “description” for your attachments to organize them into groups. In that case, you would use “post_content” as the “groupby” parameter for this shortcode</li>
<li>before_list – any HTML code you want to appear before the list begins<br />
opening – the opening tag(s) for the list (defaults to <ul class=”attachment-list”>)</li>
<li>closing – the closing tag(s) for the list (defaults to </ul>)</li>
<li>before_item – the opening tag(s) for each item of the list (defaults to <li>)</li>
<li>after_item – the closing tag(s) for each item of the list (defaults to </li>)</li>
</ul>
<p>This is the first version of this plug-in, so I’m certain there are a lot of features that still need to be added and bugs that need to be worked out. If you try out the plug-in and have any suggestions or notice any issues, please comment on this post and let us know.</p>
<h3>Known Issues</h3>
<ul>
<li>The HTML code arguments (before_list, after_list, before_item, after_item, etc.) only work when added through the visual editor. When added through the HTML editor, they are not sent properly through the shortcode.</li>
</ul>
<h3>To Do</h3>
<ul>
<li>Re-do the method of handling the HTML code arguments</li>
<li>Remove the handful of hard-coded HTML elements that are in the plug-in, making them configurable through shortcode arguments</li>
<li>Add a widget to the plugin</li>
</ul>


List Attachments Shortcode

Adds a shortcode to display a list of files attached to a post.

Ben Balter

nwjames

<p>A document management and version control plugin for WordPress that allows teams of any size to collaboratively edit files and manage their workflow.</p>
<h3>What is WP Document Revisions?</h3>
<p><a href="https://wordpress.org/plugins/wp-document-revisions/" rel="ugc">WP Document Revisions</a> is a <a href="https://en.wikipedia.org/wiki/Document_management_system" rel="nofollow ugc">document management</a> and <a href="http://en.wikipedia.org/wiki/Revision_control" rel="nofollow ugc">version control</a> plugin. Built for time-sensitive and mission-critical projects, teams can collaboratively edit files of any format — text documents, spreadsheets, images, sheet music… anything — all the while, seamlessly tracking the document’s progress as it moves through your organization’s existing workflow.</p>
<h4>WP Document Revisions is three things</h4>
<ol>
<li><strong>📁 Document Management System (DMS)</strong> – Track, store, and organize files of any format</li>
<li><strong>👥 Collaboration Tool</strong> – Empower teams to collaboratively draft, edit, and refine documents</li>
<li><strong>🔒 File Hosting Solution</strong> – Publish and securely deliver files to teams, clients, or the public</li>
</ol>
<p>See <a href="https://wp-document-revisions.github.io/wp-document-revisions/features/" rel="nofollow ugc"><strong>the full list of features</strong></a> for more information.</p>
<h3>📚 Documentation</h3>
<p><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions" rel="nofollow ugc">Complete Documentation Site</a></strong> – Your one-stop resource for everything about WP Document Revisions.</p>
<h4>🎯 Quick Start Guides</h4>
<ul>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/installation/" rel="nofollow ugc">Installation</a></strong> – Get up and running in minutes</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/features/" rel="nofollow ugc">Features and Overview</a></strong> – Discover what WP Document Revisions can do</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/screenshots/" rel="nofollow ugc">Screenshots</a></strong> – See the plugin in action</li>
</ul>
<h4>📖 User Documentation</h4>
<ul>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/frequently-asked-questions/" rel="nofollow ugc">Frequently Asked Questions</a></strong> – Common questions answered</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/actions/" rel="nofollow ugc">Plugin Actions</a></strong> – Available WordPress actions</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/filters/" rel="nofollow ugc">Plugin Filters</a></strong> – Available WordPress filters</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/shortcodes/" rel="nofollow ugc">Plugin Shortcodes and Widget</a></strong> – Display documents on your site</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/useful-plugins-and-tools/" rel="nofollow ugc">Useful Plugins and Tools</a></strong> – Extend functionality</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/translations/" rel="nofollow ugc">Translations</a></strong> – Multi-language support</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/links/" rel="nofollow ugc">Links</a></strong> – Additional resources</li>
</ul>
<h4>🆘 Support & Community</h4>
<ul>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/SUPPORT/" rel="nofollow ugc">Where to get Support or Report an Issue</a></strong> – Get help when you need it</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/CONTRIBUTING/" rel="nofollow ugc">How to Contribute</a></strong> – Join our community</li>
<li><strong><a href="https://groups.google.com/forum/#!forum/wp-document-revisions" rel="nofollow ugc">Join the Mailing List</a></strong> – Stay updated</li>
</ul>
<h3>Features</h3>
<h4>Overview</h4>
<p><strong>Powerful Collaboration Tools</strong> – <em>With great power does not have to come great complexity.</em> Based on a simple philosophy of putting powerful but intuitive tools in the hands of managers and content creators, WP Document Revisions leverages many of the essential WordPress features that, for more than eight years, have been tested and proven across countless industries — posts, attachments, revisions, taxonomies, authentication, and permalinks — to make collaborating on the creation and publication of documents a natural endeavor. Think of it as an <a href="http://ben.balter.com/2011/04/04/when-all-you-have-is-a-pair-of-bolt-cutters/" rel="nofollow ugc">open-source and more intuitive version</a> of the popular Microsoft collaboration suite, <a href="http://sharepoint.microsoft.com/en-us/Pages/default.aspx" rel="nofollow ugc">Sharepoint.</a></p>
<p><strong>Document History</strong> – At each step of the authoring process, WP Document Revisions gives you an instant snapshot of your team’s progress and the document’s history. It even gives you the option to revert back to a previous revision — so don’t fret if you make a mistake — or receive updates on changes to the document right in your favorite feed reader.</p>
<p><strong>Access Control</strong> – Each document is given a persistent URL (e.g., yourcompany.com/documents/2011/08/TPS-Report.doc) which can be private (securely delivered only to members of your organization), password protected (available only to those you select such as clients or contractors), or public (published and hosted for the world to see). If you catch a typo and upload a new version, that URL will continue to point to the latest version, regardless of how many changes you make.</p>
<p><strong>Enterprise Security</strong> – Worried about storing propriety or sensitive information? WP Document Revisions was built from the first line of code with government- and enterprise-grade security in mind. Each file is masked behind an anonymous 128-bit <a href="http://en.wikipedia.org/wiki/MD5" rel="nofollow ugc">MD5 hash</a> as soon as it touches the server, and requests for files are transparently routed through WordPress’s time-tested URL rewriting, authentication, and permission systems (which can even <a href="https://wordpress.org/plugins/active-directory-integration/" rel="ugc">integrate with existing enterprise active directory</a> or <a href="https://wordpress.org/extend/plugins/simple-ldap-login/" rel="ugc">LDAP servers</a>). Need more security? WP Document Revisions allows you to store documents in a folder above the <code>htdocs</code> or <code>public_html</code> <a href="http://httpd.apache.org/docs/2.0/mod/core.html#documentroot" rel="nofollow ugc">web root</a>, further ensuring that only those you authorize have access to your work.</p>
<p><strong>Customization</strong> – WP Document Revisions recognizes that no two teams are identical, and as a result, molds to your firm’s needs, not the other way around. Need to track additional information associated with a document? Departments, editors, issues, sections, even arbitrary key-value pairs — whatever you can throw at it, it can handle. Development and customization costs are further minimized by its extensive plugin API, and the <a href="http://themergency.com/generators/wordpress-custom-taxonomy/" rel="nofollow ugc">WordPress Custom Taxonomy Generator</a> makes it easy for even the uninitiated to add custom taxonomies to documents. Need an audit trail to track check-ins and check-outs? User-level permissions based on the document’s state or another custom taxonomy? Support for third-party encryption? Check out the <a href="https://github.com/wp-document-revisions/wp-document-revisions-Code-Cookbook" rel="nofollow ugc">WP Document Revisions Code Cookbook</a> for sample code. Looking for even more advanced control of your workflow? WP Document Revisions will detect the popular workflow plugin <a href="http://editflow.org" rel="nofollow ugc">Edit Flow</a>, if installed, and will automatically pull <a href="http://ben.balter.com/2011/10/24/advanced-workflow-management-tools-for-wp-document-revisions/" rel="nofollow ugc">Edit Flow’s advanced workflow management tools</a> into WP Document Revisions. Simply put, virtually every aspect of the plugin’s functionality from workflow states to user-level permissions can be fully customized to your team’s unique needs.</p>
<p><strong>Future Proof</strong> – Switching costs a concern? WP Document Revisions is built with tomorrow’s uncertainty in mind. Equally at home in an in-house server room as it is in the cloud, moving individual files or entire document repositories in and out of WP Document Revisions is a breeze (history and all). And since the software is open-source, you can easily add tools to automate the process of moving to or integrating with future third-party systems.</p>
<h4>Features</h4>
<ul>
<li>Support for any file type (docs, spreadsheets, images, PDFs — anything!)</li>
<li>Securely stores unlimited revisions of your business’s essential files</li>
<li>Provides a full file history in the form of a revision log, accessible via RSS</li>
<li>Helps you track and organize documents as they move through your organization’s existing workflow</li>
<li>Each file gets a permanent, authenticated URL that always points to the latest version</li>
<li>Each revision gets its own unique url (e.g.,TPS-Report-revision-3.doc) accessible only to those you deem</li>
<li>Files are intuitively checked out and locked to prevent revisions from colliding</li>
<li>Toggle documents between public, private, and password protected with a single mouse click</li>
<li>Runs in-house or in the cloud</li>
<li>Secure: filenames are hashed on upload and files are only accessible through WordPress’s proven authentication system</li>
<li>Can move document upload folder to location outside of web root to further ensure government- and enterprise-grade security</li>
<li>Documents and Revisions shortcodes, Recently Revised Documents widget</li>
<li>Multisite and Windows (XAMPP) support</li>
<li>Multiple language support including French, Spanish and German (easily translated to your language)</li>
<li>Integration with <a href="https://editflow.org" rel="nofollow ugc">Edit Flow</a>, PublishPress or PublishPress Statuses.</li>
<li>Recently Revised Documents Widget, shortcodes, and templating functions for front-end integration</li>
</ul>
<h4>Features Available via the [Code Cookbook](https://github.com/wp-document-revisions/wp-document-revisions-Code-Cookbook)</h4>
<ul>
<li><strong>Audit Trail</strong> – creates check in / check out audit trail for all documents</li>
<li><strong>Taxonomy-based Permissions</strong> – allows setting user-level permissions based on a custom taxonomy such as department</li>
<li><strong>Third Party Encryption</strong> – example of how to integrate at rest encryption using third-party tools</li>
<li><strong>Rename Documents</strong> – changes all references to “Documents” in the interface to any label of your choosing</li>
<li><strong>State Change Notification</strong> – how to use document api to allow users to receive notification whenever documents change workflow state</li>
<li><strong>Bulk Import</strong> – how to batch import a directory (or other list) of files as documents</li>
<li><strong>Filetype Taxonomy</strong> – Adds support to filter by filetype</li>
<li><strong>Track Changes</strong> – Auto-generates and appends revision summaries for changes to taxonomies, title, and visibility</li>
<li><strong>Change Tracker</strong> – Auto-generates and appends revision summaries for changes to taxonomies, title, and visibility</li>
<li><strong>WPML Support</strong> – Integration with WPML</li>
</ul>
<h3>Security Policy</h3>
<p>To report a security vulnerability, please email <a href="mailto:ben@balter.com" rel="nofollow ugc">ben@balter.com</a>.</p>
<h3>Where to get help or report an issue</h3>
<ul>
<li>For getting started and general documentation, please browse, and feel free to contribute to <a href="https://wp-document-revisions.github.io/wp-document-revisions/" rel="nofollow ugc">the project documentation</a>.</li>
<li>For support questions (“How do I”, “I can’t seem to”, etc.) please search and if not already answered, open a thread in the <a href="https://wordpress.org/support/plugin/wp-document-revisions" rel="ugc">Support Forums</a>.</li>
<li>For technical issues (e.g., to submit a bug or feature request) please search and if not already filed, <a href="https://github.com/wp-document-revisions/wp-document-revisions/issues" rel="nofollow ugc">open an issue on GitHub</a>.</li>
<li>For implementation, and all general questions (“Is it possible to..”, “Has anyone…”), please search, and if not already answered, post a topic to the <a href="https://groups.google.com/forum/#!forum/wp-document-revisions" rel="nofollow ugc">general discussion list serve</a></li>
</ul>
<h3>Things to check before reporting an issue</h3>
<ul>
<li>Are you using the latest version of WordPress?</li>
<li>Are you using the latest version of the plugin?</li>
<li>Does the problem occur even when you deactivate all plugins and use the default theme?</li>
<li>Have you tried deactivating and reactivating the plugin?</li>
<li>Has your issue <a href="https://github.com/wp-document-revisions/wp-document-revisions/issues" rel="nofollow ugc">already been reported</a>?</li>
</ul>
<h3>What to include in an issue</h3>
<ul>
<li>What steps can another user take to recreate the issue?</li>
<li>What is the expected outcome of that action?</li>
<li>What is the actual outcome of that action?</li>
<li>Are there any screenshots or screencasts that may be helpful to include?</li>
<li>Only include one bug per issue. If you have discovered two bugs, please file two issues.</li>
</ul>
<h3>Links</h3>
<ul>
<li><strong><a href="https://github.com/wp-document-revisions/wp-document-revisions/" rel="nofollow ugc">Source Code</a></strong> (GitHub)</li>
<li><strong><a href="https://github.com/wp-document-revisions/wp-document-revisions/releases/latest" rel="nofollow ugc">Latest Release</a></strong> – Download the newest version</li>
<li><strong><a href="https://wordpress.org/plugins/wp-document-revisions/" rel="ugc">WordPress.org Plugin Page</a></strong> – Official plugin listing</li>
<li><strong><a href="https://github.com/wp-document-revisions/wp-document-revisions/tree/develop" rel="nofollow ugc">Development Version</a></strong> (<a href="https://github.com/wp-document-revisions/wp-document-revisions/actions/workflows/ci.yml" rel="nofollow ugc">CI Status</a>)</li>
<li><strong><a href="https://github.com/wp-document-revisions/wp-document-revisions-Code-Cookbook" rel="nofollow ugc">Code Cookbook</a></strong> – Code examples and customizations</li>
<li><strong><a href="https://crowdin.com/project/wordpress-document-revisions" rel="nofollow ugc">Translations</a></strong> (Crowdin)</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/SUPPORT/" rel="nofollow ugc">Where to get Support or Report an Issue</a></strong> – Get help when you need it</li>
<li><strong><a href="https://wp-document-revisions.github.io/wp-document-revisions/CONTRIBUTING/" rel="nofollow ugc">How to Contribute</a></strong> – Join our community</li>
</ul>
<h3>Translations</h3>
<p>Interested in translating WP Document Revisions? You can do so <a href="https://crowdin.com/project/wordpress-document-revisions" rel="nofollow ugc">via Crowdin</a>, or by submitting a pull request.</p>
<ul>
<li>French – <a href="http://omnimaki.com/" rel="nofollow ugc">Hubert CAMPAN</a></li>
<li>Spanish – <a href="https://www.ibidemgroup.com" rel="nofollow ugc">IBIDEM GROUP</a>, <a href="http://www.tradiart.com/" rel="nofollow ugc">TradiArt</a>, and <a href="http://www.labitacoradeltigre.com" rel="nofollow ugc">elarequi</a></li>
<li>Norwegian – Daniel Haugen</li>
<li>German –<a href="http://en.wp.obenland.it/" rel="nofollow ugc">Konstantin Obenland</a></li>
<li>Chinese – Tim Ren</li>
<li>Swedish – Daniel Kroon, <a href="http://www.examinare.biz/" rel="nofollow ugc">Examinare AB</a>, Sweden.</li>
<li>Czech – Hynek Šťavík</li>
<li>Italian – @guterboit</li>
<li>Russian – Evgeny Vlasov</li>
<li>Dutch – @tijscruysen</li>
</ul>
<h3>Useful plugins and tools</h3>
<h4>Permissions management</h4>
<ul>
<li>
<p><a href="https://wordpress.org/plugins/members/" rel="ugc">Members – Membership & User Role Editor Plugin</a></p>
<p>(Previously called Members)</p>
</li>
</ul>
<h4>Taxonomy management</h4>
<ul>
<li><a href="https://wordpress.org/plugins/simple-taxonomy-refreshed/" rel="ugc">Simple Taxonomy Refreshed</a></li>
</ul>
<h4>Email notification and distribution</h4>
<ul>
<li><a href="https://wordpress.org/plugins/email-notice-wp-document-revisions/" rel="ugc">Email Notice for WP Document Revisions</a></li>
</ul>
<h4>Document workflow management</h4>
<ul>
<li><a href="https://wordpress.org/plugins/edit-flow/" rel="ugc">Edit Flow</a></li>
<li><a href="https://wordpress.org/plugins/publishpress-statuses/" rel="ugc">PublishPress Statuses</a></li>
<li><a href="https://wordpress.org/plugins/publishpress-revisions/" rel="ugc">PublishPress Revisions</a></li>
</ul>
<h3>Security</h3>
<ul>
<li>Fix CVE-2025-68585: Add missing authorization check to update_post_slug_field by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/429</li>
</ul>
<h3>Bug fixes</h3>
<ul>
<li>Address Link Date field issue #389 by @NeilWJames in https://github.com/wp-document-revisions/wp-document-revisions/pull/390</li>
<li>Address #414 – Bug on upload, Cannot read properties of undefined by @NeilWJames in https://github.com/wp-document-revisions/wp-document-revisions/pull/417</li>
</ul>
<h3>Developer fixes</h3>
<ul>
<li>Fix PHPDoc tags: Replace non-standard @returns with @return by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/394</li>
<li>Improve test suite with better assertions, edge cases, and utility coverage by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/392</li>
<li>Optimize performance: reduce database queries and regex operations by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/402</li>
<li>Fix: Regenerate minified JS files and prevent Prettier from formatting them by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/404</li>
<li>Add comprehensive front-end JavaScript test suite by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/410</li>
<li>Small corrections by @NeilWJames in https://github.com/wp-document-revisions/wp-document-revisions/pull/408</li>
<li>Replace PHPUnit string assertions with strpos-based alternatives for compatibility by @Copilot in https://github.com/wp-document-revisions/wp-document-revisions/pull/434</li>
</ul>
<p><strong>Full Changelog</strong>: https://github.com/wp-document-revisions/wp-document-revisions/compare/3.7.2…v3.8.0</p>
<h4>3.7.2</h4>
<p>Correct plugin metadata (no code changes).</p>
<h4>3.7.1</h4>
<p>For complete changelog, see <a href="https://wp-document-revisions.github.io/wp-document-revisions/changelog/" rel="nofollow ugc">GitHub</a></p>


WP Document Revisions

Ben Balter has put together a solid plugin that does a good job of maintaining documents for your WP install.  The plugin works well, and functions as described.  The plugin also has filter and action hooks which allow developers to integrate with the plugin without hacking it. It is also translation ready, something that a plugin must have for wide adoption.  A five star plugin must be not only usable but flexible.  WP Document Revisions meets that qualification.

I hope Ben continues his ongoing development.  It's good to see WP coding standards being implemented.  Would be good to see more inline documentation for hooks, but that doesn't affect functionality at all so it's more of a want than a need.

This is a good plugin with some good features.  Unfortunately, there are some very old reviews that don't paint an accurate picture.  Anytime you read a review, look at its age and compare that to the plugin (or theme's) current development.  In this case, there has been active development in the time since some of the older reviews were written (and in my opinion, some of those other reviews are simply not justified).

A useful and flexible tool

A document management and version control plugin for WordPress that allows teams of any size to collaboratively edit files and manage their workflow.

List Attachments Shortcode vs WP Document Revisions