shubhamgupta05 / display-posts-slider

A plugin to create custom short codes

Display Posts Slider

This plugin allows you to fetch posts.

Description

Allows you to fetch posts from the database on the basis of the parameters you passed in the shortcode.

Installation

1. Download the plugin zip file from the given link(https://github.com/ShubhamGupta05/display-posts-slider)

2. Click on Code button and select Download Zip.

3. Once the file gets downlaoded. Go to your site dashboard.

4. Click on the Plugin tab in the left panel.

5. Click on Add New plugin.

6. Click on the Upload Plugin button.

7. Select the file you downloaded and click on Install now.

8. Once the plugin is install. It will ask for the activation.

9. Click on Activating plugin button.

10. Once the plugin is activated. You are ready to use it.

How to use this plugin:

1. Open a page or a post on which you want to display the post.

2. Add the shortcode block to the page or post.

3. In the short code block add this [display-posts-slider posts_per_page=4 post_type='post'] in the shortcode name field.

4. Publish the page or post.

Parameter

List of the parameters that can be passed while calling the shortcode to select the type of posts you want to display in slider:

1. posts_per_page ( Pass the number of posts you want to display. Maximum limit is set to 100)
   (Optional)(Number)
   Example:- [display-posts-slider posts_per_page = 5]
2. post_type ( Pass the post type for which you need the post )
   (Required*)(String)
   Example:- [display-posts-slider post_type = 'post']
3. name ( Pass the name of the post you want to display)
   (Optional)(String)
   Example:- [display-posts-slider name = 'this is my first post']
4. author_name (Pass the name of the author whose post you want to display)
   (Optional)(String)
   Example:- [display-posts-slider author_name = 'Shubham']
5. post_status (Pass the status of the post which you want to display example: published, draft, revision, attachement)
   (Optional)(String)
   Example:- [display-posts-slider post_status = 'published']
6. order (Pass Asc or Desc to display your posts in the order you want)
   (Required)(String)
   Example:- [display-posts-slider order = 'DESC']
7. orderby ( Pass the keyvalue on the basis of which you want to sort you posts)
   (Optional)(String)
   Example:- [display-posts-slider orderby = 'date']
8. post__not_in (Pass post id's to exclude that post)
   (Optional)(Array of Id's)
   Example:- [display-posts-slider post__not_in = 'array(1,2,3)']
9. date_query_after (Pass the date to show the posts created after this date)
   (Optional)(Date format in mm-dd-yy)
   Example:- [display-posts-slider date_query_after = 'September 1st, 2021']
10. date_query_before (Pass the date to show the posts created before this date)
    (Required with the date_query_after parameter)(Date format in mm-dd-yy)
    Example:- [display-posts-slider date_query_after = 'September 1st, 2021' date_query_before = 'September 30th, 2021']
11. date_query_inclusive (Pass the value in true or false to tell whether the exact value should be matched or not)
    (Required with the date_query_after parameter)(Boolean Value)
    Example:- [display-posts-slider date_query_after = 'September 1st, 2021' date_query_before = 'September 30th, 2021' date_query_inclusive = 'true']
12. pagename (Pass the name of the page you wish to display)
    (Optional)(String)
    Example:- [display-posts-slider pagename = 'checkshortcode']
13. search (s) (Pass the value you want to search in the post)
    (optional)(string)
    Example:- [display-posts-slider s = 'this']
14. category_name (Pass the category slug name to show the posts related to this category)
    (Optional)(String)
    Example:- [display-posts-slider category_name = 'mypost']
15. category__not_in (Pass category id's to exclude the posts from these categories)
    (Optional)(Array of category Id's)
    Example:- [display-posts-slider category__not_in = 'array(1,2,3)']
16. tag (Pass the tag slug name to show all the posts related to this tag)
    (Optional)(String)
    Example:- [display-posts-slider tag = 'action']
17. tag__not_in (Pass tag id's to exclude the posts having that tags)
    (Optional)(Array of tag Id's)
    Example:- [display-posts-slider tag__not_in = 'array(1,2,3)']
18. comment_count (Pass the value to see the posts having this much number of commets )
    (Optional)(Number)
    Example:- [display-posts-slider comment_count = '2']
19. tax_query_taxonomy (Pass the name of the custom taxonomy from which you want to display the posts)
    (Optional)(String)
    Example:- [display-posts-slider tax_query_taxonomy = 'movie']
20. tax_query_field (Pass the slug value of the taxonomy added in the tax_query_taxonomy parameter)
    (Required with tax_query_taxonomy)(string)
    Example:- [display-posts-slider tax_query_taxonomy = 'movie' tax_query_field = 'movie']
21. tax_query_terms (Pass the value from the taxonomy terms)
    (Required with the tax_query_taxonomy parameter)(string)
    Example:- [display-posts-slider tax_query_taxonomy = 'movie' tax_query_field = 'movie' tax_query_field = 'action']
22. meta_key (Pass string value)
    (Optional)(String)
    Example:- [display-posts-slider meta_key = 'price']
23. meta_value_num ( Works in conjuntion with orderby)
    (Required with meta_key parameter)(String)
    Example:- [display-posts-slider meta_key = 'price' meta_value_num = 100]
24. meta_compare ( Pass compare key such as “>” “<” “!=” etc while comparing two or more meta value)
    (Required with meta_key & meta_value_num parameter)(String)
    Example:- [display-posts-slider meta_key = 'price' meta_value_num = 100 meta_compare = '>']
25. post_mime_type ( Pass the Type of Attachment which you wish to show)
    (Optional)(String)
    Example:- [display-posts-slider post_mime_type = 'array('jpg','png','gif')']

List of the parameters that can be passed while calling the shortcode to select the options you want to display in your slider:

1. slideShow ( Will set the number of slides to be display on screen ).
2. slideToScroll (Will set the number of slides you can scroll in one click).
3. speed ( Will help you to set the sliding speed 1000 = 1 second)
4. isAuto ( Will help you to set the autoplay setting) (Value will be true or false)
5. isLoop ( Will help you to set the infinite loop to the slider)(Value will be true or false)
6. prev ( Will help you to select the previous button selector )
7. next ( will help you to select the next button selector )
8. auto ( Will help you to set the autoplay button selector )
9. playClass (Will set play class on autoplay button )
10. pauseClass ( Will set the pause class on autoplay button)

Warning

If no parameters are passed to a shortcode, it will fetch posts according to the default parameters given.