Scott Reilly

This plugin provides a function for use by developers who have their own code for fetching posts according to a given criteria and now want to make use of loop-aware template tags to display those posts.
WordPress’s template tags are intended to be used within ‘the loop’. The loop is managed by a WP_Query object which sets up various global variables and its own object variables for use by the various template tags. The primary purpose of a WP_Query object is to actually query the database for the posts that match the currently specified criteria. However, if you don’t need to query for posts since you already have them by some other means, you can still take advantage of the template tags by injecting those posts into the WP_Query via this plugin.
Depending on the template tags you are looking to use, or the logic you are hoping to employ within a loop, you may need to manually configure some of the query object’s variables.
Example:
<pre><code><?php // Say we're in the sidebar

// We've gotten some post objects on our own.
$posts = c2c_get_random_posts( 5, '' );

// Inject the posts
c2c_inject_query_posts( $posts );

// Now let's display them via template tags:
if ( have_posts() ) :
 while ( have_posts() ) : the_post(); ?>

 <li><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title_attribute(); ?>"><?php the_title(); ?></a></li>

 <?php endwhile;?>
<?php endif; ?>
</code></pre>
Links: <a href="https://coffee2code.com/wp-plugins/inject-query-posts/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/inject-query-posts/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/inject-query-posts/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a>
<h3>Developer Documentation</h3>
Developer documentation can be found in <a href="https://github.com/coffee2code/inject-query-posts/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the template tag and hooks provided by the plugin.
As an overview, this is the template tag provided by the plugin:
<ul>
<li><code>c2c_inject_query_posts()</code> : Template tag to inject an array of posts into a query object as if that query object had obtained those posts via a query.</li>
</ul>
These are the hooks provided by the plugin:
<ul>
<li><code>inject_query_posts_preserve_query_obj</code> : Overrides the value of the <code>$preserve_query_obj</code> argument passed to the function. This is not typical usage for most users.</li>
<li><code>c2c_inject_query_posts</code> : Allows use of an alternative approach to safely invoke <code>c2c_inject_query_posts()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</li>
</ul>

Inject Query Posts

Facilitates injecting an array of posts into a WP query object as if queried. Particularly useful to allow use of standard template tags.

This plugin provides thirteen handy template tags that relate to the index/position of a post within a loop’s listing of posts.
Some of the template tags provided by this plugin relate to the position of the current post within the current loop:
<ul>
<li><code>c2c_is_first()</code></li>
<li><code>c2c_is_last()</code></li>
<li><code>c2c_is_at_index()</code></li>
<li><code>c2c_is_even()</code></li>
<li><code>c2c_is_odd()</code></li>
<li><code>c2c_get_the_index()</code></li>
<li><code>c2c_is_index_within()</code></li>
<li><code>c2c_the_index()</code></li>
</ul>
Other functions help you get a post (or posts) at a given position in the current loop:
<ul>
<li><code>c2c_get_post_by_index()</code></li>
<li><code>c2c_get_posts_by_index()</code></li>
</ul>
While the remaining three functions relate to index information about the loop in general:
<ul>
<li><code>c2c_get_last_index()</code></li>
<li><code>c2c_is_post_in_loop()</code></li>
<li><code>c2c_is_valid_index()</code></li>
</ul>
Please see the Template Tags section (in some places found under the Other Notes section) for descriptions of all the functions and their arguments.
Note that index counting begins at 0, which means the first item has an index of 0. An index of -1 indicates no posts were found.
Links: <a href="https://coffee2code.com/wp-plugins/post-index-helpers/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/post-index-helpers/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/post-index-helpers/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a>
<h3>Developer Documentation</h3>
Developer documentation can be found in <a href="https://github.com/coffee2code/post-index-helpers/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the numerous template tags provided by the plugin.
As an overview, these are the template tags provided the plugin:
<ul>
<li><code>c2c_get_last_index()</code> : Gets the index number for the last post in the loop listing</li>
<li><code>c2c_get_post_by_index()</code> : Get post based on specified index</li>
<li><code>c2c_get_posts_by_index()</code> : Get posts based on specified array of indexes</li>
<li><code>c2c_get_the_index()</code> : Get the index for the current post</li>
<li><code>c2c_is_at_index()</code> : Is the current index at the specified index?</li>
<li><code>c2c_is_even()</code> : Is the current post at an even position? (i.e. 0, 2, 4, …)</li>
<li><code>c2c_is_first()</code> : Is the current post the first listed post?</li>
<li><code>c2c_is_last()</code> : Is the current post the last listed post?</li>
<li><code>c2c_is_odd()</code> : Is the current post at an odd position? (i.e. 1, 3, 5, …)</li>
<li><code>c2c_is_index_within()</code> : Is the current post (or one at the specified index) within the bounds of a specified range?</li>
<li><code>c2c_is_post_in_loop()</code> : Is the specified post within the current loop?</li>
<li><code>c2c_is_valid_index()</code> : Is the specified index valid?</li>
<li><code>c2c_the_index()</code> : Echo the current post’s index</li>
</ul>

Post Index Helpers

A variety of template tags related to the index/position of a post within a loop's listing of posts.

Inject Query Posts vs Post Index Helpers