Post Index Helpers

plugin banner

Version: 1.1.1

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

Author:Scott Reilly (profile at wordpress.org)
WordPress version required:2.8
WordPress version tested:6.3
Plugin version:1.4.3
Added to WordPress repository:13-09-2010
Last updated:15-08-2023
Rating, %:0
Rated by:0
Plugin URI:https://coffee2code.com/wp-plugins/post-index...
Total downloads:4 302
Active installs:10+
plugin download
Click to start download

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:

  • c2c_is_first()
  • c2c_is_last()
  • c2c_is_at_index()
  • c2c_is_even()
  • c2c_is_odd()
  • c2c_get_the_index()
  • c2c_is_index_within()
  • c2c_the_index()

Other functions help you get a post (or posts) at a given position in the current loop:

  • c2c_get_post_by_index()
  • c2c_get_posts_by_index()

While the remaining three functions relate to index information about the loop in general:

  • c2c_get_last_index()
  • c2c_is_post_in_loop()
  • c2c_is_valid_index()

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: Plugin Homepage | Plugin Directory Page | GitHub | Author Homepage

Developer Documentation

Developer documentation can be found in DEVELOPER-DOCS.md. That documentation covers the numerous template tags provided by the plugin.

As an overview, these are the template tags provided the plugin:

  • c2c_get_last_index() : Gets the index number for the last post in the loop listing
  • c2c_get_post_by_index() : Get post based on specified index
  • c2c_get_posts_by_index() : Get posts based on specified array of indexes
  • c2c_get_the_index() : Get the index for the current post
  • c2c_is_at_index() : Is the current index at the specified index?
  • c2c_is_even() : Is the current post at an even position? (i.e. 0, 2, 4, …)
  • c2c_is_first() : Is the current post the first listed post?
  • c2c_is_last() : Is the current post the last listed post?
  • c2c_is_odd() : Is the current post at an odd position? (i.e. 1, 3, 5, …)
  • c2c_is_index_within() : Is the current post (or one at the specified index) within the bounds of a specified range?
  • c2c_is_post_in_loop() : Is the specified post within the current loop?
  • c2c_is_valid_index() : Is the specified index valid?
  • c2c_the_index() : Echo the current post’s index
ChangeLog