EkoJR

This tool functions much like a Post List builder to give Admins the most amount of control over managing content to display. Developed with Web Designers & Developers in mind, makes this a highly customizable tool to have around. However, there is a sharp learning curve for most.
You must know:
<ul>
<li>HTML</li>
<li>CSS</li>
<li>(Optional)
<ul>
<li>JavaScript</li>
<li>PHP</li>
</ul>
</li>
</ul>
<h3>Summary</h3>
Advanced Post List (aka APL) is designed to operate much like The Loop in WordPress; which is most notable in Themes. However, that concept is taken and turned into an Admin tool that can easily be changed, moved, or added/removed. This eliminates much of the backend work, and prevents being limited to what is hardcoded into a theme.
This also makes multiple Featured Content with different configurations more of a breeze, and the complexity of it is a challenge that APL achieves unlike any other.
APL can accomplish a large degree of variations, but can be broken down to 3 main types of tasks. With Filter, Design, and Placement, here are some of the key features.
<h3>Filter</h3>
<ul>
<li>Custom Post Type and Taxonomy Support (CPT) – Displays Posts/Pages from custom post types, taxonomies, and terms. This includes other plugins with post data. but may store its data differently than post_content. (Advanced Users, see php_function shortcode.)</li>
<li>Enhanced/Diverse Queries – Capable of diverse filter configuration when displaying posts. This feature allows…
<ul>
<li>Cross Filtering with Custom Post Types.</li>
<li>Diverse Post Types -> Taxonomies query configurations.</li>
<li>Multiple Query configurations with include and require.</li>
</ul>
</li>
<li>Optimized with Complex Queries – Once deemed an Achilles Heel to WP Query, steps are taken to reduce the server load as much as possible.</li>
<li>Dynamic Filters – Grabs values to filter by based on the current posts/pages being viewed. Ex. Displaying Related Posts in a Header, Footer, Sidebar, etc..</li>
<li>Show Content from Published, Private, Future, etc. – This is a development feature and may not provide intended results. Display content on the frontend so users don’t have to navigate to the admin side. Allowing private landing pages to be created. Note: Requires advanced knowledge on how WP Query and User Perms operate.</li>
</ul>
<h3>Design</h3>
<ul>
<li>Layout and Style 99.9% Customizable – There’s nearly no limitations to the design, with some exceptions that may surface with (Child) Theme’s CSS. This does require some knowledge in Web Design. Note: This is NOT to be confused with Drag and Drop UI/UX.</li>
<li>Internal Shortcodes – Adds various data from Post object, and is one of the extensive features. Being able to extend to shortcodes with custom PHP functions make the possibilities practically limitless. <a href="https://support.advancedpostlist.com/doc/internal-shortcodes/" title="List of Internal Shortcodes" rel="nofollow ugc">See full list & details</a>.</li>
<li>Encapsulated for Zero Conflicts – With a large number of shortcodes on any given site. Isolating Internal Shortcodes to its own instance eliminates any plugin conflicts.</li>
<li>Custom Formats to Loop ( The Loop ) – Themes follow this concept, but APL turns that concept into a tool. The “List Content” loop, as well as the before & after, is where most of the work is done with preset HTML, CSS, JS, & PHP designs. It is also optional to set an Empty Message (No Posts Found) to display.</li>
</ul>
<h3>Placement</h3>
<ul>
<li>Post List Shortcode – User friendly method of adding Preset Post Lists to a section of a page.</li>
<li>Sidebar Widget – Easier to use. However, adding post list shortcodes to the text sidebar also produces the same results.</li>
<li>PHP Hardcode – For more extensive design work. There is a public function for displaying Preset Post Lists where WordPress support and functions for admins aren’t fully present.</li>
</ul>
<h3>Other Plugins Tested/Supported</h3>
There’s various plugins that offer a unique capability, and some of which APL can use as intended, but there are also some don’t. Here is a list of popular plugins that have been tested and verified by Advanced Post List.
<ul>
<li>Advanced Custom Fields – Requires php_function shortcode.</li>
<li>WPML – With WordPress Multilingual installed, additional Designs can be created for rendering a Post List in different languages. Posts/Pages are handled automatically and will display content in various languages.</li>
</ul>
APL is open to development requests and welcomes those willing to report on any issues.
<h3>Help & Support</h3>
Currently, information can be found in 2 different locations. This is due to recent changes, and is only temporary.
<ul>
<li><a href="https://support.advancedpostlist.com/getting-started/" title="Getting Started w/ APL" rel="nofollow ugc">Getting Started</a></li>
<li><a href="https://support.advancedpostlist.com/documentation/" title="APL Documentation" rel="nofollow ugc">Documentation</a>
<ul>
<li><a href="https://support.advancedpostlist.com/doc/internal-shortcodes/" title="List of Internal Shortcodes" rel="nofollow ugc">Internal Shortcodes</a></li>
</ul>
</li>
<li><a href="https://github.com/Advanced-Post-List/advanced-post-list/wiki" title="Learn or Contribute to APL" rel="nofollow ugc">GitHub Wiki</a></li>
</ul>
Questions/Bug Report submit thread / ticket at <a href="https://wordpress.org/support/plugin/advanced-post-list" title="WordPress.org - Support for APL" rel="ugc">WordPress</a> or <a href="https://github.com/Advanced-Post-List/advanced-post-list/issues" title="Report an Issue" rel="nofollow ugc">GitHub Issue / Tickets</a>.

