WordPress.org

Ready to get started?Download WordPress

Plugin Directory

AW WordPress Yearly Category Archives

This plugin will allow for yearly archives of specific categories from all post types and "Posts".

AW WordPress Yearly Category Archives has two (2) shortcodes available, both of which are required for the plugin to function properly.

Follow the instructions below to use the plugin.

The first shortcode is [aw_year_links cat="X" postslug="slug-to-post-or-page"], which is used to build and display the year links.

The following list explains this shortcode's usage and requirements.

  • This shortcode has two (3) attributes. Two (2) are required, and one (1) is optional.
  • The cat="X" attribute is the category ID you wish to display yearly links from. Replace the X with the numerical ID of the category you wish to query. You may include a comma separated list of category IDs with this attribute if you want to query multiple categories. This attribute is required.
  • The postslug="slug-to-post-or-page" attribute is the slug to the page that will display your yearly archived posts. This is also the slug of the page you will include the second shortcode on. This attribute is required.
  • The dropdown="yes" attribute will allow a dropdown select input to be used in place of the standard unordered list of the year links. This attribute is optional and can be left off completely.
  • Place this shortcode where you would like to display the year links to the specified category.

The second shortcode is [aw_show_posts cat="X" readmore="Continue Reading" publishedon="n/j/Y"], which is used to display the post content after click a year link.

The following list explains this shortcode's usage and requirements.

  • This shortcode has three (3) attributes. One (1) is required, and two (2) are optional.
  • The cat="X" attribute is the category ID you wish to display yearly archived posts from. Replace the X with the numerical ID of the category you wish to query. You may include a comma separated list of category IDs with this attribute if you want to query multiple categories. This attribute is required.
  • The readmore="Continue Reading" attribute is the text you wish to display for the "Read More" link. This attribute is optional and will default to "Read More" if left out.
  • The publishedon="n/j/Y" attribute is the PHP date format the published on date will appear in the archived posts. This attribute is optional and will default to "M jS, Y" if left out. Refer here for further info on the PHP date format.
  • Place this shortcode where you would like to display your archived posts.

Additional Notes

  • The shortcodes can be used multiple times throughout the site as long as they are always used in pairs with each pair having the same cat="X" attribute. This is handy for displaying separate yearly category archives.
  • The plugin will query all custom post types as well as the main "Posts".
  • Currently the plugin will display Four (4) elements for each post, unless the admin chooses to write their own post structure on the settings page. They are as follows and in order:
    1. <h2 class="awPostTitle">The Post's Title</h2>
    2. <p class="awPublishedOnDate">Published on Aug 13th, 2013</p>
    3. <p class="awPostExcerpt">The Post's First 25 Words...<a href="http://yoursite.com/the-post-slug">Read More</a></p>
    4. <hr class="awPostDivider"/>
  • The actual post elements have classes; however they do not have styles. This is to allow you to style them how you choose. The only frontend style included is for the post divider <hr class="awPostDivider"/> rule. This can be overriden if you so choose to.
  • Currently there is also no pagination built into the display of yearly archived posts. I do have plans for this in the future if time allows.
  • Currently I will only be able to offer limited support for this plugin. This could change in the future, also if time allows.
  • If you do not know how to find your category IDs, I recommend Reveal IDs.

Follow me on Twitter @iAmAndyWarren or find me at andy-warren.net. Want to make the plugin better? Fork it or submit pull requests on GitHub at https://github.com/andywarren/aw-yearly-category-archives.

Requires: 3.5.2 or higher
Compatible up to: 3.9.2
Last Updated: 2014-6-18
Downloads: 1,460

Ratings

5 stars
5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

0,1,0
0,1,0