populate_network_meta()


WordPressのpopulate_network_meta()関数は、ネットワークメタデータをデータベースから取得しキャッシュするために使用されます。マルチサイト環境で動作します。

構文

populate_network_meta( int $network_id, array $network_meta = array() );

引数の説明:

  • $network_id(int)—メタデータを取得するネットワークのID
  • $network_meta(array)—既存のネットワークメタデータ配列

例1:基本的なネットワークメタデータの取得

指定したネットワークIDのメタデータを取得します。

populate_network_meta( get_current_network_id() );

例2:カスタムメタデータ配列とのマージ

既存のメタデータ配列に新しい値を追加します。

$meta = array('site_name' => 'テストサイト'); populate_network_meta(1, $meta);

例3:ネットワークオプションの更新

メタデータ取得後にオプションを更新します。

populate_network_meta(1); update_network_option(1, 'admin_email', 'new@example.com');

例4:条件付きメタデータ読み込み

特定の条件下でのみメタデータを読み込みます。

if(!is_main_network()){ populate_network_meta(get_current_network_id()); }

例5:フックとの併用

populate_network_meta実行後にアクションを追加します。

add_action('populate_network_meta', 'my_callback'); populate_network_meta(1);

例6:エラーハンドリング

関数実行結果を変数に格納して処理します。

$result = populate_network_meta(1); if(!$result){ /* エラー処理 */ }

例7:複数ネットワークの処理

複数のネットワークに対してメタデータを取得します。

foreach(get_networks() as $network){ populate_network_meta($network->id); }

注意事項

  • マルチサイト環境でのみ使用可能
  • データベースクエリが発生するため過度な呼び出しは避ける
  • 返り値はキャッシュ状態に依存

関連機能：