当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/add theme support」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(見出しを翻訳)
(翻訳済み div無し)
2行目: 2行目:
 
== 説明<!--Description--> ==
 
== 説明<!--Description--> ==
  
Allows a theme to register support of a certain feature.  This should be called in the theme's <tt>functions.php</tt> file.
+
この関数により、テーマが特定の機能をサポートすることができます。テーマの <tt>functions.php</tt> ファイルで呼び出してください。
  
 
== 使い方<!--Usage--> ==
 
== 使い方<!--Usage--> ==
10行目: 10行目:
 
== パラメータ<!--Parameters--> ==
 
== パラメータ<!--Parameters--> ==
  
{{Parameter|$feature|string|Name for the feature the feature being added.}}
+
{{Parameter|$feature|文字列|追加する機能の名前。}}
  
Features list:
+
機能リスト:
 
* 'custom-header'
 
* 'custom-header'
 
* 'custom-background'
 
* 'custom-background'
24行目: 24行目:
 
=== カスタムヘッダー<!--Custom Header--> ===
 
=== カスタムヘッダー<!--Custom Header--> ===
 
  <?php add_theme_support('custom-header'); ?>
 
  <?php add_theme_support('custom-header'); ?>
This option enables custom-header support for a Theme. With this option enabled, the [[Appearance Header SubPanel]] is made available, enabling the user to upload and/or specify a custom header image or color. This option became available with [[Version 3.0]].
+
このオプションで、テーマでカスタムヘッダーがサポートされます。このオプションを有効にすると、[[管理パネル/外観/ヘッダー]]が利用可能になり、ユーザーがカスタムヘッダー画像をアップロード/色を指定できます。このオプションは、[[Version 3.0]] から利用可能です。
  
This option is used internally, and should not be called directly by a Theme. Instead, use [[Function_Reference/add_custom_image_header|add_custom_image_header()]] in functions.php:
+
このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php で[[関数リファレンス/add_custom_image_header|add_custom_image_header()]] /[[:en:Function_Reference/add_custom_image_header|en]] を使用してください。
  
 
=== カスタム背景<!--Custom Background--> ===
 
=== カスタム背景<!--Custom Background--> ===
 
  <?php add_theme_support('custom-background'); ?>
 
  <?php add_theme_support('custom-background'); ?>
This option enables custom-background support for a Theme. With this option enabled, the [[Appearance Background SubPanel]] is made available, enabling the user to upload and/or specify a custom background image or color. This option became available with [[Version 3.0]].
+
このオプションで、テーマでカスタム背景がサポートされます。このオプションを有効にすると、[[管理パネル/外観/背景]]が利用可能になり、ユーザーがカスタム背景をアップロード/色を師弟できます。このオプションは、[[Version 3.0]] から利用可能です。
  
This option is used internally, and should not be called directly by a Theme. Instead, use [[Function_Reference/add_custom_background|add_custom_background()]] in functions.php:
+
このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php で[[関数リファレンス/add_custom_background|add_custom_background()]]/[[:en:Function_Reference/add_custom_background|en]] を使用してください。
  
Default usage:
+
デフォルトの使い方:
 
  <?php add_custom_background(); ?>
 
  <?php add_custom_background(); ?>
  
 
=== アイキャッチ画像<!--Post Thumbnails--> ===
 
=== アイキャッチ画像<!--Post Thumbnails--> ===
 
  <?php add_theme_support('post-thumbnails'); ?>
 
  <?php add_theme_support('post-thumbnails'); ?>
This option enables post-thumbnail support for a Theme.  This option became available with [[Version 2.9]].
+
このオプションで、テーマでアイキャッチ画像(投稿サムネイル)がサポートされます。このオプションは、[[Version 2.9]] から利用可能です。
  
This option must be called before the init hook is fired. That means it needs to be placed directly into functions.php or within a function attached to the after_setup_theme hook:
+
このオプションは、init フックが実行されるよりm前に呼び出ししなければなりません。すなわち、functions.php に直接記述するか、after_setup_theme フックに付加される関数内に記述する必要があります。
  
 
====アイキャッチ画像の表示<!--Displaying post thumbnails-->====
 
====アイキャッチ画像の表示<!--Displaying post thumbnails-->====
50行目: 50行目:
 
====アイキャッチ画像が割り当てられているかチェックしてから表示する<!--Checking if thumbnail assigned before displaying-->====
 
====アイキャッチ画像が割り当てられているかチェックしてから表示する<!--Checking if thumbnail assigned before displaying-->====
  
