概要
add_media_pageアクションは、WordPressの管理画面において、メディアメニューにサブメニューを登録するために使用されます。このアクションは、独自の設定や管理ページを作成したいときに特に有用です。以下は、add_media_pageアクションがよく使われる機能の例です。
- メディアライブラリの拡張
- カスタムメディア設定ページの作成
- アップロード統計の表示
- メディアタグの管理
- ユーザーによるメディアの権限管理
- メディア関連のカスタムエディターの追加
- カスタムメディアタイプの管理ページ作成
- メディアからのコンテンツインポート機能の追加
構文
add_action('admin_menu', 'custom_media_menu');
function custom_media_menu() {
add_media_page('カスタムメディアタイトル', 'カスタムメディア', 'manage_options', 'custom-media-slug', 'custom_media_page_function');
}
function custom_media_page_function() {
echo '<h1>カスタムメディアページ</h1>';
}
パラメータ
$page_title(string) – ページのタイトル$menu_title(string) – メニューに表示されるタイトル$capability(string) – メニューを表示するためのユーザー権限$menu_slug(string) – メニューのスラグ$function(callable) – メニューがクリックされたときに呼び出される関数
戻り値
このアクションは特定の値を返しませんが、登録が成功した場合には新しいメニューアイテムがWordPressの管理画面に表示されます。
関連する関数
使用可能なバージョン
add_media_pageはWordPressバージョン2.5以降で使用可能です。
コアファイルのパス
wp-admin/menu.php
この関数のアクションでの使用可能性
| アクション名 | 使用例 |
|---|---|
| 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 |
add_media_pageアクションは、特定のバージョンで非推奨または削除された情報はありません。