説明
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-palette' 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'）を格納した配列 [5.3.0]'script'と'style'が追加された。 |
| '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最終更新 : 2019年12月05日 10:51
関連
お勧め
WordPressと組み込まれている主なJavaScriptライブラリのバージョン一覧（2018年5月27日 更新）
WordPressの更新が遅れていたサイトを少し前に更新したところ、jQuery UI sortableを使って拡張したページに不具合が発生しました。WordPressの更新に伴って内部のjQuery UIが更新されたことに起因すると思われ、これを機にWordPressとそれに組み込まれたJavaScriptライブラリのバージョンを確認してみました。
ホームディレクトリから過去のファイルを削除する（2013年1月27日 更新）
WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。wp_titleからwp_get_document_titleへ（2018年5月27日 更新）
先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。
検索ワード「-10,000円」を検索できるようにしたい（2018年5月27日 更新）
とあるサイトで「-10,000円」をキーワードに検索した際、予想と異なるページが表示され、ちょっと驚いた。今回はその原因調査と対策についてまとめてみた。
ダッシュボードのフィードボックスをカスタマイズ（2011年7月8日 更新）
管理者ページのトップページ「ダッシュボード」には、「WordPress 開発者ブログ」と「WordPress フォーラム」という2つのフィードボックスが表示されている。自分のような開発者には有益な情報をもたらしているが、一般の方には必要のない情報かもしれない。今回はこのフィードボックスをカスタマイズする方法を紹介する（管理者権限）。