get_pagenum_link

説明

string get_pagenum_link( [ int $pagenum = 1 [ , bool $escape = true ] ] )
ページ番号リンク(URL)を取得する。

パラメータ

  • $pagenum
    ページ番号を指定(省略時は1)。
  • $escape
    エスケープ処理として esc_url関数を使用する場合はtrueを、 esc_url_raw関数を使用する場合はfalseを指定(省略時はtrue)。

返り値

ページ番号リンクを返す。


注意

esc_ur関数は&や'をHTMLエンティティに変換するが、esc_url_raw関数は&や'をHTMLエンティティに変換しない。

[5.2.0]'get_pagenum_link'フィルターにパラメータ$pagenumが追加された。


使用例

  • ベースとなるページ番号リンクを取得する。
    <?php $link = get_pagenum_link(); ?>
  • esc_url_raw関数でエスケープ処理したページ番号リンクを取得する。
    <?php $link = get_pagenum_link( $paged, false ); ?>

フィルター

[2.5.0]リンクを返す前に'get_pagenum_link'フィルターを呼び出す。パラメータ$resultにはリンクが格納される。[5.2.0]$pagenumには受け取った内容をintでキャストした値が格納されている。
$result = apply_filters( 'get_pagenum_link', $result, $pagenum );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

最終更新 : 2019年05月10日 09:47



お勧め

リビジョンの仕組みを勘違いしてた(2018年9月17日 更新)

過去の投稿情報を記録するリビジョン機能をカスタム投稿タイプで利用しようと思い作りこみしていたが、思惑通りの動きにならなかった。リビジョン機能は投稿情報の更新前の内容を記録するものと勝手に思い込んでいたのだが、どうやらそれは間違いだった。

Emojin:プラグイン作ってみました(2015年3月21日 更新)

ちょっと前のTLでiOSの絵文字を含んだ投稿を保存すると、絵文字以降の文章がすべて消えた状態で保存されるといったツイートを見かけた。少し検索してみると、MySQLのデータベースの文字セットが「utf8」の場合、iOSの絵文字のような4バイトの文字を正常に保存できず、それ以降の文章も保存されないというものらしい。対処方法としてデータベースの文字セットを「utf8mb4」に変更するのが有効らしいのだが、他に回避策がないか考えてみた。

MOファイルを作ってみた(2018年7月25日 更新)

テーマやプラグインで使用するMOファイルはWindows環境では「Poedit」アプリを使うことが多かったが、最近では「GlotPress」のようなプラグインも増えてきており、選択肢は広がっている。定期的に開発環境を見直す過程で「Poedit」から「GlotPress」に切り替えようと思ったのだが、微妙にしっくりこなかった。

全投稿を取得するのはnopaging=1でいい(2011年8月31日 更新)

query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?

Login rebuilderに「XML-RPC設定」を追加しました(2018年5月27日 更新)

公式サイトで公開しているプラグイン「Login rebuilder」をバージョンアップし、XML-RPCリクエストの管理機能を追加しました。Login rebuilderの主たる機能は、ログインページをサイト別にユニークなURLに変更し、ログインページへの不正アクセスを回避することです。WordPressのXML-RPCリクエストはピンバックや外部ツールやサイトなどとの連携に利用されていますが、今回追加した機能ではXML-RPCリクエストの処理に対していくつかの制限できるようにしています。