=== Recent Posts Shortcode & Widget ===
Contributors: rajros
Donate link: https://rahul841984.wixsite.com/rajros
Tags: recent posts, shortcode, recent posts shortcode, recent posts widget, excerpt, widgets, featured image, taxonomy, widget, sidebar,  category, thumbnail, meta key, post tag, post type
Requires at least: 3.3
Tested up to: 4.7.3
Stable tag: 1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


Display list of posts using the [recentposts-sc] shortcode in pages or in sidebar widgets


== Description ==
The "Recent Posts Shortcode & Widget" helps users to easily display latest posts in a page or in sidebar by just using simple shortcode [recentposts-sc].

= Options and Features Includes =

*  Featured Image
*  Auto generates and adds featured image using first image of the post if no featured image is found.
*  Custom excerpt length
*  Limit number of posts
*  Posts from specific category
*  Posts from multiple categories (comma separated)
*  Posts from specific author
*  Post type option
*  Order/Display by date, name etc.
*  Display post date.
*  Display specific posts using post IDS (comma separated)
*  Display/filter posts by tag
*  Display/filter posts by meta key and meta values
*  Custom "Read more" label option.


= How to Use =

*  Basic: [recentposts-sc] (by default 3 latest posts)
*  For sidebar also use [recentposts-sc] in text widgets 
(refer screenshots as well for further help)

Advanced Parameters:

* numberofposts * 
Limit/Specify the number of posts you want to display
Default: 3
Example: [recentposts-sc numberofposts="6"]


* Post Type * 
Specify which post type you want to use. For example posts or pages
Default type: post
Example: [recentposts-sc post_type="page"]


* Category Name * 
If you want to display category name in list of posts
Default: False
Example: [recentposts-sc get_cat_name="true"]


* Custom Excerpt Length * 
Define custom excerpt length
Example: [recentposts-sc excerptlength="30"]


* Posts from Category/categories * 
Filter posts from single category or multiple categories
Example single category: [recentposts-sc category="lesson"]
Example multiple categories: [recentposts-sc category="lesson,lesson2,lesson3"]


* Posts from specific author * 
Filter posts from specific author
Example: [recentposts-sc author="admin"]


More Parameters/Shortcodes can be seen in FAQ: 
*  [FAQ](https://wordpress.org/plugins/recent-posts-shortcode-widget/faq/).

= Support =

*  [Forum support](https://wordpress.org/support/plugin/recent-posts-shortcode-widget)
*  [Rate/Review the plugin](http://wordpress.org/support/view/plugin-reviews/recent-posts-shortcode-widget)

> Developed by rajros


== Installation ==

* * Installing via Wordpress Dashboard * * 

1. Log in to WordPress admin panel and go to Plugins -> Add New
2. Type 'Recent Posts Shortcode & Widget' in the search box and click on search button.
3. From the search results find 'Recent Posts Shortcode & Widget' plugin.
4. Click on "Install Now"
5. Once installed click on "activate" button/link to activate the plugin.
6. Add the shortcode [recentposts-sc] to a page/post or in text widget for sidebar.

* * Installing the plugin via FTP * * 

1. Download the plugin from the wordpress plugin page.
2. Unzip the plugin and upload "recentpostssc" folder into your plugins directory.
4. Log in to WordPress admin panel and click the Plugins menu.
5. From the list of plugins on the plugin page find "Recent Posts Shortcode & Widget" plugin and then click to activate the plugin.
6. Add the shortcode [recentposts-sc] to a page/post or in text widget for sidebar.


== Frequently Asked Questions ==

* Custom label for "Read More" * 
Apply your own custom read more label
Example: [recentposts-sc excerpt_more="true" label="Keep Reading..."]


* Filter Posts between specific dates * 
Example : [recentposts-sc after="January 5th, 2015"]
This will display only posts which is published after Januray 5th, 2015

Example : [recentposts-sc before="October 6th, 2015"]
This will display only posts which is published before Januray 5th, 2015

Example : [recentposts-sc after="January 5th, 2015" before="October 6th, 2015"]
This will display only posts which is published between Januray 5th, 2015 and October 6th, 2015


* Display author name and link * 
Example: [recentposts-sc include_author="true"]


* Order posts by name, title, date etc * 
Example: [recentposts-sc orderby="name"]


* Order posts in ascending or descending order * 
Example: [recentposts-sc order="DSC"]


* List only specific posts by their IDs * 
Example: [recentposts-sc post_ids="181,189,194"]


* Offset/skip posts * 
Example: [recentposts-sc offset="1"]


* Filter posts containing specific tags only * 
Example: [recentposts-sc tag="lesson1,lesson2,lesson"]

* Filter posts on meta_key * 
Example: [recentposts-sc meta_key="size"]

* Filter posts by meta values * 
Example: [recentposts-sc meta_value="small, medium"]



* *  Combination of several parameters: * * 
[recentposts-sc numberofposts="7" post_type="post" get_cat_name="true" category="lesson" author="admin" excerpt_more="true" label="Read More..." after="January 5th, 2015" before="October 6th, 2015"  include_author="true" orderby="name" order="DSC"  excerptlength=30 post_ids="181,189,194" offset="0" tag="lesson1,lesson2,lesson" meta_key="size" meta_value="small, medium"]


== Screenshots ==

1. This displays list of posts on a page
2. This displays list of posts in sidebar/widgets
3. Basic shortcode to display posts
4. Shortcodes with multiple options/filter like category, date, excerpt length etc
5. For displaying in sidebar

== Changelog ==

**Version 1.2**

* Fixed display issue in sidebar 


**Version 1.1**

* This version is first release of the plugin.