### “Eight Degree Posts List Pro ” Documentation by “8Degree Themes” v1.0.0

# “Eight Degree Posts List Pro ”

Created: 9/11/2017
By: 8Degree Themes
Click for Details
Checkout Demo
Email:support@8degreethemes.com

Thank you for downloading our plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!

## Table of Contents

1. Installing Instructions
2. Controls
3. Main
4. Templates
5. Mobile
6. Pagination
7. Using Shortcode

### A) Installing Instructions - top

### Part I: Installing Eight Degree Posts List Pro via. Admin Dashboard

1. Download a fresh copy of Eight Degree Posts List Pro Plugin from https://codecanyon.net/downloads
2. Go to Dashboard
3. Click on Plugin menu button at admin side panel, then click on Add New
4. Now, click on Upload button which is at top left of plugin page
5. Browse the downloaded zip file of the plugin: [plugins_file].zip
6. Then, click on Install Now
7. After successful installation, click on Activate the plugin

### Part II: Installing Eight Degree Posts List Pro via. Cpanel/FTP

1. Get the latest copy of Eight Degree Posts List Pro Plugin
2. Unzip eight-degree-posts-list.zip file
3. Copy the unzipped file into /wp-content/plugins directory
4. Now, go to admin panel
5. Click on Plugin and then on Installed Plugin
6. Eight Degree Posts List Pro will be listed as installed plugin and then click on Activate
7. Eight Degree Posts List Pro will appear on admin panel after activation.

Once you have successfully installed the plugin, check on the left admin panel for Eight Degree Posts List Pro. Clicking on it will lead you to the plugin backend page.

### B) Create New Settings - top

In the backend settings of the plugin you will find numerous options, that a user can make choices over for generating posts list. All of them are divided into the sections and expalined in the following part of the documentation.

Settings are divided into four sections of setup as,

- Controls
- Main
- Templates
- Mobile
- Pagination

### C) Controls -top

This section is further divided into four sub parts which are listed below:

### Part I: General Section

This section consists of the most general options for querying, which will control the basic output generation for the frontend. Here, altogether four menu options are available which are explained below.

1. Posts Number:

   This input field takes an integer value and it is the number of posts to be displayed at the frontend ,from all available posts within the query. WordPress default value is 5.

2. Order Posts By:

   This select option has following options for listing posts in accordance to,

   - Id
   - Author
   - Date
   - Modified
   - Parent
   - Random
   - Comment Count
   - Menu Order
   - Meta Value
3. Order:

   A user can now choose an ascending or descending order for listing out the posts according to above selected parameter of Order Posts By.

4. Excerpt length:

   This field takes a numeric value as an input. The value given to this field is the number of words to be displayed as the content of the post.

### Part II: Show/Hide Section

This section has options that a user can check or uncheck for hiding or showing the contents for the frontend. Some of them are listed and explained accordingly.

1. Title:

   User can check or uncheck this option in order to hide or show the title of the post.

2. Author:

   User can check or uncheck this option in order to hide or show the author of the post.

3. Date:

   User can check or uncheck this option in order to hide or show the date of the post.

4. Excerpt:

   User can check or uncheck this option in order to hide or show the excerpt of the post.

5. Comment Counts:

   User can check or uncheck this option in order to hide or show the comment count of the post.

6. Image:

   User can check or uncheck this option in order to hide or show the image of the post.

7. Category:

   User can check or uncheck this option in order to hide or show the category of the post.

8. Show Tags:

   User can check or uncheck this option in order to hide or show the tags of the post.

9. Readmore:

   User can check or uncheck this option in order to hide or show the readmore of the post.

### Part III: Social Section

This section of the plugin is related to the social shares and giving previlege to the site visitors to share the posts in their favourite social medias. All available social medias to share posts are listed below.

1. Facebook:

   User can check or uncheck this option in order to hide or show the facebook of the post.

2. Twitter:

   User can check or uncheck this option in order to hide or show the twitter of the post.

3. Pinterest:

   User can check or uncheck this option in order to hide or show the pinterest of the post.

4. Mailto:

   User can check or uncheck this option in order to hide or show the mailto of the post.

5. Google Plus:

   User can check or uncheck this option in order to hide or show the google plus of the post.

6. Linked In

   User can check or uncheck this option in order to hide or show the linked in of the post.

### D) Main -top

### PART I: Query Type

This section consists the types of query, which user can choose for performing WordPress query for generating posts list as per their requirement, that will be the output at the frontend of the site. All available query types are listed below into the sections and are explained simultaneouly.

### Section A: Query By Post Title

This query type is dedicated to the WordPress builtin post type "POST". Also, this query type is most simple way to retrieve desired posts just by choosing the post's title that are listed at the user interface. The listed posts title will appear in the descending order of time, hence user will find the latest post at the top.

User can check or uncheck the post's title as per their necessity and pubilsh the post.

1. Posts available under WordPress builtin post type "POST":

   In this section all of the posts that were posted by all authors will be listed. The listed items are the post's title which are in descending order of date, that is the latest posts are the first.

2. All | Exclude | Include

   This section deals for including or excluding available posts for quering

### Section B: Query With Search Keyword

This section holds querying options for searching posts with a keyword. Both builtin post types and custom registered post types are supported for performing query. Users have to choose the post type and give a search keyword for searching the required posts. All posts matching the keyword will be listed out as post's title and user can choose them in order to list out to the frontend.

1. Post Types:

   This select option lists all available post types to choose for performing query to list posts.

2. Search Bar:

   Here, user can give a keyword to search posts. All posts under the choosen post type with the keyword submitted will be listed as search button is pressed.

3. Search results will appear here

   All available posts with the matched parameters will be listed in this section.

4. Exclude/Include

   In this section, user can choose how to include or exclude posts listed above and generate the result for the frontend.

### Section C: Query By Taxonomy

#### Taxonomy Settings

In Taxonomy Settings, you can choose type of taxonomy for making query before listing out the posts for front end. Available, menu fields in this part of settings are listed below.Eight Degree Posts List Pro pro is a very handy plugin to list out posts. Before actual listing of posts user can choose some of the options as their requirements. In total, this section has five different options which are categorized into four different section of backend setup. All of the options are explained in detail in the following part of the documentation. This part of the menu deals with the taxonomy areas of WordPress. Basically, a user has a capability of making choice of the type of taxonomy to include and retrieve their posts accordingly. Further, this section can be divided into following menu options.

- Category: This menu option will list out all of the saved categories that were created while posts were added under them. Eight Degree Posts List Pro pro has a feature of listing out posts of multiple categories at the same time in a single setup. A user can individually choose categories for retrieving their posts as well.
- Tags: A user can make the query through the non-hierarchical taxonomy terms as well for popping out the required posts. For this, a user has to give the tags' terms into the text field. If the query is to be carried on through multiple tag's terms then they should be separated with a comma.
- Posts Ids: This menu option takes the post's id as input for retrieving the posts with corresponding post id. Also, users can leave this field blank. This option can be used to make strict retrieval of posts through posts ids.
- Posts by Author: WordPress facilitates multiple authors to add posts, and hence Eight Degree Posts List Pro pro has a feature of retrieving posts added by those authors in a collective way or individually too. If an author is selected then the posts posted by the author will only be listed, yet multiple authors can be chosen at once for retrieving their posts.
- Posts Status: This menu has options like publish, pending and draft. These are the status of the posts that were created by the authors. Normally, posts are with a status of published, but for different reasons, they are set in the pending or draft status too. Hence, for facilitating users to retrieve such posts with above-mentioned status this option is provided by the plugin.

### Section D: Query By Post Type

Here, this query type section consists of options related to post types along their registered taxonomy and their terms. All available post's title are listed here. A user can easily choose posts to include or exclude for displaying into the frontend. All available menu options are listed and explained below.

1. Post Type:

   This option is for making choice over the post types for quering posts, for frontend. At default the WordPress builtin post type "POST" is loaded and its corresponding taxonomy along taxonomy terms are listed. All available posts i.e. post's titles are listed here under the taxonomy terms.

2. Taxonomy:Hierachical

   This menu section will list all available heirachical taxonomy and their terms along posts(title) under them. A user can check the post's titles in order to make query, which will later generate required output for the frontend

   For an example a post type "POST" will have hierachical taxonomy as "Category" and might have taxonomy terms as "Category A", "Category B", "Category C" etc and will contain numbers of posts posted under those taxonomy terms.

3. Taxonomy:Non Hierachical

   This part of menu will list all available non heirachical taxonomy and their terms along posts(title) under them. A user can check the post's titles in order to make query, which will later generate required output for the frontend.

   For an example a post type "POST" will have non hierachical taxonomy as "Tag" and might have taxonomy terms as "tag A", "tag B", "tag C" etc and will contain numbers of posts tagged under those taxonomy terms.

