Esperanto (eo) / Kromprogramo por blogprogramo WordPress: "Pagxilo por Dividajxoj"
English (en) / Plugin for WordPress: "Pager for Split Entries"
WordPressプラグイン"Pager for Split Entries"は<--nextpage-->タグによって分割された投稿やページのためのページャです。
<?php pager_for_split_entries(); ?>
を記述してください。これで完了です!3ページに分割された投稿で、1ページ目を表示した場合の例です。以降の例でも共通です。
pager_for_split_entries();
上記のように単純に記述すると、(X)HTMLコードは以下のようになります。
<ul style="~">
<li style="~">(Fiest)</li>
<li style="~">#1</li>
<li style="~"><a href="~/2">#2</a></li>
<li style="~"><a href="~/3">#3</a></li>
<li style="~"><a href="~/2">Next ></a></li>
</ul>
表示結果は、概ね以下の通りです。
このプラグインは引数によって表示内容を自由にカスタマイズ出来ます。
pager_for_split_entries()
関数へ指定可能な引数は以下の通りです。
順番 | 名称 | 概要 | 暗黙値(デフォルト) | |
---|---|---|---|---|
null(省略)の時 | ''(空文字)の時 | |||
0 | first | 前のページが無い場合(自身が先頭ページの場合)の「前へ」の代替文字列。 | '(First)' | li要素自体が描画されません |
1 | previous | 前のページへのリンク文字列。 | '< Prev' | |
2 | prefix | ページ番号の接頭辞。 | '#' | '' (空文字) |
3 | suffix | ページ番号の接尾辞。 | '' (空文字) | |
4 | next | 次のページへのリンク文字列。 | 'Next >' | |
5 | last | 次のページが無い場合(自身が最終ページの場合)の「次へ」の代替文字列。 | '(Last)' | li要素自体が描画されません |
6 | split_pages | ナビゲーションバーであるul要素のclass属性値。スタイルを指定するために使います。 | class属性値ではなくstyle属性が記述されます | |
7 | active_page | ナビゲーションバー内の現在ページ番号であるli要素のclass属性値。スタイルを指定するために使います。 | class属性値ではなくstyle属性が記述されます |
pager_for_split_entries()関数への引数の指定方法は、以下の通りです。
文字を変えることが出来ます。
pager_for_split_entries('[先頭]', '« 前へ', '第', '頁', '次へ »', '[末尾]');
上記のように記述すると、(X)HTMLコードは以下のようになります。
<ul style="~">
<li style="~">[先頭]</li>
<li style="~">第1頁</li>
<li style="~"><a href="~/2">第2頁</a></li>
<li style="~"><a href="~/3">第3頁</a></li>
<li style="~"><a href="~/2">次へ »</a></li>
</ul>
表示結果は、概ね以下の通りです。
先頭や末尾は自明であるとして文字を取り除くことも出来ます。
pager_for_split_entries('', '«', '', '', '»', '');
上記のように記述すると、(X)HTMLコードは以下のようになります。
<ul style="~">
<li style="~">1</li>
<li style="~"><a href="~/2">2</a></li>
<li style="~"><a href="~/3">3</a></li>
<li style="~"><a href="~/2">»</a></li>
</ul>
表示結果は、概ね以下の通りです。
先頭・末尾の文字を消すのではなく、前後の頁へのリンク文字列と一緒にすると、前後のナビゲーションを不活性化したような効果を得られます。
pager_for_split_entries('« 前へ', '« 前へ', 'p.', '', '次へ »', '次へ »');
上記のように記述すると、(X)HTMLコードは以下のようになります。
<ul style="~">
<li style="~">«前へ</li>
<li style="~">p.1</li>
<li style="~"><a href="~/2">p.2</a></li>
<li style="~"><a href="~/3">p.3</a></li>
<li style="~"><a href="~/2">次へ »</a></li>
</ul>
表示結果は、概ね以下の通りです。
第6,7引数にクラスを指定すると、
pager_for_split_entries(null, null, null, null, null, null, 'split_pages', 'active_page');
ul要素やli要素にclass属性を与えられます。
<ul class="split_pages">
<li>(First)</li>
<li class="active_page">#1</li>
<li><a href="~/2">#2</a></li>
<li><a href="~/3">#3</a></li>
<li><a href="~/2">Next ></a></li>
</ul>
ここで、普段お使いのCSS(スタイルシート)にスタイルを記述してください(CSSの知識が必要です)。
ul.split_pages { margin : 1em 0; padding : 0.2em; border : 1px solid #336; background : #eef; color : #000; font-style : italic; font-weight : bold; font-size : 90%; text-align : center; } ul.split_pages li { display : inline; padding : 0 0.4em; letter-spacing : 0.3em; } ul.split_pages li.active_page { font-size : 120%; font-weight : bold; }
例はちょっと弾け過ぎましたか……。