=== Document Gallery ===
Contributors: dan.rossiter
Tags: attachments, icons, documents, gallery
Requires at least: 2.6
Tested up to: 3.5
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

This plugin allows the user to easily create a "gallery" of all non-image attachments on a given post/page,
making them easy to share.

== Description ==

This plugin allows the user to effortlessly include a gallery, much like a photo gallery,
of all your non-image attachments anywhere within your post.

*NOTE: If you find this plugin useful, please take 10 seconds to rate it so others can find it also. Thanks so 
much for your support!*

== Installation ==

1. Upload `document-gallery` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Place `[dg]` in any posts or pages you want a document gallery included. See below for additional display options.

= Document Gallery Options =

In order to include all compatible docuements from a given page or post, you must include 
the following shortcode in the post:

`[dg <descriptions=[true or false]> <orderby=[menu_order, title, date, author, rand]> <order=[ASC or DEC]>]`

**Orderby Options**
* `menu_order` - This is probably the one you want to use. Order by the integer fields in the Insert / 
Upload Media Gallery dialog. Note that these fields may be blank by default. If this is the case, 
you must populate the fields before this option will work.
* `title` - Alphabetical order based on title.
* `date` - Order by date of document upload.
* `author` - Order by the owner of the upload (username).
* `rand` - Pseudo-random order.

By default, document gallery will use `descriptions=false`, `orderby=menu_order`, and `order=ASC` if you
do not specify otherwise.

= Theme Developers =

If you would like to include Document Gallery functionality in your theme, you simply need to include the following
code wherever you would like it to appear: `<?php echo do_shortcode('[dg]'); ?>`. You can include additional options 
(listed above) as needed.

== Screenshots ==

1. This is how the Document Gallery looks with `descriptions=false` (default). Note that the display inherits styling from your active theme.
2. This is how the Document Gallery looks with `descriptions=true`. The descriptions are auto-populated using the description field from when you upload the document.

== Changelog ==

= Coming Soon! =

* Option to include player for any music files uploaded to page.
* Option to open documents directly within your browser (a la [Google Drive Viewer](https://drive.google.com/viewer)).
* Support for adding your own filetypes/icons.
* Whatever else **you** would like (post on the [support forum](http://wordpress.org/support/plugin/document-gallery) if you have ideas)!

= 1.0 =

* Optimized gallery generation (faster!)
* Plugin now has **36 icons** representing **72 filetypes**!
* Added fallback to WordPress default icons if you happen to include one of the few filetypes not yet supported.
* Changed shortcode to `[dg]` (`[document gallery]` will still work for backward compatibility).
* Gave documentation some **much needed** revisions.

= 0.8.5 =

* Added support for [OpenDocuments](http://en.wikipedia.org/wiki/OpenDocument).

= 0.8 =

* First public release of Document Gallery.
* Displays PDF, Word, PowerPoint, Excel, and ZIP documents from a given page or post.
* Documents can be ordered by a number of different factors.