Check if there is a post thumbnail assigned to the post before displaying it.
+
アイキャッチ画像が投稿に割り当てられているかチェックし、アイキャッチ画像を表示する例です。
  
 
  if (has_post_thumbnail()) {
 
  if (has_post_thumbnail()) {
58行目: 58行目:
 
===ナビゲーションメニュー<!--Navigation Menus-->===
 
===ナビゲーションメニュー<!--Navigation Menus-->===
 
  <?php add_theme_support('menus'); ?>
 
  <?php add_theme_support('menus'); ?>
This option enables Theme support for the naviagation menu ability.  This option became available with [[Version 3.0]].
+
このオプションで、テーマでナビゲーションメニューがサポートされます。このオプションは、[[Version 3.0]] から利用可能です。
  
When registering custom menus with [[Function_Reference/register_nav_menus|register_nav_menus()]] you do not need to call add_theme_support( 'menus' ). register_nav_menus() automatically registers custom menu support for the theme.
+
[[関数リファレンス/register_nav_menus|register_nav_menus()]]/[[:en:Function_Reference/register_nav_menus|en]] でカスタムメニューを登録するとき、add_theme_support( 'menus' ) を呼び出す必要はありません。register_nav_menus() はカスタムメニューサポートを自動的に登録します。
  
 
===フィードリンク<!--Feed Links-->===
 
===フィードリンク<!--Feed Links-->===
 
  <?php add_theme_support('automatic-feed-links'); ?>
 
  <?php add_theme_support('automatic-feed-links'); ?>
This option enables post and comment RSS feed links to head.  This should be used in place of the deprecated ''automatic_feed_links''.  This option became available with [[Version 3.0]].
+
このオプションで、投稿とコメントの RSS フィードリンクがサポートされます。非推奨となった ''automatic_feed_links'' の代わりに使用してください。このオプションは、[[Version 3.0]] から利用可能です。
  
 
=== エディタのスタイル<!--Editor Style--> ===
 
=== エディタのスタイル<!--Editor Style--> ===
 
  <?php add_theme_support('editor-style'); ?>
 
  <?php add_theme_support('editor-style'); ?>
This option enables custom Visual Editor CSS support for a Theme. With this option enabled, the Theme can provide a custom CSS file (<tt>editor-style.css</tt>) that will allow the Visual Editor display to coincide with the visual output of the Theme itself. This option became available with [[Version 3.0]].
+
このオプションで、テーマでカスタムビジュアルエディタ CSS がサポートされます。このオプションを有効にすると、テーマはカスタム CSS ファイル (<tt>editor-style.css</tt>) を提供し、ビジュアルエディタの表示とテーマ自身の表示を一致させることができます。このオプションは、[[Version 3.0]] から利用可能です。
  
This option is used internally, and should not be called directly by a Theme. Instead, use [[Function_Reference/add_editor_style|add_editor_style()]] in functions.php:
+
このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php で[[関数リファレンス/add_editor_style|add_editor_style()]]/[[:en:Function_Reference/add_editor_style|en]] を使用してください。
  
Default usage:
+
デフォルトの使い方:
 
  <?php add_editor_style(); ?>
 
  <?php add_editor_style(); ?>
Custom Visual Editor style sheet filename:
+
カスタムビジュアルエディタスタイルシートのファイル名:
 
  <?php add_editor_style('editor-style'); ?>
 
  <?php add_editor_style('editor-style'); ?>
Where <tt>'editor-style'</tt> is the name of the CSS file that contains the Visual Editor CSS information. (Note: defaults to 'editor-style.css')
+
ここで、<tt>'editor-style'</tt> はビジュアルエディタ CSS 情報のある CSS ファイルの名前です。(: デフォルトは 'editor-style.css')
  
 
== 注<!--Notes--> ==
 
== 注<!--Notes--> ==
82行目: 82行目:
 
== 変更履歴<!--Change Log--> ==
 
== 変更履歴<!--Change Log--> ==
  
* [[Version 2.9|2.9]]: Introdeced with <tt>'post-thumbnails'</tt> feature
+
* [[Version 2.9|2.9]]: <tt>'post-thumbnails'</tt> 機能導入
* [[Version 3.0|3.0]]: Added <tt>'menus'</tt>, <tt>'automatic-feed-links'</tt>, <tt>'custom-header'</tt>, <tt>'custom-background'</tt> and <tt>'editor-style'</tt> features
+
* [[Version 3.0|3.0]]: <tt>'menus'</tt>, <tt>'automatic-feed-links'</tt>, <tt>'custom-header'</tt>, <tt>'custom-background'</tt>, <tt>'editor-style'</tt> 機能追加
  
 
== ソースファイル<!--Source File--> ==
 
== ソースファイル<!--Source File--> ==
  
<tt>add_theme_support()</tt> is located in {{Trac|wp-includes/theme.php}}.
+
<tt>add_theme_support()</tt> は、{{Trac|wp-includes/theme.php}} にあります。
  
 
== 関連<!--Related--> ==
 
== 関連<!--Related--> ==

2010年9月3日 (金) 20:27時点における版

このページ「関数リファレンス/add theme support」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

この関数により、テーマが特定の機能をサポートすることができます。テーマの functions.php ファイルで呼び出してください。

使い方

<?php add_theme_support( $feature ); ?>

パラメータ

$feature
文字列) (必須) 追加する機能の名前。
初期値: なし

機能リスト:

  • 'custom-header'
  • 'custom-background'
  • 'post-thumbnails'
  • 'menus'
  • 'automatic-feed-links'
  • 'editor-style'

追加できる機能

カスタムヘッダー

<?php add_theme_support('custom-header'); ?>

このオプションで、テーマでカスタムヘッダーがサポートされます。このオプションを有効にすると、管理パネル/外観/ヘッダーが利用可能になり、ユーザーがカスタムヘッダー画像をアップロード/色を指定できます。このオプションは、Version 3.0 から利用可能です。

このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php でadd_custom_image_header() /en を使用してください。

カスタム背景

<?php add_theme_support('custom-background'); ?>

このオプションで、テーマでカスタム背景がサポートされます。このオプションを有効にすると、管理パネル/外観/背景が利用可能になり、ユーザーがカスタム背景をアップロード/色を師弟できます。このオプションは、Version 3.0 から利用可能です。

このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php でadd_custom_background()/en を使用してください。

デフォルトの使い方:

<?php add_custom_background(); ?>

アイキャッチ画像

<?php add_theme_support('post-thumbnails'); ?>

このオプションで、テーマでアイキャッチ画像(投稿サムネイル)がサポートされます。このオプションは、Version 2.9 から利用可能です。

このオプションは、init フックが実行されるよりm前に呼び出ししなければなりません。すなわち、functions.php に直接記述するか、after_setup_theme フックに付加される関数内に記述する必要があります。

アイキャッチ画像の表示

// in your theme index.php or single.php or custom templates
the_post_thumbnail();

アイキャッチ画像が割り当てられているかチェックしてから表示する

アイキャッチ画像が投稿に割り当てられているかチェックし、アイキャッチ画像を表示する例です。

if (has_post_thumbnail()) {
  the_post_thumbnail();
}

ナビゲーションメニュー

<?php add_theme_support('menus'); ?>

このオプションで、テーマでナビゲーションメニューがサポートされます。このオプションは、Version 3.0 から利用可能です。

register_nav_menus()/en でカスタムメニューを登録するとき、add_theme_support( 'menus' ) を呼び出す必要はありません。register_nav_menus() はカスタムメニューサポートを自動的に登録します。

フィードリンク

<?php add_theme_support('automatic-feed-links'); ?>

このオプションで、投稿とコメントの RSS フィードリンクがサポートされます。非推奨となった automatic_feed_links の代わりに使用してください。このオプションは、Version 3.0 から利用可能です。

エディタのスタイル

<?php add_theme_support('editor-style'); ?>

このオプションで、テーマでカスタムビジュアルエディタ CSS がサポートされます。このオプションを有効にすると、テーマはカスタム CSS ファイル (editor-style.css) を提供し、ビジュアルエディタの表示とテーマ自身の表示を一致させることができます。このオプションは、Version 3.0 から利用可能です。

このオプションは内部で使用されます。テーマで直接呼び出すべきではありません。代わりに、functions.php でadd_editor_style()/en を使用してください。

デフォルトの使い方:

<?php add_editor_style(); ?>

カスタムビジュアルエディタスタイルシートのファイル名:

<?php add_editor_style('editor-style'); ?>

ここで、'editor-style' はビジュアルエディタ CSS 情報のある CSS ファイルの名前です。(注: デフォルトは 'editor-style.css')

変更履歴

  • 2.9: 'post-thumbnails' 機能導入
  • 3.0: 'menus', 'automatic-feed-links', 'custom-header', 'custom-background', 'editor-style' 機能追加

ソースファイル

add_theme_support() は、wp-includes/theme.php にあります。

関連

テーマサポート: add_theme_support(), remove_theme_support(), current_theme_supports()
テーマ機能: サイドバー, ナビゲーションメニュー, 投稿フォーマット, 投稿サムネイル, カスタム背景, カスタムヘッダー, 自動フィードリンク, html5, コンテンツ幅, editor-style



関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/add theme support最新版との差分