2024年06月14日

WP関数:get_template_part()


この関数の説明

WP関数の get_template_part() は、現在のテーマディレクトリにある任意のphpファイルをインクルードします。

 


関数

get_template_part( $slug, $name )

 


オプション

$slug文字列必須

スラッグ名を指定します。

 

$name(文字列) (オプション)

特定テンプレート名を指定します

­ ­phpプログラムのファイル名

PHPプログラムのファイル名は ○○○-△△△.php という - で区切られた構造を持ちます。

○○○がスラッグ名で、△△△を特殊テンプレート名と呼びます。

 


返り値

この関数は値を返しません

 


事例

①sidebar.php に記述するサンプル例

このサイトのサイドバーは下記の様になっています。

・カテゴリ&検索ページ:カテゴリを表示

・アーカイブページ:アーカイブを表示

・投稿ページ:プログラムで関連する関数一覧を表示

・固定ページ:プログラムで関連する関数一覧を表示

上記を振り分けているプログラムが下記になります。

<?php 
	if(is_category() || is_search())dynamic_sidebar('category');// カテゴリ検索のサイドバー
	elseif(is_date())		dynamic_sidebar('archive');					// アーカイブのサイドバー
	elseif(is_single())	get_template_part('sidebar' , 'single');		// 投稿ページのサイドバー
	elseif(is_page())	get_template_part('sidebar' , 'page');		// 固定ページのサイドバー
?>

■2行目:カテゴリと検索ページの時は、ウィジェットで定義している'category'をコールします。

■3行目:アーカイブページの時は、ウィジェットで定義している'archive'をコールします。

■4行目:投稿ページの時は「sidebar-single.php」をインクルードします。

この関数でなく get_sidebar('single')でも可

■5行目:固定ページの時は「sidebar-page.php」をインクルードします。

この関数でなく get_sidebar('page')でも可

 


参考情報

phpファイルをインクルードする方法には、include($file)等のPHP関数もあります。

詳細は下記を参照してください。­

PHPファイルの読み込みと関数

この関数を使うと別のフォルダーの中にあるPHPファイルをインクルードする事もできます。

 


関数一覧
  • 1.WPのエスケープ処理
  • 2.WPプログラムの基本
  • 3.ヘッダ/フッタ/サイドバで使われる関数
  • 4.DBからの読込関数
  • 5.一般テンプレートの中で使われる関数
  • 6.その他のWP関数
  • add_shortcode()
  • bloginfo()
  • body_class()
  • date_i18n()
  • dynamic_sidebar()
  • edit_post_link()
  • esc_attr()
  • esc_html_e()
  • esc_html()
  • esc_url()
  • get_ancestors()
  • get_cat_ID()
  • get_cat_name()
  • get_category_link()
  • get_category_parents()
  • get_category()
  • get_footer()
  • get_header()
  • get_home_url()
  • get_post_format()
  • get_post_meta()
  • get_post_thumbnail_id()
  • get_query_var()
  • get_search_query()
  • get_sidebar()
  • get_site_url()
  • get_stylesheet_directory_uri()
  • get_stylesheet_uri()
  • get_template_directory_uri()
  • get_template_part()
  • get_the_category()
  • get_the_content()
  • get_the_date()
  • get_the_excerpt()
  • get_the_ID()
  • get_the_modified_date()
  • get_the_modified_time()
  • get_the_permalink()
  • get_the_post_thumbnail()
  • get_the_tags()
  • get_the_time()
  • get_the_title()
  • get_uploaded_header_images()
  • get_year_link()
  • has_category()
  • has_custom_logo()
  • has_header_image()
  • has_header_video()
  • has_nav_menu()
  • has_post_thumbnail()
  • has_tag()
  • header_image()
  • home_url()
  • is_admin()
  • is_category()
  • is_date()
  • is_front_page()
  • is_home()
  • is_main_query()
  • is_page()
  • is_search()
  • is_single()
  • language_attributes()
  • the_category()
  • the_content()
  • the_custom_header_markup()
  • the_custom_logo()
  • the_date()
  • the_excerpt()
  • the_ID()
  • the_modified_date()
  • the_modified_time()
  • the_permalink()
  • the_post_thumbnail()
  • the_search_query()
  • the_tags()
  • the_time()
  • the_title()
  • update_post_meta()
  • wp_get_attachment_image_src()
  • wp_nav_menu()
  • WP_Query()