add_action()


関数WordPressadd_action()は、カスタムコードをWordPressの特定のフックやアクションに追加するために使用されます。この関数は、テーマやプラグインで機能を拡張するために非常に重要です。

構文

add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 );

引数の説明:

  • $tag (string) — フック名またはアクション名。
  • $function_to_add (callable) — 実行する関数。
  • $priority (int) — 実行の優先順位 (デフォルトは10)。
  • $accepted_args (int) — 関数が受け取る引数の数 (デフォルトは1)。

例 1: ヘッダーにカスタムスクリプトを追加

次のコードは、wp_headフックを使用してカスタムスクリプトを追加します。

add_action('wp_head', function() { echo '<script>console.log("ヘッダーにスクリプトを追加しました");</script>'; });

例 2: 管理画面のフッターにカスタムテキストを追加

管理画面のフッターにテキストを追加する方法です。

add_action('admin_footer', function() { echo '<p>管理画面フッターに追加されたテキスト</p>'; });

例 3: 投稿保存時にカスタム処理を実行

投稿が保存されたときにカスタム関数を実行します。

add_action('save_post', function($post_id) { if(!wp_is_post_revision($post_id)) { error_log('投稿が保存されました: ' . $post_id); } });

例 4: ログインフォームにカスタムメッセージを追加

ログインフォームにカスタムメッセージを表示します。

add_action('login_message', function($message) { return $message . '<p>カスタムメッセージがここに表示されます。</p>'; });

例 5: CSSをフロントエンドに追加

テーマのスタイルを追加する方法です。

add_action('wp_enqueue_scripts', function() { wp_enqueue_style('custom-style', get_stylesheet_directory_uri() . '/css/custom-style.css'); });

注意事項:

  • $priorityが低いほど、早く実行されます。
  • 同じ$tagに複数の関数を追加する場合は、それぞれの優先順位に注意してください。
  • 必要に応じて$accepted_argsを調整してください。

関連機能: