19_01.投稿の一覧表示には、Jetpackのアーカイブ(archives)ショートコード埋め込み(各種条件指定例)

2014/01/19 2014/11/22

WordPressで投稿の一覧表示（リスト化）を行う為にテーマの変更などで、
あれこれカスタマイズしていませんか。
ショートコードを利用するだけで様々な条件を指定した表示が行えます。
アーカイブショートコードを利用した一覧表示（リスト化）についてご紹介します。

はじめに

WordPressで投稿の一覧表示（リスト化）と言えば、
フロントページ（TOPページ）の表示で利用している「最新の投稿」一覧ではないでしょうか。

最新投稿の表示のように、任意の期間などを指定して一覧表示ができたら便利だと思いませんか？
それがショートコード[ archives ]（空白は削除ください）を利用すると簡単に行えます。

アーカイブショートコードの利用方法

アーカイブショートコードを利用するには、JetPackを有効にする必要があります。
以下の投稿を参考に設定を行ってください。
19.ショートコード埋め込み－Jetpack by WordPress.com

JetPackにてショートコード埋め込みを有効化すると、
そのまま[ archives ]を利用することができるようになります。

アーカイブショートコードの条件指定例

アーカイブショートコードをそのまま投稿本文に挿入すると、
全ての投稿が一覧化され表示されます。

アーカイブショートコード全表示

これではちょっと現実的ではありませんが様々な条件指定が行えます。
WordPress.comサイトのショートコード例を順にご紹介します。

Last 12 months（直近１２か月）:

以下のショートコードでは月別アーカイブリンクが一覧化され、
直近１２ヶ月分（limit=12）表示されます。

[archives type=monthly limit=12]

1	[archives type=monthly limit=12]

Last 12 months

Last 12 months with post count:

以下のショートコードでは月別アーカイブリンクが一覧化され、
直近１２ヶ月分（limit=12）表示されるとともに「showcount=true」によって投稿数が表示されます。

[archives type=monthly limit=12 showcount=true]

1	[archives type=monthly limit=12 showcount=true]

Last 12 months with post count

Last 18 days:

以下のショートコードでは日別アーカイブリンクが一覧化され、
投稿のあった直近１８日分（limit=18）表示されます。

[archives type=daily limit=18]

1	[archives type=daily limit=18]

Last 18 days

Last 32 posts:

以下のショートコードでは直近３２投稿が（limit=32）表示されます。

[archives limit=32]

1	[archives limit=32]

Last 32 posts

Last 3 weeks:

以下のショートコードでは年別アーカイブページを週数指定によって表示します。
直近３週が（limit=3）が表示されます。

[archives type=weekly limit=3]

1	[archives type=weekly limit=3]

Last 3 weeks

リンクをクリックした際のURLは以下のようにパラメータ形式になっています。
（URLの例）
http://algorhythnn.jp/XXXX/2014/?w=3
http://algorhythnn.jp/XXXX/2013/?w=51

当サイトで同様のリンク表示をした際には、以下のようなイメージになります。
2013年12月23日–2013年12月29日

そのことから、年別アーカイブをその年の第３週といった形で取得していることが分かります。
その為、現在日付を基準にしているわけではないようです。

All posts in a drop-down:

以下のショートコードではすべての投稿をドロップダウンにて表示します。

[archives format=option]

1	[archives format=option]

All posts in a drop-down

Last 12 months with post count in a drop-down:

以下のショートコードでは月別アーカイブをドロップダウンにて表示します。
また直近１２か月分（limit=12）を表示されるとともに
「showcount=true」によって投稿数が表示されます。

[archives format=option type=monthly limit=12 showcount=true]

1	[archives format=option type=monthly limit=12 showcount=true]

Last 12 months with post count in a drop-down

Last 17 weeks with some before and after text:

以下のショートコードでは年別アーカイブページを週数指定によって表示します。
直近１７週が（limit=17）が表示されると共に、
リンクの前後に指定した文字が挿入されて表示されます。

[archives type=weekly limit=17 before='some before text' after='some after text']

1	[archives type=weekly limit=17 before='some before text' after='some after text']

Last 17 weeks with some before and after text

オプション

オプションの設定については、本投稿最後の参考サイトを参照頂ければと思いますが、
以下のようなオプションが利用できます。

以下オプションで青太字はデフォルト設定です。

type　オプション

yearly, monthly, weekly, daily, postbypost　からタイプを指定することができます。
各タイプを指定した場合、以下のように表示されます
※別途 limit=3 を指定しています。

typeオプション

format 　オプション

option (drop-down menu), html (unordered list),
custom (for use with the “before” and “after” parameters)を指定することができます。
※別途 type=monthly limit=3 を指定しています。

format オプション

limit　オプション

数値を指定します。デフォルトはNo limit（制限なし）です。
これは指定した各表示単位で表示される行数（項目数）を示します。

showcount　オプション

true, falseを指定することができます。
trueを指定することで各表示単位ごとに含まれる投稿数を「(XX)」形式で表示します。

before　オプション

Any string of text or HTML tag from here　（←は、以下引用を参照）
任意のテキストまたはHTMLコードを指定して、各リンクの前に挿入します。
利用できるHTMLタグは以下が利用可能です。

HTML Tags

WordPress.com allows the following HTML code in your posts, pages, and widgets:

address, a, abbr, acronym, area, article, aside, b, big, blockquote, br, caption, cite, class, code, col, del, details, dd, div, dl, dt, em, figure, figcaption, footer, font, h1, h2, h3, h4, h5, h6, header, hgroup, hr, i, img, ins, kbd, li, map, ol, p, pre, q, s, section, small, span, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, var

（引用元）Code — Support — WordPress.com

after　オプション

Any string of text or HTML tag from here　（←は、以下引用を参照）
任意のテキストまたはHTMLコードを指定して、各リンクの後ろに挿入します。
利用できるHTMLタグはbeforeと同じです。

order　オプション

asc, descを指定することができます。
asc（昇順）、desc（降順）で並び順を指定することができます。

通常は最新投稿が上にくる降順で表示されます。

さいごに

こうして、ショートコードを指定するだけで、簡単に投稿の一覧を挿入することができます。
欲を言えば、カテゴリやタグなどの条件が指定できたら便利だろうなと思うところです。

参考

Archives Shortcode — Support — WordPress.com

WordPressはWordPress Foundation の登録商標（第５０４９９６５号）です。
WordPressロゴ、アイコンその他のマーク等はWordPress Foundation の商標であり、
WordPress Foundation の著作物です。
WordPress.comはWordPress Foundation が管理運営を行うドメインならびにサービスの名称です。