この記事は最後に更新してから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


お勧め

wp_print_inline_script_tag(2021年4月19日 更新)

void wp_print_inline_script_tag( string $javascript [ , array $attributes = array() ] )
インラインJavaScriptを含むscript要素を出力する。

register_rest_route(2022年8月17日 更新)

bool register_rest_route( string $namespace, string $route [ , array $args = array() [ , bool $override = false ] ] )
REST APIのルートを登録する。

wp_determine_option_autoload_value(2024年7月22日 更新)

string wp_determine_option_autoload_value( string $option, mixed $value, mixed $serialized_value, boo l |string $autoload )
自動ロードのトリガー値を取得する。

single_tag_title(2018年5月27日 更新)

string single_tag_title( [ string $prefix = '' [ , bool $display = true ] ] )
投稿タグアーカイブページの投稿タグ名を取得し、パラメータ$displayがtrueならば表示する。$displayがfalseの場合は、文字列として返す。

home_url(2023年3月31日 更新)

string home_url( [ string $path = '' [ , string $scheme = null ] ] )
現在のブログ(サイト)のホームURLを取得する。ホームURLは、管理者ページの「設定」-「一般」の「サイトのアドレス(URL)」のこと。