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

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

プラグイン API/アクションフック一覧/wp head

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「プラグイン 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最新版との差分