概要
elementor/connect/additional-connect-info フィルタは、Elementorプラグインにおける接続情報をカスタマイズするために使用します。このフィルタを使用すると、外部APIとの統合や追加データの注入などの機能を拡張することが可能です。具体的には、次のようなシナリオでよく利用されます。
- 外部サービスとのセッション管理情報の追加
- ユーザーのカスタムメタデータを接続情報に含める
- 構築したページの分析データ集計
- ユーザーのアクセス権に基づく動的なデータの提供
- 接続先のAPIに送信するリクエストデータの拡張
- デバッグ情報を追加して接続のトラブルシューティングを行う
構文
add_filter( 'elementor/connect/additional-connect-info', 'my_custom_data_function' );
パラメータ
$additional_info(array): 追加接続情報の配列$context(string): 接続の文脈
戻り値
- (array): 変更された追加接続情報
使用可能なプラグインバージョン
- Elementor: バージョン 3.0 以降
使用可能なWordPressバージョン
- WordPress: バージョン 5.0 以降
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| 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 |
サンプルコード
サンプルコード 1: ユーザーIDを接続情報に追加する
このサンプルでは、現在のユーザーのIDを接続情報に追加します。
add_filter( 'elementor/connect/additional-connect-info', function( $additional_info ) {
$additional_info['user_id'] = get_current_user_id();
return $additional_info;
});
引用元: https://elementor.com/developers/
サンプルコード 2: 訪問したページのタイトルを追加する
このコードでは、現在表示しているページのタイトルを接続情報に追加します。
add_filter( 'elementor/connect/additional-connect-info', function( $additional_info ) {
$additional_info['page_title'] = get_the_title();
return $additional_info;
});
引用元: https://elementor.com/developers/
サンプルコード 3: リファラー情報を追加する
このサンプルでは、リファラー情報を接続情報に追加します。
add_filter( 'elementor/connect/additional-connect-info', function( $additional_info ) {
$additional_info['referrer'] = wp_get_referer();
return $additional_info;
});
引用元: https://elementor.com/developers/
サンプルコード 4: カスタムメタデータを接続情報に追加
このコードでは、特定のユーザーのカスタムメタデータを接続情報に追加します。
add_filter( 'elementor/connect/additional-connect-info', function( $additional_info ) {
$user_meta = get_user_meta( get_current_user_id(), 'custom_meta_key', true );
$additional_info['custom_meta'] = $user_meta;
return $additional_info;
});
引用元: https://elementor.com/developers/
サンプルコード 5: タイムスタンプを接続情報に追加
このサンプルでは、現在のタイムスタンプを接続情報に追加します。
add_filter( 'elementor/connect/additional-connect-info', function( $additional_info ) {
$additional_info['timestamp'] = current_time( 'mysql' );
return $additional_info;
});
引用元: https://elementor.com/developers/