=== W4 Post List ===
Contributors: sajib1223
Tags: post, post list, custom post list, custom post type, widget, shortcode, media
Requires at least: 4.0
Tested up to: 4.9.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

W4 Post List lets you create a list of posts, terms, users or a combined one. Decorate output using shortcodes. It's just easy and fun.


== Description ==

Display Posts (any custom post type), Terms (any custom taxonomy), Users (any role) on Content or Widget Areas by placing a shortcode. Select what to show and design how to show it. Using the plugin is really easy. You will find Tinymce button on post/page editor to quickly inset a list. Also, there's a separate page for creating or editing list. 

= List Types =
* Posts 
* Terms
* Users
* Terms & Posts
* Users & Posts

Creating a list is just few steps. There are different sets option for different List Type, following options are available for List Type - `posts`. 
= Posts =
* post type 
* post mime type
* post status
* post search keyword
* include post by ids
* exclude post by ids
* exclude current post
* posts per page - while using pagination
* post by parent ids
* post by author ids
* post by terms ( tax_query )
* post by meta ( meta_query )
* post by year, month, day ( date_query )

= Group Results by =
* year
* month
* month year
* category, post tag or custom taxonomies
* authors
* parents

= Order Results by =
* post id
* post title
* post name
* post publish date
* post modified date
* menu order
* approved comment count
* meta value
* or random

= Multi-Page Pagination by =
* Next / Previous links
* Numeric navigation flat - Ex: 1, 2, 3.
* Numeric navigation showing in unordered list. 
* Enable/Disable pagination by ajax


= Creating Template =
Templates are designed using Shortcodes. You can create a simple list just showing post title and linked to the post page, or you can display complex list using any of the information relating to post. Some of the available shortcodes are - 

* post thumbnail
* post categories
* post tags
* post custom taxonomy terms
* post author name / links / avatar
* post publish time
* post modified time
* post excerpt
* post content
* post meta value (multiple times, with multiple meta keys)
* media thumbnail


