この記事は最後に更新してから1年以上経過しています。

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

説明

サイト設計において、ページ間の相互リンクは重要である。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のみを取得するものであり、表示したりはしない。内部的にこれらの関数を使用してリンクを表示する関数もいくつか用意されているが、長くなるのでここでは割愛する。


最終更新 : 2014年06月12日 09:18


お勧め

get_the_post_thumbnail_caption(2018年5月27日 更新)

string get_the_post_thumbnail_caption( mixed $post = null )
投稿ページのサムネイル(アイキャッチ画像)キャプションを取得する。

nocache_headers(2018年5月27日 更新)

void nocache_headers( )
ブラウザのキャッシュを無効にするHTTPヘッダーを出力する。

is_year(2018年5月27日 更新)

bool is_year( )
要求されているページが、年別アーカイブページ(リクエストURLが/2009のように、書式が「/年」の場合)か調べる。

get_custom_header_markup(2018年5月27日 更新)

string get_custom_header_markup()
カスタムヘッダーのHTMLパーツを取得する。

show_admin_bar(2012年1月5日 更新)

void show_admin_bar( bool $show )
ツールバー(admin bar)を強制的に表示/非表示する。