説明
void add_theme_support( string $feature [ , mixed $args = true [ , mixed $... ] ] )
テーマの機能を設定する。
パラメータ
- $feature機能名。主な機能名と対応バージョンは次の通り。
機能名 対応バージョン 'post-thumbnails' 2.9.0 'automatic-feed-links' 2.9.0 'post-formats' 2.9.0 'custom-header' 3.4.0 'custom-background' 3.4.0 'html5' 3.6.0 'title-tag' 4.1.0 'custom-logo' 4.5.0 'customize-selective-refresh-widgets' 4.5.0 'starter-content' 4.7.0 'responsive-embeds' 5.0.0 'align-wide' 5.0.0 'dark-editor-style' 5.0.0 'disable-custom-colors' 5.0.0 'disable-custom-font-sizes' 5.0.0 'editor-color-pallete' 5.0.0 'editor-font-sizes' 5.0.0 'editor-styles' 5.0.0 'wp-block-styles' 5.0.0 - $args機能のパラメータを指定（省略時は、true）。
返り値
テーマ機能を登録できなかった場合はfalseを返す。
注意
自テーマのfunctions.phpにてadd_action関数を利用し、各種設定を行う関数内（Twenty Tenテーマではtwentyten_setup関数）で使用する。
add_action( 'after_setup_theme', 'twentyten_setup' );
なお3.0で追加されたナビゲーションメニューを追加する場合は、この関数ではなく、register_nav_menus関数を使用する。
パラメータ$featureによって$argsに指定する値が変わる。主なテーマ機能とその内容は次の通り。
| $feature | $argsの内容 |
|---|---|
| 'post-thumbnails' | true（省略可） |
| 'automatic-feed-links' | true（省略可） |
| 'post-formats' | サポートする投稿フォーマット（'aside'、'image'、'video'、'quote'、'link'、'gallery'、'status'、'audio'、'chat'）を格納した配列 |
| 'custom-header' | キー（'default-text-color'（文字列）、'height'（数値）、'width'（数値）、'flex-height'（bool）など）の値を格納した連想配列 |
| 'custom-header-uploads' | true（省略可） |
| 'custom-logo' | キー（'height'（数値）、'width'（数値）、'flex-height'（bool））の値を格納した連想配列 |
| 'html5' | HTML5向けのマークアップ（'search-form'、'comment-form'、'comment-list'、'gallery'、'caption'）を格納した配列 |
| 'title-tag' | true（省略可） |
| 'custom-background' | キー（'default-color'（文字列）、'default-attachment'（文字列））の値を格納した連想配列 |
| 'customize-selective-refresh-widgets' | true（省略可） |
| 'starter-content' | キー（'widgets'（連想配列）、'posts'（連想配列）、'attachments'（連想配列）など）の値を格納した連想配列 |
| 'featured-content' | キー（'featured_content_filter'（文字列）、'max_posts'（数値））の値を格納した連想配列 |
| 'responsive-embeds' | true（省略可） |
| 'align-wide' | true（省略可） |
| 'dark-editor-style' | true（省略可、'editor-styles'も必要） |
| 'disable-custom-colors' | true（省略可） |
| 'disable-custom-font-sizes' | true（省略可） |
| 'editor-color-pallete' | 連想配列を含む配列（連想配列のキーは'name'、'slug'、'color'） |
| 'editor-font-sizes' | 連想配列を含む配列（連想配列のキーは'name'、'shortName'、'size'、'slug'） |
| 'editor-styles' | true（省略可） |
| 'wp-block-styles' | true（省略可） |
本関数のパラメータは可変数で、第2パラメータの内容が配列のインデックス0の値として、第3パラメータの内容がインデックス1の値として、第4パラメータの内容がインデックス2の値としてシステム内に保存される。
使用例
- 投稿編集ページに「アイキャッチ画像」を追加する。<?php add_theme_support( 'post-thumbnails' ); ?>
- 投稿ページに「フォーマット」を追加する。<?php add_theme_support( 'post-formats', array( 'aside', 'link', 'gallery', 'status', 'quote', 'image' ) ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/theme.php最終更新 : 2018年12月07日 09:55
関連
お勧め
子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう（2011年12月8日 更新）
少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。固定ページを投稿ページ用テンプレートファイル（single.php）で表示する（2013年7月31日 更新）
固定ページと投稿ページのデザインが共通の場合、同じ内容のsingle.phpとpage.phpを用意すれば事足りるが、デザインの修正時は二度手間になってしまう。そこで、固定ページをsingle.phpで表示するようにできないか考えてみた。
もうquery_postsは呼ばない（2011年9月27日 更新）
トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭で query_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。使っていないか確認しないとね！（2017年11月18日 更新）
2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここではホームディレクトリから過去のファイルを削除する（2013年1月27日 更新）
WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。