Check all of the available shortcodes on [W4 Post List Plugin Page](http://w4dev.com/plugins/w4-post-list).


= Check Example =
* [Football Team Showcase](http://w4dev.com/wp/w4-post-list#w4pl-list-07081c7dd0982d2f4a7de78ce2398e8b)
* [Posts in Table](http://w4dev.com/wp/w4-post-list#w4pl-list-a4aad4240af859f0fb3c8b2bfaf56806)
* [Simple Posts List](http://w4dev.com/wp/w4-post-list-examples#example-1)
* [Media List](http://w4dev.com/wp/w4-post-list-examples#example-2)
* [Year/Month Archive](http://w4dev.com/wp/w4-post-list-examples#example-3)
* [List of Categories](http://w4dev.com/wp/w4-post-list-examples#example-4)
* [List of Terms](http://w4dev.com/wp/w4-post-list-examples#example-5)


= Translations =
* Serbian by [Ogi Djuraskovic](http://firstsiteguide.com/)


Happy using this Plugin ? Please rate !!


== Installation ==

1. Upload zip to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Find W4 post list menu under Posts Menu. Add and manage post list from there.
4. User shortcode [postlist] with id, or copy shortcode from the config page.



== Frequently Asked Questions ==

Please ask any question regarding the plugin - <a href="http://wordpress.org/support/plugin/w4-post-list">here</a>.

If you find this plugin useful, please add your <a href="http://wordpress.org/support/view/plugin-reviews/w4-post-list">review</a>.


== Screenshots ==

1. Config Panel
2. Preview 1
3. Preview 2

== Changelog ==
= 2.1.2 =
* Fixed: Post title attribute on [title] template tag
= 2.1.1 =
* New: Query Posts by current user. Use 0 in the Post author field to indicate current user. Ex: 0,12,32 or just 0.
= 2.1 =
* Fix: Now one list can be loaded multiple times.
= 2.0.8 =
* Date Query: Multiple date query filters
* New: Shortcode [post_type], [post_type_label], [post_status], [post_status_label]
= 2.0.7 =
* Fixes: PHP5 compatibility
* New: Shortcode [post_name] - strange, it wasn't there already.
= 2.0.6 =
* New: Now shortcode can be used with list slug (post_name) or list title (post_title). [postlist slug="a-slug"]
* New: Shortcode [post_thumbnail] has new attribute to allow placeholder image if thumbnail wasn't set for a post.
= 2.0.5 =
* New: Use shortcode [user_avatar] to display users avatar.
* Fix: User meta wasn't working at all earlier, just made it to work.
= 2.0.4 =
* New: Display Post term names or slugs in plain text mode rather than link (https://wordpress.org/support/topic/feature-request-289)
= 2.0.3 =
* New: Meta Query with dynamic DATE value (https://wordpress.org/support/topic/meta-query-need-help-with-dynamic-value)
= 2.0.2 =
* Fix: Finally the pagination issue is fixed.
= 2.0.1 =
* New: Order posts by provided post ids
* Fix: Multisite pagination issue fixed (https://wordpress.org/support/topic/nav-typeplain-not-working-in-multisite)
= 2.0 =
* New: Display child post associated with current post
= 1.9.9.9 =
* New: Serbian Language
= 1.9.9.8 =
* New: Implementing Translations
= 1.9.9.7 =
* New: Now you can group posts by custom field (meta_value).
= 1.9.9.6 =
* New: Now you can group posts by modified (year/month) time
= 1.9.9.5 =
* Improved: if meta value is an array/object, display specific value by using a sub_key. ex: [post_meta meta_key="_wp_attachment_metadata" sub_key="file"]
= 1.9.9.4 =
* New: Implemented Date Query. Now you can filter posts by year, month and date
= 1.9.9.3 =
* New: class attribute for [post_thumbnail], [post_image] & [attachment_thumbnail] shortcodes
* New: use [post_thumbnail] & [attachment_thumbnail] shortcode as a fallback for the [post_image] shortcode, use [post_image use_fallbacks=1] to activate
= 1.9.9.2 =
* Fixed: Admin error.
= 1.9.9 =
* New: Select multiple post types at once.
= 1.9.8 =
* Fixed: Terms will be ordered by the provided term ids if exists
= 1.9.7 =
* New: Filter terms by parents
= 1.9.6 =
* Improvement: Set Previous and Next button text for pagination, ex: [nav prev_text="Before" next_text="After"] change the button text with Before & After.
= 1.9.5 =
* Improvement: Included characters limit for post title, ex: [post_title charlimit=10] will output only the 10 characters of post title
= 1.9.4 =
* New: No items found - Display text when not posts/terms/users are found by the query
= 1.9.3 =
* New: Presets - Create list fast using a predefined options/template/style.
= 1.9.2 =
* Fix: RTL language Control Panel Layout fixed.
= 1.9.1 =
* New: Use shortcode [post_image] to display image from post content. ex: [post_image position='last'] to display the last image.
= 1.9 =
* New: Filter Posts by Search Keyword

= 1.8.9 =
* Improvement: Use shortcode [attachment_thumbnail] to display thumbnail from post meta value. ex: [attachment_thumbnail meta_key='attachment_id']
= 1.8.8 =
* Shortcode: New Shortcode included [post_author_meta] to display available meta information of post author.
= 1.8.6 =
* Improvement: Internal Fragement Update
= 1.8.5 =
* Improvement: Included List Type label on Admin List Table
* Removed: List date from Admin List Table
= 1.8.4 =
* Fix: Using offset and pagination on posts list
= 1.8.3 =
* Fix: Strip Tags only used on Post Excerpt upon exceeding limitation
= 1.8.2 =
* Improvement: Minor Improvement
= 1.8.1 =
* Fixed: Template Error While using Post Group
= 1.8 =
* New: Users List
* New: Users + Posts List
* New: Exclude Current Post
* New: Shortcode: [parent_link] Parent link of a post or media file
* New: Shortcode: [post_the_date] Unique post date, ignored on current item if previous post date and curent post date is same
* Fixed: Empty list display

= 1.7.9 =
* Fixed: Meta Query & tax query issue
= 1.7.8 =
* New: Category List
* New: Category Posts List
* Fixed: Post thumnail source using size - [post_thumbnail return="src" size="thumbnail"]
= 1.7.7 =
* Fixed: Multiple List Issue Bug Fixed
= 1.7.5 =
* Improved: Options form
= 1.7.4 =
* Improved: Options form
= 1.7.3 =
* Improved: List options page
* Improved: List options shortcodes
= 1.7.2 =
* Fixed: [Post meta error](http://wordpress.org/support/topic/display-image-from-upload-metafield?replies=6#post-5599026) bug.
= 1.7.1 =
* Fixed: Ajax pagination issue.
* Improved: Template input field.
= 1.7 =
* Introducing: Tinymce button. Now, create a post list right from the post/page edit screen. That means more Independence !!!

= 1.6.9 =
* Improved: Tax Query selection has been improved.
= 1.6.8 =
* Improved: Meta Query selection has been improved.
= 1.6.7 =
* New: Filter by post format
= 1.6.6 =
* New: Meta query feature. Do query by multiple meta key/value with comparement
= 1.6.5 =
* New: Post author email shortcode
* New: Post item number shrtcode
* New: Copy list shortcode directly from the lists table page
= 1.6.4 =
* New: Group posts by parent, author, categories, tags, year, month, year month.
* New: Shortcodes to display group information.
= 1.6.3 =
* New: Added shortcode button to insert shortcode quickly, similar as tinymce button
= 1.6.1 =
* New: Added loading state upon changing post type on options page
= 1.6 =
* New / Clean Option Panel
* A Lot more shortcodes
* Add Css and JS for specific list

= 1.5.7 =
* Template Tag Changed.
= 1.5.6 =
* Important Updates.
= 1.5.5 =
* Manage How to select the post image. Lots of options.
= 1.5.4 =
* Include Post Thumbnail/Image in the list.
= 1.5.3 =
* Category Post selection problem fixed.
= 1.5.1 =
* Post Comment Count and Comment url tag added.
* Fixed Html Template input issue.
= 1.5 =
* Stable Version
= 1.4.6 =
* A lot more template tag to arrange your post list with more flexibility.
= 1.4.5 =
* The show future posts bug has been solved. From now on, there won't be any selection problems.
* Sliding JavaScript has been updated to match the latest jQuery.
= 1.4 =
* Its been a total change in this version. New Management page added for Admins to assign capability for creating/managing post list. If a user has role to only create and manage his own list, he won't be able to see/edit/delete the rest of post list option page.
* Post list database management process. Admin can drop or install the plugin database on click. People are recommended to do removal and install old database once if they have upgraded to v.1.4 from a old once. When database table is dropped, plugin keeps the old data and prompt for synchronize it once after installation of plugin database table. Only admin can have this feature.
* Shortcode Template. Design list using shortcodes and HTML. [Check examples here](http://w4dev.com/wp/w4-post-list-examples)
= 1.3.6 =
* List only posts by category.
* Show/Not show future posts.
* Post lists with maximum posts to show.
* One click select/deselect all posts.
= 1.3.4 =
* Option Saving Bug fixed
= 1.3.3 =
* Read more link after content.
* Jquery effects to manage the list option more easily.
* Changed post order by to an easier method.
* A new "post select by" option.
= 1.3.2 =
* Easier post sorting options.
= 1.3.1 =
* Changed parameter to easily understand options. Please deactivate and reactive plugin after update if you face any problem.
* Added template tag to show a specific post list at any place of your theme.
= 1.3 =
* Show list also on inside post content, page content.
= 1.2.7 =
* Enabled multi-lingual functionality.
= 1.2.5 =
* Show/hide post list with Sliding effect while showing posts with category
* Bug Fixed.
* Added new option to show last post-modified time.
= 1.2.4 =
* Fixed post list bugs.
= 1.2.3 =
* Changed the posts selection method.
* Changed the preview style.
= 1.2.2 =
* Changed past preview style. Update for using new listing style.
= 1.2.1 =
* Please update to Version 1.2.1 which fixed the category selection bugs from widget page
= 1.2 =
* Please update to Version 1.2 for showing the actual excerpt length and removing it from other contents.
= 1.1 =
* Please update to 1.1, to avoid the simple category count bug and enjoy the multi widget functionality.
= 1.0 =


== Upgrade Notice ==
= 2.1.1 =
* New: Query Posts by current user. Use 0 in the Post author field to indicate current user. Ex: 0,12,32 or just 0.
= 2.1 =
* Fix: Now one list can be loaded multiple times, it means list can be duplicated.
= 2.0.8 =
* Date Query: Multiple date query filters
* New: Shortcode [post_type], [post_type_label], [post_status], [post_status_label]
= 2.0.6 =
* New: Now shortcode can be used with list slug (post_name) or list title (post_title). [postlist slug="a-slug"]
* New: Shortcode [post_thumbnail] has new attribute to allow placeholder image if thumbnail wasn't set for a post.
= 2.0.5 =
* Fix: User meta wasn't working at all earlier, just made it to work.
= 2.0.2 =
* Fix: Finally the pagination issue is fixed.
= 2.0.1 =
* New: Order posts by provided post ids
* Fix: Multisite pagination issue fixed (https://wordpress.org/support/topic/nav-typeplain-not-working-in-multisite)
= 2.0 =
* New: Display child post associated with current post
= 1.9.9.9 =
* New: Serbian Language
= 1.9.9.8 =
* New: Implementing Translations
= 1.9.9.7 =
* New: Now you can group posts by custom field (meta_value).
= 1.9.9.6 =
* New: Now you can group posts by modified (year/month) time
= 1.9.9.5 =
* Improved: if meta value is an array/object, display specific value by using a sub_key. ex: [post_meta meta_key="_wp_attachment_metadata" sub_key="file"]
= 1.9.9.4 =
* New: Implemented Date Query. Now you can filter posts by year, month and date
= 1.9.9.3 =
* New: class attribute for [post_thumbnail], [post_image] & [attachment_thumbnail] shortcodes
* New: use [post_thumbnail] & [attachment_thumbnail] shortcode as a fallback for the [post_image] shortcode, use [post_image use_fallbacks=1] to activate
= 1.9.9.2 =
* Fixed: Admin error.
= 1.9.9 =
* New: Select multiple post types at once.
= 1.9.8 =
* Fixed: Terms will be ordered by the provided term ids if exists
= 1.9.7 =
* New: Filter terms by parents
= 1.9.6 =
* Improvement: Set Previous and Next button text for pagination, ex: [nav prev_text="Before" next_text="After"] change the button text with Before & After.
= 1.9.5 =
* Improvement: Included characters limit for post title, ex: [post_title charlimit=10] will output only the 10 characters of post title
= 1.9.4 =
* New: No items found - Display text when not posts/terms/users are found by the query
= 1.9.3 =
* New: Presets - Create list fast using a predefined options/template/style.
= 1.9.2 =
* Fix: RTL language Control Panel Layout fixed.
= 1.9.1 =
* New: Use shortcode [post_image] to display image from post content. ex: [post_image position='last'] to display the last image.
= 1.9 =
* New: Filter Posts by Search Keyword
= 1.8.9 =
* Improvement: Use shortcode [attachment_thumbnail] to display thumbnail from post meta value. ex: [attachment_thumbnail meta_key='attachment_id']
= 1.8.8 =
* Shortcode: New Shortcode included [post_author_meta] to display available meta information of post author.
= 1.8.6 =
* Improvement: Internal Fragement Update
= 1.8.5 =
* Improvement: Included List Type label on Admin List Table
* Removed: List date from Admin List Table
= 1.8.4 =
* Fix: Using offset and pagination on posts list
= 1.8.3 =
* Fix: Strip Tags only used on Post Excerpt upon exceeding limitation
= 1.8.2 =
* Improvement: Minor Improvement
= 1.8.1 =
* Fixed: Template Error While using Post Group
= 1.8 =
* New: Users List
* New: User + Post List
* New: Exclude Current Post
* New: Shortcode: [parent_link] Parent link of a post or media file
* Fixed: Empty list display
= 1.7.9 =
* Fixed: Meta Query & tax query issue
= 1.7.8 =
* New: Category List
* New: Category Posts List
* Fixed: Post thumnail source using size - [post_thumbnail return="src" size="thumbnail"]
= 1.7.7 =
* Fixed: Multiple List Issue Bug Fixed
= 1.7.5 =
* Improved: Options form
= 1.7.4 =
* Improved: Options form
= 1.7.3 =
* Improved: List options page
* Improved: List options shortcodes
= 1.7.2 =
* Fixed: [Post meta error](http://wordpress.org/support/topic/display-image-from-upload-metafield?replies=6#post-5599026) bug.
= 1.7.1 =
* Fixed: Ajax pagination issue.
* Improved: Template input field.
= 1.7 =
* Introducing: Tinymce button. Now, create a post list right from the post/page edit screen. That means more Independence !!!
= 1.6.9 =
* Improved: Tax Query selection has been improved, that means more Independence !!!
= 1.6.8 =
* Improved: * Improved: Meta Query selection has been improved.
= 1.6.7 =
* New: Filter by post format
= 1.6.6 =
* New: Meta query feature. Do query by multiple meta key/value with comparement
= 1.6.5 =
* New: Post author email shortcode
* New: Post item number shrtcode
* New: Copy list shortcode directly from the lists table page
= 1.6.4 =
* New: Group posts by parent, author, categories, tags, year, month, year month.
* New: Shortcodes to display group information.
= 1.6.3 =
* New: Added shortcode button to insert shortcode quickly, similar as tinymce button
= 1.6.1 =
* New: Added loading state upon changing post type on options page
= 1.6 =
* New / Clean Option Panel
* A Lot more shortcodes
* Add Css and JS for specific list
* The Category list has been removed. If you think you need that, stick with the older version

= 1.5.7 =
* Template Tag Changed.
= 1.5.6 =
* Important Updates.
= 1.5.5 =
* Manage How to select the post image. Lots of options.
= 1.5.4 =
* Include Post Thumbnail/Image in the list.
= 1.5.3 =
* Category Post selection problem fixed.
= 1.5.1 =
* Post Comment Count and Comment url tag added.
* Fixed Html Template input issue.
= 1.5 =
* Stable Version

= 1.4.6 =
* A lot more template tag to arrange your post list with more flexibility.
= 1.4.5 =
* The show future posts bug has been solved. From now on, there won't be any selection problems.
* Sliding JavaScript has been updated to match the latest jQuery.
= 1.4 =
* Its been a total change in this version. New Management page added for Admins to assign capability for creating/managing post list. If a user has role to only create and manage his own list, he won't be able to see/edit/delete the rest of post list option page.
* Post list database management process. Admin can drop or install the plugin database on click. People are recommended to do removal and install old database once if they have upgraded to v.1.4 from a old once. When database table is dropped, plugin keeps the old data and prompt for synchronize it once after installation of plugin database table. Only admin can have this feature.
* Shortcode Template. Design list using shortcodes and HTML. [Check examples here](http://w4dev.com/wp/w4-post-list-examples)
= 1.3.6 =
* List only posts by category.
* Show/Not show future posts.
* Post lists with maximum posts to show.
* One click select/deselect all posts.
= 1.3.4 =
* Option Saving Bug fixed
= 1.3.3 =
* Read more link after content.
* Jquery effects to manage the list option more easily.
* Changed post order by to an easier method.
* A new "post select by" option.
= 1.3.2 =
* Easier post sorting options.
= 1.3.1 =
* Changed parameter to easily understand options. Please deactivate and reactive plugin after update if you face any problem.
* Added template tag to show a specific post list at any place of your theme.
= 1.3 =
* Show list also on inside post content, page content.
= 1.2.7 =
* Enabled multi-lingual functionality.
= 1.2.5 =
* Show/hide post list with Sliding effect while showing posts with category
* Bug Fixed.
* Added new option to show last post-modified time.
= 1.2.4 =
* Fixed post list bugs.
= 1.2.3 =
* Changed the posts selection method.
* Changed the preview style.
= 1.2.2 =
* Changed past preview style. Update for using new listing style.
= 1.2.1 =
* Please update to Version 1.2.1 which fixed the category selection bugs from widget page
= 1.2 =
* Please update to Version 1.2 for showing the actual excerpt length and removing it from other contents.
= 1.1 =
* Please update to 1.1, to avoid the simple category count bug and enjoy the multi widget functionality.
= 1.0 =