概要
elementor/admin/create_new_post/meta
アクションは、Elementor プラグイン内で新しい投稿を作成する際に、カスタムメタデータを設定するために使用されます。このフックは、特に以下のような機能を実装する際によく使用されます:
- 投稿のメタ情報を追加する。
- Elementor ウィジェットの状態を管理する。
- カスタムフィールドの設定を行う。
- 投稿形成プロセスにおけるカスタマイズを行う。
- 新規投稿時のデフォルト値を設定する。
- 他のプラグインと連携するためのデータ添付を行う。
構文
add_action('elementor/admin/create_new_post/meta', 'your_custom_function');
パラメータ
$post_id
: 新しく作成される投稿のID。$data
: 新しく作成する投稿に関連したデータの配列。
戻り値
このアクション自体は値を返しませんが、メタデータを設定するためのカスタムロジックを実装することができます。
Elementor バージョン
このアクションは、Elementor のバージョン 2.0 以上で利用可能です。
WordPress バージョン
WordPress のバージョン 5.2 以上で利用可能です。
サンプルコード
以下に、elementor/admin/create_new_post/meta
アクションを使用したさまざまなサンプルコードを示します。
サンプル 1: カスタム投稿メタの追加
このコードは、新しい投稿が作成される際にカスタムメタデータ「custom_meta」を追加します。
add_action('elementor/admin/create_new_post/meta', function($post_id, $data) {
update_post_meta($post_id, 'custom_meta', 'Your Custom Value');
});
サンプル 2: 投稿作成時にカテゴリを自動設定
新しい投稿が作成される際に、特定のカテゴリを自動的に設定するサンプルコードです。
add_action('elementor/admin/create_new_post/meta', function($post_id, $data) {
$default_category_id = 3; // ここにカテゴリ ID を指定
wp_set_post_categories($post_id, array($default_category_id));
});
サンプル 3: カスタムフィールドを追加する
このコードは、投稿作成時に「custom_field」というカスタムフィールドを追加して、特定のデータを格納します。
add_action('elementor/admin/create_new_post/meta', function($post_id, $data) {
update_post_meta($post_id, 'custom_field', 'Some Value');
});
サンプル 4: カスタムタクソノミーの追加
この例では、新しい投稿が作成される際にカスタムタクソノミーを追加しています。
add_action('elementor/admin/create_new_post/meta', function($post_id, $data) {
wp_set_object_terms($post_id, 'custom_taxonomy_value', 'custom_taxonomy');
});
サンプル 5: 新しい投稿にユーザー情報を含める
新規投稿のメタデータとして、投稿者のユーザー情報を追加するサンプルコードです。
add_action('elementor/admin/create_new_post/meta', function($post_id, $data) {
$user_id = get_current_user_id();
update_post_meta($post_id, 'author_user_id', $user_id);
});
この関数のアクションでの使用可能性
アクション | 使用例 |
---|---|
mu_plugin_loaded | |
registered_post_type | |
plugins_loaded | |
wp_roles_init | |
setup_theme | |
after_setup_theme | |
set_current_user | |
init | |
register_sidebar | |
wp_loaded | |
send_headers | |
parse_query | |
pre_get_posts | |
wp | |
template_redirect | |
get_header | |
wp_head |