wp_is_auto_update_forced_for_item()


WordPressのwp_is_auto_update_forced_for_item()関数は、特定のアイテム(テーマやプラグイン)に対して自動更新が強制されているかどうかを判定します。

構文

wp_is_auto_update_forced_for_item( string $type, string $item );

引数の説明:

  • $type (string) — アイテムのタイプ(’theme’ または ‘plugin’)
  • $item (string) — テーマの場合はスラッグ、プラグインの場合はベースネーム

例1: テーマの自動更新が強制されているか確認

現在有効なテーマの自動更新が強制されているかチェックします。

wp_is_auto_update_forced_for_item( 'theme', get_stylesheet() );

例2: プラグインの自動更新ステータスを確認

特定のプラグインの自動更新が強制されているかどうかを確認します。

wp_is_auto_update_forced_for_item( 'plugin', 'akismet/akismet.php' );

例3: 複数テーマの自動更新ステータスをチェック

複数のテーマに対して自動更新が強制されているかどうかをループで確認します。

foreach ( wp_get_themes() as $theme ) { wp_is_auto_update_forced_for_item( 'theme', $theme->get_stylesheet() ); }

例4: フィルターフックとの組み合わせ

auto_update_pluginフィルターと組み合わせて使用します。

add_filter( 'auto_update_plugin', function( $update, $item ) { return wp_is_auto_update_forced_for_item( 'plugin', $item->plugin ); }, 10, 2 );

例5: 管理画面での条件分岐

管理画面で特定の条件に基づいて自動更新の強制ステータスを表示します。

if ( wp_is_auto_update_forced_for_item( 'theme', 'twentytwentyone' ) ) { echo 'このテーマは自動更新が強制されています'; }

例6: プラグイン有効化時のチェック

プラグイン有効化時に自動更新が強制されているかどうかを確認します。

register_activation_hook( __FILE__, function() { if ( wp_is_auto_update_forced_for_item( 'plugin', plugin_basename( __FILE__ ) ) ) { // 処理 } } );

例7: バッチ処理での使用

複数のプラグインに対して一括で自動更新の強制ステータスを確認します。

array_map( function( $plugin ) { return wp_is_auto_update_forced_for_item( 'plugin', $plugin ); }, get_option( 'active_plugins' ) );

注意点

  • この関数はWordPress 5.5以降で利用可能です
  • 戻り値はブール値(true/false)です
  • 自動更新の設定はwp-config.phpやフィルターで変更可能です