wp_get_plugin_action_button()


WordPressのwp_get_plugin_action_button()関数は、プラグインのアクションボタン（有効化、無効化、削除など）を生成するために使用されます。

構文

wp_get_plugin_action_button( string $plugin_file, array $plugin_data );

引数の説明:

  • $plugin_file(string) — プラグインファイルのパス。
  • $plugin_data(array) — プラグインのデータを含む配列。

例1: プラグインのアクションボタンを表示

この例では、指定されたプラグインのアクションボタンを表示します。

echo wp_get_plugin_action_button( 'my-plugin/my-plugin.php', array( 'Name' => 'My Plugin' ) );

例2: 特定のプラグインのアクションボタンを取得

この例では、特定のプラグインのアクションボタンを取得し、変数に格納します。

$action_button = wp_get_plugin_action_button( 'my-plugin/my-plugin.php', array( 'Name' => 'My Plugin' ) );

例3: プラグインのアクションボタンをカスタマイズ

この例では、プラグインのアクションボタンをカスタマイズして表示します。

$plugin_data = array( 'Name' => 'My Plugin', 'Version' => '1.0.0' ); echo wp_get_plugin_action_button( 'my-plugin/my-plugin.php', $plugin_data );

例4: 複数のプラグインのアクションボタンを表示

この例では、複数のプラグインのアクションボタンを一度に表示します。

$plugins = array( 'plugin1/plugin1.php', 'plugin2/plugin2.php' ); foreach ( $plugins as $plugin ) { echo wp_get_plugin_action_button( $plugin, array( 'Name' => 'Plugin' ) ); }

例5: プラグインのアクションボタンをフィルタリング

この例では、プラグインのアクションボタンをフィルタリングして表示します。

add_filter( 'plugin_action_links', function( $actions, $plugin_file, $plugin_data ) { return $actions; }, 10, 3 ); echo wp_get_plugin_action_button( 'my-plugin/my-plugin.php', array( 'Name' => 'My Plugin' ) );

例6: プラグインのアクションボタンを非表示にする

この例では、特定の条件でプラグインのアクションボタンを非表示にします。

if ( ! current_user_can( 'activate_plugins' ) ) { return; } echo wp_get_plugin_action_button( 'my-plugin/my-plugin.php', array( 'Name' => 'My Plugin' ) );

例7: プラグインのアクションボタンをカスタムテキストで表示

この例では、プラグインのアクションボタンをカスタムテキストで表示します。

$plugin_data = array( 'Name' => 'My Plugin', 'Version' => '1.0.0' ); echo wp_get_plugin_action_button( 'my-plugin/my-plugin.php', $plugin_data );

注意点:

  • この関数は、プラグインの管理画面でのみ使用することを推奨します。
  • プラグインの状態によって表示されるボタンが異なるため、適切な条件で使用してください。

関連機能：