Advanced Post List

Very easy to work with and nice and easy to customise

Cracking plugin

Post List builder with highly customizable filter & custom designs. Whether it's displaying Recent Posts, Related Posts, Dynamic Posts, or a  …

Curtiss Grymala

This plugin adds two shortcodes that allow you to display either the content of a post or a list of posts within the content area of a post. This plugin should be fully compatible with all post types, as it simply uses the <code>get_post()</code> and <code>get_posts()</code> WordPress functions.
Post Content
The first shortcode is the <code>[post-content]</code> shortcode. Using that shortcode will allow you to display the content of one post within another post. This shortcode requires a single attribute with a key of “id”. To use this shortcode to display the content of a post or page with an ID of 25, you would use this shortcode like <code>[post-content id=25]</code>. This shortcode also accepts the following optional arguments:
<ul>
<li><code>post_name</code> => <code>null</code> – The slug of the post that you want to pull. This can be used in place of the <code>id</code> attribute</li>
<li><code>show_image</code> => <code>false</code> – Determines whether or not to display the featured image (if so, this appears before the content)</li>
<li><code>show_excerpt</code> => <code>false</code> – Determines whether to default to showing the post excerpt instead of the post content (still falls back to post content if the excerpt is not set)</li>
<li><code>excerpt_length</code> => <code>0</code> – If you would like to limit the length of the content/excerpt shown on the page, specify the maximum number of words that should be shown (a read more link will automatically be appended to any entries that exceed that limit).</li>
<li><code>image_width</code> => <code>0</code> – The width, in pixels, to which the featured image should be sized</li>
<li><code>image_height</code> => <code>0</code> – The height, in pixels, to which the featured image should be sized</li>
<li><code>show_title</code> => <code>false</code> – Whether or not to show the post title at the top of the content. By default, the title is wrapped in <code><h2></code> tags, but you can use the <code>post-content-shortcodes-title</code> filter to modify the title output.</li>
<li><code>link_image</code> => <code>false</code> (set this to true/1 if you would like to wrap the featured image in a link to the post) – Added in 0.6</li>
<li><code>view_template</code> => <code>null</code> (if you are using the <a href="https://wp-types.com/" rel="nofollow ugc">Views</a> plugin, you can set the ID of an existing Content Template to be used in-place of the default list item output) – Added in 0.6</li>
<li><code>shortcodes</code> => <code>false</code> – By default, this plugin strips shortcodes out of the post content/excerpt. If you would like to attempt to process/render shortcodes in the content, set this flag to true.</li>
</ul>
Post List
The second shortcode is the <code>[post-list]</code> shortcode. This shortcode does not require any arguments, but will accept the following arguments (most of which are the default arguments used with <code>get_posts()</code>):
<ul>
<li><code>numberposts</code> => <code>-1</code></li>
<li><code>offset</code> => <code>0</code></li>
<li><code>category</code> => <code>null</code> (can accept category slug [with quotes] or category ID [without quotes])</li>
<li><code>orderby</code> => <code>title</code></li>
<li><code>order</code> => <code>asc</code></li>
<li><code>include</code> => <code>null</code></li>
<li><code>exclude</code> => <code>null</code></li>
<li><code>meta_key</code> => <code>null</code></li>
<li><code>meta_value</code> => <code>null</code></li>
<li><code>post_type</code> => <code>'post'</code></li>
<li><code>post_mime_type</code> => <code>null</code></li>
<li><code>post_parent</code> => <code>null</code></li>
<li><code>post_status</code> => <code>'publish'</code></li>
<li><code>exclude_current</code> => <code>true</code></li>
<li>–blog_id => 0 (the numeric ID of the site from which to pull the posts)–</li>
<li><code>blog</code> => <code>null</code> (can be set to the numeric ID or the blog name [slug] of the site from which to pull the posts – this replaces the old blog_id attribute)</li>
<li><code>show_image</code> => <code>false</code></li>
<li><code>show_excerpt</code> => <code>false</code></li>
<li><code>excerpt_length</code> => <code>0</code></li>
<li><code>image_width</code> => <code>0</code></li>
<li><code>image_height</code> => <code>0</code></li>
<li><code>tax_name</code> => <code>null</code> (the name of a taxonomy – e.g. “tag”, “category”, etc. – to be used to filter the list of posts) – Added in 0.6</li>
<li><code>tax_term</code> => <code>null</code> (the list of term IDs or slugs to filter the list of posts – multiple IDs or slugs can be separated by spaces) – Added in 0.6</li>
<li><code>link_image</code> => <code>false</code> (set this to true/1 if you would like to wrap the featured image in a link to the post) – Added in 0.6</li>
<li><code>ignore_protected</code> => <code>false</code> (set this to true/1 if you would like the post list to exclude any password-protected posts) – Added in 0.6</li>
<li><code>view_template</code> => <code>null</code> (if you are using the <a href="https://wp-types.com/" rel="nofollow ugc">Views</a> plugin, you can set the ID of an existing Content Template to be used in-place of the default list item output) – Added in 0.6</li>
</ul>
The first 13 arguments are standard arguments for the <code>get_posts()</code> function.
The <code>exclude_current</code> argument is not a standard argument for the <code>get_posts()</code> function. It is a custom argument for this plugin. When that argument is set to <code>true</code>, the current page or post will be excluded from the list of posts. If it is set to <code>false</code>, <code>"false"</code> or <code>0</code>, the current page or post will be included in the post list.
The <code>blog_id</code> argument is also not standard. That argument allows you to pull a post from a site other than the current site when using WordPress multisite. Simply set that argument to the ID of the site from which you want to pull the post, and the post with the <code>id</code> you specify will be pulled from the blog/site with the <code>blog_id</code> you specify.
The <code>show_image</code>, <code>image_width</code> and <code>image_height</code> arguments only apply to the <code>post-list</code> shortcode. They determine whether to display the featured image and how to display it for each post within the list. If the <code>image_width</code> and <code>image_height</code> arguments are both set to 0 (which is the default), the “thumbnail” size will be used (assuming the <code>show_image</code> argument is set to 1 or “true”). If only one of the <code>image_width</code> or <code>image_height</code> arguments are set, the other argument will be set to 999999 to ensure that the specified dimension is met.
The <code>show_excerpt</code> and <code>excerpt_length</code> arguments also apply to the post-list shortcode. If you set <code>show_excerpt</code> to 1 or “true”, the post excerpt will be shown if it exists. If it doesn’t exist (or is empty), the post content will be shown (with HTML stripped out of it). You can truncate the length of the excerpts that are shown in the post list by setting the <code>excerpt_length</code> value. The <code>excerpt_length</code> is measured in words, so if you would like each excerpt to display no more than 50 words, you would set the <code>excerpt_length</code> parameter to 50. If you leave it set to 0 (which is the default), the entire excerpt or content will be shown in the post list. In the <code>post-list</code> shortcode, if <code>show_excerpt</code> is set to 0 or false, no content will be shown in the list (as opposed to the behavior of the <code>show_excerpt</code> parameter in the <code>post-content</code> shortcode).
The <code>view_template</code> argument can be a bit complicated to get working properly, and is still a bit experimental. Please use it at your own risk. Unfortunately, the standard [wpv-post-featured-image] and [wpv-post-url] shortcodes (and, by extension, the [wpv-post-link] shortcode) do not work properly, especially when trying to display content from another site in the network. There are three extra shortcodes created for use in your Content Template, the first two of which replace the [wpv-post-featured-image] and [wpv-post-url] shortcodes:
<ul>
<li><code>[pcs-thumbnail]</code> – will output the post thumbnail (at the width/height you set in the post-content/post-list shortcode attributes)</li>
<li><code>[pcs-post-url]</code> – will return/output the URL to the post</li>
<li><code>[pcs-entry-classes]</code> – will add some additional classes to the entry wrapper. Accepts 2 parameters:
<ul>
<li><code>classes</code> – a space-separated list of the CSS classes you want to apply to the entry</li>
<li><code>columns</code> – a numerical value representing how many columns you want in the list (which will automatically add column-1, column-2, etc. to the list of entry classes, as well as adding a class of “first” to the first item in each row – for instance, if you have 6 items, and you use <code>[pcs-entry-classes classes="foo bar entry" columns="3"]</code>, the class list for the first and fourth items will be <code>foo bar entry column-1 first</code>, the class list for the second and fifth items will be <code>foo bar entry column-2</code> and the class list for the third and sixth items will be <code>foo bar entry column-3</code>)</li>
</ul>
</li>
</ul>
I have created a Gist showing a <a href="https://gist.github.com/cgrymala/5e6b7b36d2e8c8eaea33" rel="nofollow ugc">simple example of a Views Content Template used with a Post List widget</a>.
To read more about the other arguments, please <a href="https://codex.wordpress.org/Function_Reference/get_posts" rel="nofollow ugc">visit the codex page for the <code>get_posts()</code> function</a>.
If you are looking to display a list of attachments in a post, rather than displaying a list of posts or pages, you might want to check out the <a href="https://wordpress.org/extend/plugins/list-attachments-shortcode/" rel="ugc">List Attachments Shortcode plugin</a> instead.
Multisite – Pulling Posts From Another Blog
To pull a list of posts from another blog, simply provide the blog’s ID as the <code>blog_id</code> argument in the shortcode. With that argument, this plugin will pull a list of posts that match the other criteria you provided. If the <code>blog_id</code> argument is provided, and the <code>blog_id</code> doesn’t match the ID of the current blog, the <code>exclude_current</code> argument will be ignored (otherwise, this plugin would automatically exclude whatever post on the other blog happens to have the same ID as the current post).
When the list is displayed, shortlinks (that blog’s URL with <code>?p=[post_id]</code>) will be used, rather than the proper permalink, since it would require a lot more resources to build the proper permalink.
The usage would look something like:
<pre><code>[post-list blog_id=12 post_type="page"]
</code></pre>
When displaying a post list, you can use any <code>post_type</code> that is registered on that blog (that post_type does not have to be registered on the current site).
To display the content of a single post from another blog, again, simply provide the blog’s ID as the <code>blog_id</code> argument. That will pull the content of that post. Unfortunately, at this time, there is no way to invoke all of the plugins from the blog from which you’re pulling the content, so any shortcodes, filters, etc. that may be active on the source blog will not be parsed when the content is displayed on the current blog. Obviously, if all of the same plugins and themes are active (or, if any plugins/themes that introduce shortcodes and filters are active) on both the source blog and the current blog, then there is nothing to worry about.
The usage would look something like:
<pre><code>[post-content blog_id=12 id=25]
</code></pre>
That would pull the content for the post with an ID of 25 from the blog with an ID of 12.
<h3>To Do</h3>
<ul>
<li>Add AJAX features to allow user to choose from a list of posts/sites, instead of requiring them to manually enter the ID</li>
</ul>

Post Content Shortcodes

Adds shortcodes to display the content of a post or a list of posts.

Advanced Post List vs Post Content Shortcodes