Ermitejo - Esperanto-Japanese Machine Translation

#HEJMO

Plugin for WordPress: "Pager for Split Entries"

Esperanto (eo) / Kromprogramo por blogprogramo WordPress: "Pagxilo por Dividajxoj"

日本語 (ja) / WordPressプラグイン: "Pager for Split Entries"

Introduction & Features [ TOC ]

WordPress Plugin "Pager for Split Entries" is simple pager for split post or page with <--nextpage--> tag.

Usage [ TOC ]

To install the "Pager for Split Entries": [ TOC ]

  1. Download the plugin package (ZIP file). The file size is 3.3 KB (3,404 bytes). The current version of "Pager for Split Entries" is 1.0.1 (10th release).
  2. Extract and upload the pager-for-split-entries.php file into wp_contents/plugins directory.

To activate plugin and draw navigation bar: [ TOC ]

  1. Log in to your beloved WordPress administration page.
  2. Click on "Plugins" in the top of window, and activate the "Pager for Split Entries" plugin by clicking on the link that says "Activate" to the right of the plugin name.
  3. Write <?php pager_for_split_entries(); ?> on your theme file (single.php, index.php, etc.). This is over!

Fundamental example [ TOC ]

3ページに分割された投稿で、1ページ目を表示した場合の例です。Same as adove.

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 &gt;</a></li>
    </ul>

表示結果は、概ね以下の通りです。

Customize [ TOC ]

このプラグインは引数によって表示内容を自由にカスタマイズ出来ます。

引数の詳細 [ TOC ]

pager_for_split_entries()関数へ指定可能な引数は以下の通りです。

OrderNameDescriptionDefault value
null(skipped)''(empty)
0first前のページが無い場合(自身が先頭ページの場合)の「前へ」の代替文字列。'(First)'li要素自体が描画されません
1previous前のページへのリンク文字列。'< Prev'
2prefixページ番号の接頭辞。'#'''(空文字)
3suffixページ番号の接尾辞。''(空文字)
4next次のページへのリンク文字列。'Next >'
5last次のページが無い場合(自身が最終ページの場合)の「次へ」の代替文字列。'(Last)'li要素自体が描画されません
6split_pagesナビゲーションバーであるul要素のclass属性値。スタイルを指定するために使います。class属性値ではなくstyle属性が記述されます
7active_pageナビゲーションバー内の現在ページ番号であるli要素のclass属性値。スタイルを指定するために使います。class属性値ではなくstyle属性が記述されます

Specify arguments [ TOC ]

pager_for_split_entries()関数への引数の指定方法は、以下の通りです。

Change strings #1: Japanese language for exoticism [ TOC ]

文字を変えることが出来ます。

pager_for_split_entries('[先頭]', '&laquo; 前へ', '第', '頁', '次へ &raquo;', '[末尾]');

上記のように記述すると、(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">次へ &raquo;</a></li>
    </ul>

表示結果は、概ね以下の通りです。

Change strings #2: I needn't First/Last strings [ TOC ]

先頭や末尾は自明であるとして文字を取り除くことも出来ます。

pager_for_split_entries('', '&laquo;', '', '', '&raquo;', '');

上記のように記述すると、(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">&raquo;</a></li>
    </ul>

表示結果は、概ね以下の通りです。

Change strings #3: Inactivate Prev/Next links [ TOC ]

先頭・末尾の文字を消すのではなく、前後の頁へのリンク文字列と一緒にすると、前後のナビゲーションを不活性化したような効果を得られます。

pager_for_split_entries('&laquo; 前へ', '&laquo; 前へ', 'p.', '', '次へ &raquo;', '次へ &raquo;');

上記のように記述すると、(X)HTMLコードは以下のようになります。

    <ul style="~">
        <li style="~">&laquo;前へ</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">次へ &raquo;</a></li>
    </ul>

表示結果は、概ね以下の通りです。

Change styles (colors, letters, etc.) [ TOC ]

第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 &gt;</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;
        }

例はちょっと弾け過ぎましたか……。

Contact (Opinions, Questions and Report Bugs) [ TOC ]

History [ TOC ]

versio 1

versio 1.0.1 (10-a eldono)
versio 1.0.0 (9-a eldono)

Others [ TOC ]

Table of Contents

Aŭtorrajto: © Organizo por Zona Servo per Sinkrona Solvo. Ĉiuj rajtoj estas rezervitaj.
Copyright: © Organization for Zonal Service with Synchronous Solution. All rights reserved.