説明
パラメータ
- $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 'core-block-patterns' 5.5.0 'editor-gradient-presets' 5.6.0 'experimental-link-color' 5.6.0 'custom-spacing' 5.7.0 'widgets-block-editor' 5.8.0 'block-template-parts' 6.1.0 'link-color' 6.3.0 'border' 6.3.0 'appearance-tools' 6.3.0 'editor-spacing-sizes' 6.6.0 - $args機能のパラメータを指定(省略時は、true)。
返り値
テーマ機能を登録できなかった場合はfalseを返す。
注意
自テーマのfunctions.phpにてadd_action関数を利用し、各種設定を行う関数内(Twenty Tenテーマでは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' | 以下の連想配列
|
'custom-header-uploads' | true(省略可) |
'custom-logo' | 以下の連想配列
|
'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-gradient-presets' | 連想配列を含む配列(連想配列のキーは'name'、'gradient'、'slug') |
'editor-styles' | true(省略可) |
'wp-block-styles' | true(省略可) |
'core-block-patterns' | 標準でtrue |
'experimental-link-color' | true(省略可) |
'custom-spacing' | true(省略可) |
'widgets-block-editor' | true(省略可) |
'block-template-parts' | true(省略可) |
'link-color' | true(省略可) |
'border' | true(省略可) |
'appearance-tools' | true(省略可) |
'editor-spacing-sizes' | 連想配列を含む配列(連想配列のキーは'name'、'slug'、'size') |
本関数のパラメータは可変数で、第2パラメータの内容が配列のインデックス0の値として、第3パラメータの内容がインデックス1の値として、第4パラメータの内容がインデックス2の値としてシステム内に保存される。
[5.6.0]パラメータ$featureが'post-formats'で値が配列以外の場合、警告メッセージ('You need to pass an array of post formats.'の翻訳テキスト)が表示される。
[5.7.0]パラメータ$featureに追加された'custom-spacing'を指定しないと、ブロックエディターの各ブロックにて「サイズ(Dimensions)」に「パディング(Padding)」が表示されない。
使用例
- 投稿編集ページに「アイキャッチ画像」を追加する。<?php add_theme_support( 'post-thumbnails' ); ?>
- 投稿ページに「フォーマット」を追加する。<?php add_theme_support( 'post-formats', array( 'aside', 'link', 'gallery', 'status', 'quote', 'image' ) ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/theme.php最終更新 : 2024年07月22日 14:50
関連
お勧め
CSSやJavaScriptファイルのバージョン番号を変える(2018年5月27日 更新)
WordPress 4.7系の脆弱性をついた攻撃も落ち着いた感じなので、標準でヘッダーやフッター内に出力されるWordPressのバージョン番号について一考しました。
テーブルブロックを投稿メタ(カスタムフィールド)に保存する(2022年1月5日 更新)
ふと「テーブルブロックの内容を投稿メタ(カスタムフィールド)として保存できたら便利なのでは」と思い、投稿メタの使い方を調べてみた。
カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 更新)
カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。
Fotepo:プラグイン作ってみました(2019年9月19日 更新)
仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。
5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)
この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。