• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/remove submenu page」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/remove submenu page 21:39, 23 August 2018‎ Bookchiq 版)
 
(和訳完了)
1行目: 1行目:
== Description ==
+
== 説明<span id="Description"></span> ==
Remove an admin submenu.
+
管理画面のサブレベルのメニューを取り除く。
  
Depending on when this function is called, it may not prevent users from accessing the screen for the removed submenu directly (see [https://core.trac.wordpress.org/ticket/18850 ticket #18850]). Removing a menu does not replace the need to filter a user's permissions as appropriate.
+
この関数が呼び出されるタイミングにによっては、ユーザーが削除されたサブメニューの画面に直接アクセスすることを妨げない場合があります(参照:[https://core.trac.wordpress.org/ticket/18850 ticket #18850])。
 +
メニューを削除したからといって、ユーザー権限を適切にフィルタリングする必要が無くなるわけではありません。
  
== Usage ==
+
== 使い方<span id="Usage"></span> ==
 
<pre>
 
<pre>
 
<?php remove_submenu_page( $menu_slug, $submenu_slug ); ?>
 
<?php remove_submenu_page( $menu_slug, $submenu_slug ); ?>
 
</pre>
 
</pre>
  
== Parameters ==
+
== パラメータ<span id="Parameters"></span> ==
{{Parameter|$menu_slug|string|The slug for the parent menu}}
+
{{Parameter|$menu_slug|string|親メニューのスラッグ}}
{{Parameter|$submenu_slug|string|The slug of the submenu}}
+
{{Parameter|$submenu_slug|string|サブメニューのスラッグ}}
  
== Return Values ==
+
== 戻り値<span id="Return_Values"></span> ==
; (array&#124;boolean) : The removed submenu on success, <tt>false</tt> if not found.
+
; (配列&#124;真偽値) : 成功した場合、取り除いたサブメニュー。失敗した場合、<tt>false</tt>
  
== Examples ==
+
== 用例<span id="Examples"></span> ==
 
<!-- Need creative examples. Feel free to link to external examples. -->
 
<!-- Need creative examples. Feel free to link to external examples. -->
Removes the Widgets submenu page.
+
ウィジェットのサブメニューページを削除する。
  
 
<pre>
 
<pre>
 
function wpcodex_adjust_the_wp_menu() {
 
function wpcodex_adjust_the_wp_menu() {
 
$page = remove_submenu_page( 'themes.php', 'widgets.php' );
 
$page = remove_submenu_page( 'themes.php', 'widgets.php' );
// $page[0] is the menu title
+
// $page[0]:メニューのタイトル
// $page[1] is the minimum level or capability required
+
// $page[1]:必要な最低限のユーザーレベルまたは権限
// $page[2] is the URL to the item's file
+
// $page[2]:ファイルのURL
 
}
 
}
 
add_action( 'admin_menu', 'wpcodex_adjust_the_wp_menu', 999 );
 
add_action( 'admin_menu', 'wpcodex_adjust_the_wp_menu', 999 );
 
</pre>
 
</pre>
  
In the above example, the value of <tt>$page</tt> would have been:
+
上記の例では、<tt>$page</tt>の値は
 
<pre>
 
<pre>
 
array(3) { [0]=> string(7) "Widgets" [1]=> string(18) "edit_theme_options" [2]=> string(11) "widgets.php" }
 
array(3) { [0]=> string(7) "Widgets" [1]=> string(18) "edit_theme_options" [2]=> string(11) "widgets.php" }
 
</pre>
 
</pre>
  
To remove a settings page for plugins that use a slug like /wp-admin/options-general.php?page=certain-plugin-settings use this code:
+
/wp-admin/options-general.php?page=certain-plugin-settings のようなスラッグを使用するプラグインの設定ページを取り除くには次のコードを用いる。
 
<pre>
 
<pre>
 
add_action( 'admin_menu', 'nstrm_remove_admin_submenus', 999 );
 
add_action( 'admin_menu', 'nstrm_remove_admin_submenus', 999 );
43行目: 44行目:
 
</pre>
 
</pre>
  
[https://gist.github.com/michael-cannon/6701832 Remove custom post type submenu pages]. The secret is in converting the second argument `&` to `&amp;amp;`.
+
[https://gist.github.com/michael-cannon/6701832 Remove custom post type submenu pages]
 +
ポイントは第2引数 `&` `&amp;amp;` に変換することです。
  
== Notes ==
+
== 参考<span id="Notes"></span> ==
* Uses global: (<tt>array</tt>) <tt>$submenu</tt>
+
* グローバル変数 (<tt>array</tt>) <tt>$submenu</tt>を使用
* In order to remove the <tt>theme-editor.php</tt> submenu of <tt>themes.php</tt> (and others) in more recent versions of WordPress, you need to bind to the <tt>admin_menu</tt> hook with a very high priority (about <tt>110</tt>, depending on the submenus to remove). Don't use <tt>admin_init</tt> as previously stated here, hence it will break <tt>wp-admin/admin-ajax.php</tt>.
+
* より最近のバージョンのWordPressで <tt>themes.php</tt> のサブメニュー <tt>theme-editor.php</tt> などを削除するには、<tt>admin_menu</tt> フックに非常に高い優先度でバインドする必要があります(<tt>110</tt> など、削除するサブメニューに応じて)。<tt>admin_init</tt> フックは使用しないでください。<tt>wp-admin/admin-ajax.php</tt> を破損します。
  
== Change Log ==
+
== 変更履歴<span id="Change_Log"></span> ==
 
Since: 3.1.0
 
Since: 3.1.0
  
== Source File ==
+
== ソースファイル<span id="Source_File"></span> ==
<tt>remove_submenu_page()</tt> is located in {{Trac|/wp-admin/includes/plugin.php}}.
+
<tt>remove_submenu_page()</tt>は、{{Trac|/wp-admin/includes/plugin.php}}にあります。
  
== Related ==
+
== 関連項目<span id="Related"></span> ==
  
 
{{Admin Menu Tags}}
 
{{Admin Menu Tags}}
63行目: 65行目:
 
{{原文|Function Reference/remove submenu page|162846}}<!-- 21:39, 23 August 2018‎ Bookchiq 版 -->
 
{{原文|Function Reference/remove submenu page|162846}}<!-- 21:39, 23 August 2018‎ Bookchiq 版 -->
  
[[Category:Functions]]
+
[[Category:関数]]
 +
 
 +
[[en:Function Reference/remove submenu page]]

2018年8月26日 (日) 23:29時点における版

説明

管理画面のサブレベルのメニューを取り除く。

この関数が呼び出されるタイミングにによっては、ユーザーが削除されたサブメニューの画面に直接アクセスすることを妨げない場合があります(参照:ticket #18850)。 メニューを削除したからといって、ユーザー権限を適切にフィルタリングする必要が無くなるわけではありません。

使い方

<?php remove_submenu_page( $menu_slug, $submenu_slug ); ?>

パラメータ

$menu_slug
string) (必須) 親メニューのスラッグ
初期値: なし
$submenu_slug
string) (必須) サブメニューのスラッグ
初期値: なし

戻り値

(配列|真偽値) 
成功した場合、取り除いたサブメニュー。失敗した場合、false

用例

ウィジェットのサブメニューページを削除する。

function wpcodex_adjust_the_wp_menu() {
	$page = remove_submenu_page( 'themes.php', 'widgets.php' );
	// $page[0]:メニューのタイトル
	// $page[1]:必要な最低限のユーザーレベルまたは権限
	// $page[2]:ファイルのURL
}
add_action( 'admin_menu', 'wpcodex_adjust_the_wp_menu', 999 );

上記の例では、$pageの値は

array(3) { [0]=> string(7) "Widgets" [1]=> string(18) "edit_theme_options" [2]=> string(11) "widgets.php" }

/wp-admin/options-general.php?page=certain-plugin-settings のようなスラッグを使用するプラグインの設定ページを取り除くには次のコードを用いる。

add_action( 'admin_menu', 'nstrm_remove_admin_submenus', 999 );
function nstrm_remove_admin_submenus() {
	remove_submenu_page( 'options-general.php', 'certain-plugin-settings' );
}

Remove custom post type submenu pages ポイントは第2引数 `&` を `&amp;` に変換することです。

参考

  • グローバル変数 (array) $submenuを使用
  • より最近のバージョンのWordPressで themes.php のサブメニュー theme-editor.php などを削除するには、admin_menu フックに非常に高い優先度でバインドする必要があります(110 など、削除するサブメニューに応じて)。admin_init フックは使用しないでください。wp-admin/admin-ajax.php を破損します。

変更履歴

Since: 3.1.0

ソースファイル

remove_submenu_page()は、/wp-admin/includes/plugin.phpにあります。

関連項目

管理メニュー: add_menu_page(), remove_menu_page(), add_submenu_page() /en, remove_submenu_page() /en, add_dashboard_page() /en, add_posts_page() /en, add_media_page() /en, add_links_page() /en, add_pages_page() /en, add_comments_page() /en, add_theme_page() /en, add_plugins_page() /en, add_users_page() /en, add_management_page() /en, add_options_page()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/remove submenu page最新版との差分