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


お勧め

the_modified_author(2019年10月17日 更新)

void the_modified_author()
更新者の表示名を表示する。

wp_assign_widget_to_sidebar(2021年7月29日 更新)

void wp_assign_widget_to_sidebar( string $widget_id, string $sidebar_id )
ウィジェットをサイドバーに配置する。

get_comment_ID(2018年5月27日 更新)

int get_comment_ID( )
現在のコメントのIDを取得する。

term_is_ancestor_of(2019年3月15日 更新)

bool term_is_ancestor_of( int | object $term1, int | object $term2, string $taxonomy )
タームが子孫関係か調べる。

wp_get_custom_css_post(2019年11月14日 更新)

WP_Post wp_get_custom_css_post( [ string $stylesheet = '' ] )
カスタマイザーで追加したCSS情報を取得する。