外掛說明

If your blog is over a year or two old, you may have noticed the list of archive pages is getting unwieldy.

This plugin is a widget that compresses the size of the arcgives list to two lines per year (three if the lines are narrow) rather than one line per per month.

More information

This widget is licensed under GPLv3.

Grateful thanks to Alan Morgan whose widget_archives2 I used as a template.

Potential developers should check out the development history.

Finally, an obligatory plug for my blog, OddThinking.

螢幕擷圖

This is an example of a compact monthly archive. In this theme, white is a link that hasn’t been visited. Light blue is a link that has been visited, and the greyish blue is a month with no articles, and hence has no link. You may choose your own colour-scheme.

安裝方式

Upload plugin-name.php to the /wp-content/plugins/ directory.
Activate the plugin through the ‘Plugins’ menu in WordPress.
Find the Widgets page (under Presentation in WordPress 2.0-2.3, but there are rumours that it is moving in WordPress 2.4.)
Drag the Compact Monthly Archives into your preferred location.
Click on the icon on the right on the Compact Monthly Archives and set the title. (Default is “Archives”.)
Modify the CSS of the theme to taste, using any of the following styles:
- STO_cma_archive_list – this is applied to the ul tag that covers the entire calendar, apart from the title.
- STO_cma_line – this applies to the li tag that represents each year.
- STO_cma_month – this applies to each letter that represents a month.
- STO_cma_link – this applies to each month that includes an article (and is, hence, a link.)
- STO_cma_empty – this applies to each month that is empty (and is, hence, not a link)
- STO_cma_zwsp – this applies to the whitespace gap between June and July. You may like to make it narrow.

Here is an example:

.STO_cma_month a {
    line-height: 1.2em;
    padding: 0.2em;
}

.STO_cma_empty{
    color: #4984E3;
    line-height: 1.2em;
    padding: 0.2em;

}

You almost certainly will want to change the example style to fit your theme.

常見問題集

When would I use this?

The default WordPress archive listing takes one line for every month. Once your blog gets over about a one or two years old, this becomes unwieldy. That’s the point where you should consider this plug-in instead. This plug-in only takes two or three lines per year.

When your blog gets to be about 4-6 years old, it will start to get unwieldy again. Hopefully, by then, we will have a solution for that too.

How do I localise it for my language?

The widget automatically uses the first character from each month based on your locale. So all you need to is override the default title to a word meaning ‘archives’ in your language.

I haven’t tested it on any right-to-left languages. If this doesn’t work, let me know, and I will come up with a workaround.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Compact Monthly Archive〉的開發相關工作。

Oddthinking

將〈Compact Monthly Archive〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。