=== Posts Data Table ===
Contributors: andykeith, barn2media
Donate link: http://barn2.co.uk
Tags: posts, table, tables, shortcode, sort, wpml
Requires at least: 3.0.1
Tested up to: 4.4.1
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A simple plugin to display all your posts in a searchable & sortable data table.

== Description ==

Posts Data Table provides an easy way to list all of your site's posts in a searchable, sortable and filterable table. 
Simply add the shortcode `[posts_data_table]` to any page. 

It uses the [jQuery DataTables](http://datatables.net/) plugin to provide the searching and sorting features, as well as pagination and 
responsive layouts for smaller screens. 

It's compatible with WPML, which means (if you use WPML) that the posts shown will be for the current language only. 

Translations currently provided for French, Spanish and German (more to follow).

There are a few options available with the shortcode:

*   `columns` - the columns you'd like to include in the table. Can be any of the following as a comma-separated list: 
id, title, content, category, author, and date. Defaults to 'title,content,date,author,category'
*   `rows_per_page` - the number of posts to show on each page of results in the table. Defaults to 20 rows. Set to 'false' to disable pagination.
*   `sort_by` - the column to sort by. Defaults to 'date'. If the column you want to sort by isn't shown in the table, it will be added as a hidden column.
This means, for example, that you can sort by date without actually showing the date column.
*   `sort_order` - whether to sort ascending ('asc') or descending ('desc'). If you order by date, it will default to 'desc' (newest posts first).
*   `search_on_click` - whether to enable automatic searching for categories and authors when clicking on links in the table. Defaults to 'true'.
*   `wrap` - whether the table content wraps onto more than one. Set to 'false' (the default) to keep everything on one line, or 'true' to allow the content to wrap.
*   `content_length` - the number of words of post content to show in the table (if you've included the 'content' column). Defaults to 20 words.
*   `scroll_offset` - advanced: the table scrolls back to the top each time you navigate forward or backwards through the list of posts. This  
value controls the 'offset' for the scroll. For example, if your site uses a sticky header you can adjust the scroll amount here to compensate. 
Set to 'false' to disable the scroll to top feature.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/posts-data-table` directory, or install the plugin through the WordPress plugins screen directly.
1. Activate the plugin through the 'Plugins' screen in WordPress
1. Add the shortcode `[posts_data_table]` to any page

== Frequently Asked Questions ==

To be added...

== Screenshots ==

1. Posts sorted by date and with wrapping disabled (default). Content and categories are collapsed automatically in order to fit data on single line.
2. Same again but with second post expanded to show full data.
3. With different columns selected and wrapping enabled.

== Changelog ==

= 1.0 =
Initial release.