Aqui está um exemplo;
Primeiro, para descobrir a ordem dos itens do submenu com base em sua chave de matriz, você pode fazer uma var_dump
variável global no submenu $, que produzirá o seguinte;
(Estou usando o menu Postagens e submenu como exemplo)
//shortened for brevity....
["edit.php"]=>
array(6) {
[5]=>
array(3) {
[0]=> string(9) "All Posts"
[1]=> string(10) "edit_posts"
[2]=> string(8) "edit.php"
}
[10]=>
array(3) {
[0]=> string(7) "Add New"
[1]=> string(10) "edit_posts"
[2]=> string(12) "post-new.php"
}
[15]=>
array(3) {
[0]=> string(10) "Categories"
[1]=> string(17) "manage_categories"
[2]=> string(31) "edit-tags.php?taxonomy=category"
}
[17]=>
array(3) {
[0]=> string(14) "Sub Menu Title"
[1]=> string(10) "edit_posts"
[2]=> string(17) "sub_menu_page.php"
}
}
Podemos ver que meu item de submenu é adicionado à matriz com uma chave 17 após os itens padrão.
Se, por exemplo, eu quiser adicionar meu item de submenu, diretamente após o item de submenu Todas as postagens, preciso fazer isso definindo minha chave de matriz como 6, 7, 8 ou 9 (qualquer coisa após 5 e antes de 10, respectivamente.
É assim que se faz...
function change_submenu_order() {
global $menu;
global $submenu;
//set our new key
$new_key['edit.php'][6] = $submenu['edit.php'][17];
//unset the old key
unset($submenu['edit.php'][17]);
//get our new key back into the array
$submenu['edit.php'][6] = $new_key['edit.php'][6];
//sort the array - important! If you don't the key will be appended
//to the end of $submenu['edit.php'] array. We don't want that, we
//our keys to be in descending order
ksort($submenu['edit.php']);
}
Resultado,
["edit.php"]=>
array(6) {
[5]=>
array(3) {
[0]=> string(9) "All Posts"
[1]=> string(10) "edit_posts"
[2]=> string(8) "edit.php"
}
[6]=>
array(3) {
[0]=> string(14) "Sub Menu Title"
[1]=> string(10) "edit_posts"
[2]=> string(17) "sub_menu_page.php"
}
[10]=>
array(3) {
[0]=> string(7) "Add New"
[1]=> string(10) "edit_posts"
[2]=> string(12) "post-new.php"
}
[15]=>
array(3) {
[0]=> string(10) "Categories"
[1]=> string(17) "manage_categories"
[2]=> string(31) "edit-tags.php?taxonomy=category"
}
}
... experimente e deixe-nos saber como você vai!
Atualização 1:
Adicione isso ao seu arquivo functions.php;
function change_post_menu_label() {
global $menu;
global $submenu;
$my_menu = 'example_page'; //set submenu page via its ID
$location = 1; //set the position (1 = first item etc)
$target_menu = 'edit.php'; //the menu we are adding our item to
/* ----- do not edit below this line ----- */
//check if our desired location is already used by another submenu item
//if TRUE add 1 to our value so menu items don't clash and override each other
$existing_key = array_keys( $submenu[$target_menu] );
if ($existing_key = $location)
$location = $location + 1;
$key = false;
foreach ( $submenu[$target_menu] as $index => $values ){
$key = array_search( $my_menu, $values );
if ( false !== $key ){
$key = $index;
break;
}
}
$new['edit.php'][$location] = $submenu[$target_menu][$key];
unset($submenu[$target_menu][$key]);
$submenu[$target_menu][$location] = $new[$target_menu][$location];
ksort($submenu[$target_menu]);
}
Minha atualização inclui uma maneira um pouco mais fácil de lidar com a configuração da posição do menu, você só precisa estipular o nome da página do submenu e a posição desejada no menu. No entanto, se você selecionar uma página de submenu $location
igual à de uma chave existente, ela substituirá a chave pela sua, assim o item de menu desaparecerá com o item de menu em seu lugar. Aumente ou diminua o número para solicitar seu menu corretamente, se for o caso. Da mesma forma, se alguém instalar um plug-in que afeta a mesma área de menu e para o qual tem o mesmo $location
item do submenu, o mesmo problema ocorrerá. Para contornar isso, o exemplo de Kaiser fornece algumas verificações básicas para isso.
Atualização 2:
Eu adicionei um bloco de código adicional que verifica todas as chaves existentes na matriz em relação ao desejado $location
e, se uma correspondência for encontrada, incrementaremos nosso $location
valor 1
para evitar que os itens de menu se substituam. Este é o código responsável por isso,
//excerpted snippet only for example purposes (found in original code above)
$existing_key = array_keys( $submenu[$target_menu] );
if ($existing_key = $location)
$location = $location + 1;
Atualização 3: (script revisado para permitir a classificação de vários itens do submenu)
add_action('admin_init', 'move_theme_options_label', 999);
function move_theme_options_label() {
global $menu;
global $submenu;
$target_menu = array(
'themes.php' => array(
array('id' => 'optionsframework', 'pos' => 2),
array('id' => 'bp-tpack-options', 'pos' => 4),
array('id' => 'multiple_sidebars', 'pos' => 3),
)
);
$key = false;
foreach ( $target_menu as $menus => $atts ){
foreach ($atts as $att){
foreach ($submenu[$menus] as $index => $value){
$current = $index;
if(array_search( $att['id'], $value)){
$key = $current;
}
while (array_key_exists($att['pos'], $submenu[$menus]))
$att['pos'] = $att['pos'] + 1;
if ( false !== $key ){
if (array_key_exists($key, $submenu[$menus])){
$new[$menus][$key] = $submenu[$menus][$key];
unset($submenu[$menus][$key]);
$submenu[$menus][$att['pos']] = $new[$menus][$key];
}
}
}
}
}
ksort($submenu[$menus]);
return $submenu;
}
No exemplo acima, você pode direcionar vários submenus e vários itens por submenu, definindo os parâmetros de acordo com a $target_menu
variável que contém uma matriz multidimensional de valores.
$target_menu = array(
//menu to target (e.g. appearance menu)
'themes.php' => array(
//id of menu item you want to target followed by the position you want in sub menu
array('id' => 'optionsframework', 'pos' => 2),
//id of menu item you want to target followed by the position you want in sub menu
array('id' => 'bp-tpack-options', 'pos' => 3),
//id of menu item you want to target followed by the position you want in sub menu
array('id' => 'multiple_sidebars', 'pos' => 4),
)
//etc....
);
Esta revisão impedirá que os itens do submenu se sobrescrevam se eles tiverem a mesma tecla (posição), uma vez que percorrerá até encontrar uma chave (posição) disponível que não exista.