各種リンクを取得する関数一覧

各種リンクを取得する関数一覧 - 反省とおさらいを兼ねてまとめてみた

説明

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク(パーマリンク)を取得する関数を用意しており、それらを一通り把握しておくべきだろう。

サイトを構成する各種ページは、トップページ、アーカイブページ、シングルページに分類できる(かなりざっくり気味)。それらを軸に(ページ内に表示するための)リンクを取得する関数を整理すると、次のような一覧になる。

分類関数内容
トップページsite_urlトップページのリンクを取得する。
アーカイブ
ページ
タームアーカイブget_term_linkカテゴリ、投稿タグ、カスタムタクソノミーのアーカイブページのリンクを取得する。
年アーカイブget_year_link年アーカイブのリンクを取得する。
月アーカイブget_month_link月アーカイブのリンクを取得する。
日アーカイブget_day_link日アーカイブのリンクを取得する。
投稿タイプアーカイブget_post_type_archive_linkカスタム投稿タイプアーカイブのリンクを取得する。
著者ページ(アーカイブ)get_author_posts_url著者ページのリンクを取得する。
シングル
ページ
汎用get_permalink内部でページ属性に応じて以下の関連関数を呼び出すので、各種シングルページのリンクはこれ1つで取得できる。
固定ページget_page_link固定ページのリンクを取得する。
添付ファイルget_attachment_link添付ファイルページのリンクを取得する。
カスタム投稿タイプget_post_permalinkカスタム投稿タイプの投稿ページのリンクを取得する。
検索結果ページget_search_link検索結果ページのリンクを取得する。

get_term_link関数とget_permalink関数は、きっちり押さえておきたいところ。カスタム投稿タイプを利用するならget_post_type_archive_link関数も重要だろう。なお、ここに挙げた関数はすべてURLのみを取得するものであり、表示したりはしない。内部的にこれらの関数を使用してリンクを表示する関数もいくつか用意されているが、長くなるのでここでは割愛する。

関連

お勧めコンテンツ

sanitize_hex_color_no_hash(2012年6月14日 登録)

string sanitize_hex_color_no_hash( $color )
'#'のついていない16進数のカラー値をサニタイズする。

get_queried_object_id(2011年12月8日 登録)

mixed get_queried_object_id()
ページリクエストにマッチした情報(オブジェクト)のIDを取得する。

delete_post_meta_by_key(2014年3月17日 登録)

bool delete_post_meta_by_key( string $post_meta_key )
カスタムフィールドの値を一括削除する。

wp_get_attachment_image_url(2015年12月23日 登録)

mixed wp_get_attachment_image_url( int $attachment_id [ , mixed $size = 'thumbnail' [ , bool $icon = false ] ] )
添付投稿の画像URLを取得する。

wp_removable_query_args(2015年12月13日 登録)

array wp_removable_query_args( )
URLの正規化時に除外するクエリー名を取得する。

最終更新日時 : 2014-06-12 09:18