4. Operator:

   This menu option comes handy when a post type has both hierachical and non hierachical taxonomy and their terms. User can select "OR" option to include post's that are either in a hierachical or non hierachical taxonomy. Whereas, choosing "AND" operator does query for retrieving posts that are available under both hierachical and non hierachical taxonomy terms.

   For an example, WordPress builtin post type "POST" has hierachical taxonomy term as "Category" and non hierachical taxonomy as "Tag". Choosing "OR" operator will result in output of such posts that are either in "Category" or "Tag" taxonomy, if they were checked at the backend. While if a user chooses "AND" operator query will result such posts which are available under both "Category" or "Tag" , if they were checked at the backend.

   Also, if a post type has only one type of taxonomy either hierachical or non hierachical the operator option will not make any sense. Here, "Query By Post Type" supports WordPress builtin post type "Page" upto some extent. As, this type of post type doesnot has any type of taxonomy, user should check the required pages to show at the frontend. And ,also hide contents like tags, category at the show/hide menu of Control Section .

5. Posts by Author:

   At this menu field a user can choose specific author name to query posts of. Also, multiple author names can be selected to retrieve their posts. This helps in performing author specific query. If user doesn't select any author then all available authors will be included for performing query.

6. Post Status:

   Here, a user can see WordPress provided multiple post status. A user can specify a post status to make a query. Also, multiple posts status can be submitted for performing the query for retrieving posts under such post status. If not selected any option WordPress default post status "Publish" will be submitted for the Query

### Section E: Query With Filter Options

Still query will be performed for the post type without any registered taxonomy and any taxonomy terms.

1. Post Type:

   This menu option under Query With Filter Options will list all available post types , both WordPress builtin and Custom Registered post types. Also, only post types with registered taxonomy are listed here. As taxonomy terms are to be used as filter terms/options/tabs at the frontend , if post type doesn't have any registered taxonomy, they will not be listed here.

2. Filter Taxonomy:

   At this menu section all available taxonomy for above selected post type are listed here as options. Choosing a taxonomy will result all available taxonomy terms under the corresponding taxonomy. Thus, required taxonomy term should be checked in order to make them as filter terms/options/tabs for filtering the posts at the frontend.

3. Exclude/Include:

   Here, user can choose to include or exclude checked or include all without checking any taxonomy terms at above menu option. Actual query is carried out according to post type and its taxonomy and taxonomy terms under them. So, only posts under such parameters are listed at the frontend.

4. Filter Template:

   User can select a template for filter terms/options/tabs for the frontend. Altogether, three templates are available.

### E) Layout and Templates -top

The plugin comes with 30+ Templates, enough to suit any type of site you might be creating. There are total of 5 different Layouts.

1. Grid Layout (10 Templates)
2. Masonry Layout (3 Templates)
3. Carousel Layout (6 Templates)
4. Slider Layout (6 Templates)
5. Magazine Layout (7 Templates)

You can view the demo of each template here.

The plugin does not provide you with color customization options. If you need any assistance you can contact us here.

### F) Mobile -top

We understand the world is switching to a mobile first generation so we have made sure that the the template you choose works on devices of all size. You can set the individual size to templates (Feature available for only Grid, Magazine, Masonry layouts and their templates)

### G) Pagination -top

This plugin uses the Load more one page pagination style with four load more designs and sixteen loader designs.

### H) Using Shortcode - top

Use shortcodes into pages or posts where posts are to be listed out

### Shortcode for pages and posts

This plugin is very easy to setup using shortcodes. For each post settings published under the Eight Degree Posts List Pro pro plugin ,a new shortcode is generated and listed in the EDPL Shortcodes metabox at right side of the plugin's setup page. Such generated shortcode, [edpl post_list_id="686"] can be used by coping and placing it into the posts and pages. Thus the posts will be displayed according to setup at the place where shortcode is placed.

### Shortcode for including into template files

Again, output to frontend can be generated from a template file by embedding shortcode generated by the plugin into it. Just simply, copy code that looks like one below that is listed in metabox to the template file.

<?php echo do_shortcode("[edpl post_list_id='686']"); ?>

Once again, thank you so much for purchasing this plugin. As we said at the beginning, we'd be glad to help you if you have any questions relating to this plugin. No guarantees, but we'll do our best to assist. If you have a more general question relating to the plugin on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.

8Degree Themes

Go To Table of Contents