• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「プラグイン API/アクションフック一覧/wp head」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Plugin API/Action Reference/wp_head 17:33, 17 September 2010 bono 版を翻訳用にコピー、リンク調整)
 
 
(2人の利用者による、間の6版が非表示)
1行目: 1行目:
{{NeedTrans}}
+
{{CheckTrans}}
  
==Description==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
The '''<tt>wp_head</tt> action hook''' is triggered within the <tt><head></head></tt> section of [[Theme Development#Template Files|the user's template]] by the [[関数リファレンス/wp_footer|<tt>wp_head()</tt> function]]. Although this is theme-dependent, it is one of the most essential theme hooks, so it is fairly widely supported.
+
'''<tt>wp_head</tt> アクションフック''' は[[Theme Development#Template Files|ユーザーのテンプレート]]内の <tt><head></head></tt> セクションにおいて、[[関数リファレンス/wp_footer|<tt>wp_head()</tt> 関数]]を呼び出したときに起動されます。これはテーマに依存しますが、最も重要なテーマのフックの1つであるので、かなり広くサポートされています。
  
This hook provides no parameters. You use this hook by having your function echo output to the browser, or by having it perform background tasks. Your functions shouldn't return, and shouldn't take any parameters.
+
この関数 <tt>wp_head()</tt> は単純に言えばラッパーです:
 +
<pre>
 +
<?php
 +
do_action( 'wp_head' );
 +
?>
 +
</pre>
  
This hook is theme-dependent which means that it is up to the author of each WordPress theme to include it. It may not be available on all themes, so you should take this into account when using it.
+
このフックはパラメータを持ちません。あなたの関数がブラウザーへ何かを出力するため、またはバックグラウンドで何か処理を行うためにこのフックを使います。関数は値を返すべきではなく、パラメータをとるべきでもありません。
  
This hook is an action which means that it primarily acts as an event trigger, instead of a content filter. This is a semantic difference, but it will help you to remember what this hook does if you use it like this:
+
このフックがテーマに依存するのは、WordPress テーマ作者それぞれにこれを含めるかどうかが任されているからです。すべてのテーマで利用可能とは限らないので、使うときはそのことを考慮してください。
 +
 
 +
このフックはアクションです。コンテンツを処理するフィルターとは異なり、基本的にイベント発生時に何かを起動します。これは構文上の違いですが、次のように使ったときにフックが何をするか覚えておくと良いでしょう:
  
 
<pre>
 
<pre>
 
<?php
 
<?php
add_action('wp_head', 'your_function');
+
add_action( 'wp_head', 'your_function' );
 
?>
 
?>
 
</pre>
 
</pre>
  
See [[Plugin API#Actions|Plugin API - Actions]] for more detail.
+
詳細については [[Plugin API#Actions|プラグイン API - アクション]] を見てください。
  
== Default Actions ==
+
<div id="Default_Actions">
 +
== デフォルトのアクション ==
 +
</div>
  
Most of default actions into the <tt>'wp-head'</tt> hook by WordPress core are setted up in {{Source|wp-includes/default-filters.php}}. If you need to [[Plugin API#Removing Actions and Filters|remove]] a default hook, this file will give you the priority for which to use to remove the hook.
+
<tt>'wp-head'</tt> フックには WordPress コアのデフォルトのアクションがあります。そのほとんどは {{Trac|wp-includes/default-filters.php}} の中で設定されます。もしデフォルトのフックを[[Plugin API#Removing Actions and Filters|削除する]]必要があるなら、フックの削除に必要なプライオリティの値がこのファイルでわかります。
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
wp_head アクションを使って head セクションへカスタム CSS を追加します。
 +
 
 +
<pre>
 +
add_action( 'wp_head', 'hook_css' );
 +
 
 +
function hook_css() {
 +
$output = "<style> .wp_head_example { background-color : #f1f1f1; } </style>";
 +
echo $output;
 +
}
 +
</pre>
 +
 
 +
wp_head アクションを使って head セクションへカスタム JavaScript を追加します。
 +
 
 +
<pre>
 +
add_action( 'wp_head', 'hook_javascript' );
 +
 
 +
function hook_javascript() {
 +
$output = "<script> alert('Page is loading...'); </script>";
 +
echo $output;
 +
}
 +
</pre>
  
== Source File ==
+
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
  
<tt>wp_head</tt> action hook is located in {{Trac|wp-includes/general-template.php}}
+
<tt>wp_head</tt> アクションフックは、{{Trac|wp-includes/general-template.php}} にあります。
  
== See also ==
+
<div id="See_also">
 +
== 関連項目 ==
 +
</div>
  
* [[Plugin API]]
+
* [[Plugin API|プラグイン API]]
* [[Plugin API/Action Reference]]
+
* [[Plugin API/Action Reference|プラグイン API/アクションフック一覧]]
  
 
{{Stub}}
 
{{Stub}}
  
{{原文|Plugin API/Action Reference/wp_head|93070}}<!-- 17:33, 17 September 2010 bono 版 -->
+
{{原文|Plugin API/Action Reference/wp_head|152704}} <!-- 14:59, 22 July 2015 Sormano 版 -->
  
[[Category:Actions]]
+
{{DEFAULTSORT:Wp_head}}
 +
[[Category:アクションフック]]
  
 
[[en:Plugin API/Action Reference/wp_head]]
 
[[en:Plugin API/Action Reference/wp_head]]
 +
[[it:API dei Plugin/Riferimento azioni/wp_head]]

2016年5月12日 (木) 11:51時点における最新版

この項目「プラグイン API/アクションフック一覧/wp head」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

wp_head アクションフックユーザーのテンプレート内の <head></head> セクションにおいて、wp_head() 関数を呼び出したときに起動されます。これはテーマに依存しますが、最も重要なテーマのフックの1つであるので、かなり広くサポートされています。

この関数 wp_head() は単純に言えばラッパーです:

<?php
do_action( 'wp_head' );
?>

このフックはパラメータを持ちません。あなたの関数がブラウザーへ何かを出力するため、またはバックグラウンドで何か処理を行うためにこのフックを使います。関数は値を返すべきではなく、パラメータをとるべきでもありません。

このフックがテーマに依存するのは、WordPress テーマ作者それぞれにこれを含めるかどうかが任されているからです。すべてのテーマで利用可能とは限らないので、使うときはそのことを考慮してください。

このフックはアクションです。コンテンツを処理するフィルターとは異なり、基本的にイベント発生時に何かを起動します。これは構文上の違いですが、次のように使ったときにフックが何をするか覚えておくと良いでしょう:

<?php
add_action( 'wp_head', 'your_function' );
?>

詳細については プラグイン API - アクション を見てください。

デフォルトのアクション

'wp-head' フックには WordPress コアのデフォルトのアクションがあります。そのほとんどは wp-includes/default-filters.php の中で設定されます。もしデフォルトのフックを削除する必要があるなら、フックの削除に必要なプライオリティの値がこのファイルでわかります。

用例

wp_head アクションを使って head セクションへカスタム CSS を追加します。

add_action( 'wp_head', 'hook_css' );

function hook_css() {
	$output = "<style> .wp_head_example { background-color : #f1f1f1; } </style>";
	echo $output;
}

wp_head アクションを使って head セクションへカスタム JavaScript を追加します。

add_action( 'wp_head', 'hook_javascript' );

function hook_javascript() {
	$output = "<script> alert('Page is loading...'); </script>";
	echo $output;
}

ソースファイル

wp_head アクションフックは、wp-includes/general-template.php にあります。

関連項目

このページ「プラグイン API/アクションフック一覧/wp head」はまだ書きかけで、情報が不足しています。続きを書いて WordPress を手助けしましょう.


最新英語版: WordPress Codex » Plugin API/Action Reference/wp_head最新版との差分