Title: Monthchunks
Author: Justin Watt
Published: <strong>September 29, 2012</strong>
Last modified: January 4, 2026

---

Search plugins

![](https://ps.w.org/monthchunks/assets/icon-256x256.png?rev=2528356)

# Monthchunks

 By [Justin Watt](https://profiles.wordpress.org/justincwatt/)

[Download](https://downloads.wordpress.org/plugin/monthchunks.3.1.2.zip)

 * [Details](https://twd.wordpress.org/plugins/monthchunks/#description)
 * [Reviews](https://twd.wordpress.org/plugins/monthchunks/#reviews)
 *  [Installation](https://twd.wordpress.org/plugins/monthchunks/#installation)
 * [Development](https://twd.wordpress.org/plugins/monthchunks/#developers)

 [Support](https://wordpress.org/support/plugin/monthchunks/)

## Description

Display monthly archives by year with links to each month in the following compact
format:

    ```
    2012
    1 2 3 4 5 6 7 8 9

    2011
    1 2 3 4 5 6 7 8 9 10 11 12

    2010
    6 7 8 9 10 11 12
    ```

Serves as a drop in replacement for [`wp_get_archives( array( 'type' => 'monthly' ) );`](https://codex.wordpress.org/Function_Reference/wp_get_archives).

If you’re interested in contributing to the code behind this plugin, it’s also hosted
on GitHub:
 https://github.com/justincwatt/wp-monthchunks

## Screenshots

 * [[
 * This is how Monthchunks looks with the Twenty Eleven theme. You can see here 
   that 4 years of archives (eventually 48 links) take up less than 200 vertical
   pixels of precious sidebar real estate. Note that if you’re browsing a monthly
   archive page, that month’s number is emboldened, but not linked. If you hover
   over the link for any month, you’ll see the localized month name and year as 
   a _tooltip_.
 * [[
 * [[

## Installation

 1. Extract the zip file, drop the contents in your wp-content/plugins/ directory, 
    and then activate from the Plugins page.
 2. Edit your theme file (e.g. sidebar.php) and replace the WordPress template tag `
    wp_get_archives();` with `monthchunks();`
 3. You can also add it as a widget to any sidebar

## FAQ

### How do I make the years display in ascending order (2010, 2011, 2012…) instead of descending (the default)?

The monthchunks function takes two optional parameters and the first is `year_order`,
which accepts two string values: `"descending"` or `"ascending"`.

### Can I make months display in a format other than the default month number (1, 2, 3…)?

The monthchunks function takes two optional parameters and the second is `month_format`,
which accepts three string values: `"numeric"`, `"alpha"`, or `"abbreviation"`. 
The “alpha” format displays the first letter of the month (e.g. J, F, M…) which 
may not make sense in all languages. The “abbreviation” format displays the language-
specific abbreviation for the month, e.g. (Jan, Feb, Mar…).

## Reviews

![](https://secure.gravatar.com/avatar/b3ae68f1e027440678c309b93a1e1dfdec0be2bb9ee6accb2a9eb83023ee72f6?
s=60&d=retro&r=g)

### 󠀁[nice](https://wordpress.org/support/topic/nice-4589/)󠁿

 [Muscular girl](https://profiles.wordpress.org/thomasalvaedison/) May 17, 2023

Widget archives are easier to see.

 [ Read all 2 reviews ](https://wordpress.org/support/plugin/monthchunks/reviews/)

## Contributors & Developers

“Monthchunks” is open source software. The following people have contributed to 
this plugin.

Contributors

 *   [ Justin Watt ](https://profiles.wordpress.org/justincwatt/)
 *   [ Xavi Ivars ](https://profiles.wordpress.org/xavivars/)

“Monthchunks” has been translated into 3 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/monthchunks/contributors)
for their contributions.

[Translate “Monthchunks” into your language.](https://translate.wordpress.org/projects/wp-plugins/monthchunks)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/monthchunks/), check
out the [SVN repository](https://plugins.svn.wordpress.org/monthchunks/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/monthchunks/) by
[RSS](https://plugins.trac.wordpress.org/log/monthchunks/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.1.1

 * Fix text domain

#### 3.1

 * Changed l10n to adjust to new plugin translation process
    ** Updated text-domain

#### 3.0.4

 * Fix PHP Notice, incorrectly using variable instead of instance field. (thanks
   Birgir Erlendsson – @birgire)

#### 3.0.3

 * Improve class constructor

#### 3.0.2

 * Fix backwards compatibility calls to monthchunks

#### 3.0.1

 * Fix admin area issue

#### 3.0

 * Major refactor of the code
    ** Created different files to split the backend logic
   and the widget
 * Includes widget support
 * Added localization templates

#### 2.4

 * Added the new “abbreviation” mode for month display (thanks Xavi Ivars)

#### 2.3

 * Use WordPress’ Date and Time Locale object to localize month names in tooltip
 * Change default year_order sort to descending (more closely matches wp_get_archives)
 * Appropriately escape html output (though largely unnecessary)
 * Fix: only display archive link for months with posts (not pages)

#### 2.2

 * Generate output with a single SQL query, instead of N+1, where N was the number
   of years of post archives

#### 2.1

 * Add year_order and month_format options
 * Add `title="month_name year"` attribute (aka tooltips) to the month links
 * Lmited visible archives to posts with post_status = ‘publish’
 * Revise pretty html output slightly
 * Add semifix for year = “0000” bug

#### 2.0

 * Remove `<ul></ul>` output to make monthchunks more of a drop-in replacement for`
   wp_get_archives()`
 * Add logic to de-link from current month
 * Sort years in chronlogical order
 * Don’t print separator space after last month of year

#### 1.2

 * Use `$wpdb->posts` instead of `wp_posts` as table name

#### 1.1

 * Use WordPress’ `get_month_link()` function to output link to monthly archive (
   thanks raphaële)

#### 1.0

 * Initial version

## Meta

 *  Version **3.1.2**
 *  Last updated **3 months ago**
 *  Active installations **80+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **6.9.4**
 *  Languages
 * [Catalan](https://ca.wordpress.org/plugins/monthchunks/), [English (US)](https://wordpress.org/plugins/monthchunks/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/monthchunks/), and [Spanish (Spain)](https://es.wordpress.org/plugins/monthchunks/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/monthchunks)
 * Tags
 * [archive](https://twd.wordpress.org/plugins/tags/archive/)[archives](https://twd.wordpress.org/plugins/tags/archives/)
   [sidebar](https://twd.wordpress.org/plugins/tags/sidebar/)[template tag](https://twd.wordpress.org/plugins/tags/template-tag/)
   [wp_get_archives](https://twd.wordpress.org/plugins/tags/wp_get_archives/)
 *  [Advanced View](https://twd.wordpress.org/plugins/monthchunks/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  2 5-star reviews     ](https://wordpress.org/support/plugin/monthchunks/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/monthchunks/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/monthchunks/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/monthchunks/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/monthchunks/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/monthchunks/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/monthchunks/reviews/)

## Contributors

 *   [ Justin Watt ](https://profiles.wordpress.org/justincwatt/)
 *   [ Xavi Ivars ](https://profiles.wordpress.org/xavivars/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/monthchunks/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://justinsomnia.org/2005/04/monthchunks-howto/)