説明
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
関連
お勧め
ログインページのタイトルを変更してみる（2018年5月27日 更新）
バージョン4.9では新しいフィルターやフィルターのパラメータの追加が多数行われている。ここではその一例としてログインページ関連で追加された2つのフィルターを紹介する。
子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう（2011年12月8日 更新）
少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。meta_compare_key使ってみた（2019年3月19日 更新）
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名（メタキー）に含まれる文字列を指定する'meta_compare_key'キーだ。
各種リンクを取得する関数一覧（2014年6月12日 更新）
サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク（パーマリンク）を取得する関数を用意しており、それらを一通り把握しておくべきだろう。
Login rebuilder：プラグイン作ってみました（2019年4月22日 更新）
昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。