Wordpress API Menu / Submenu Order

Tworzę motyw potomny za pomocą Wordpress 3.4.2 i wersji programistycznej Options Framework autorstwa David Price . To jest mój pierwszy motyw i jestem stosunkowo nowy, więc zapoznałem się z Kodeksem Wordpress i sprawdziłem rejestrację elementów w API.

Bez ingerencji w jakiekolwiek pliki zewnętrzne poza moim motywem zastanawiałem się, czy istnieje sposób, aby zmienić położenie strony Opcje motywu w hierarchii menu Wygląd - więc kiedy mój motyw jest aktywowany, pozycja nie jest podobna pierwszy obraz, ale jak drugi.

Wiem, że możesz utworzyć menu (takie jak karta Wygląd , wtyczki , użytkownicy itp.) Lub podmenu ( motywy , widżety , menu itp.), Ale jak bym poszedł o ustawianiu podmenu, powiedz, drugi z góry?

Z tego, co zbieram, gdzieś jest wywołane zamówienie i inne dodatkowe strony w functions.php po nim umieszczane są pliku?

W moim pliku functions.php:

// Add our "Theme Options" page to the Wordpress API admin menu.
if ( !function_exists( 'optionsframework_init' ) ) {
    define( 'OPTIONS_FRAMEWORK_DIRECTORY', get_template_directory_uri() . '/inc/' );
    require_once dirname( __FILE__ ) . '/inc/options-framework.php';
}

Dzięki.

Oto przykład;

Najpierw ustal kolejność elementów podmenu na podstawie klucza tablicy, którą możesz wykonać var_dump globalnej zmiennej podmenu $, która wyświetli następujące;

(Korzystam z menu Postów i podmenu jako przykładu)

  //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"
    }
  }

Widzimy, że mój element podmenu jest dodawany do tablicy za pomocą klucza 17 po elementach domyślnych.

Jeśli na przykład chcę dodać element podmenu, bezpośrednio po Wszystkich postach elemencie podmenu muszę to zrobić, ustawiając klawisz tablicy na 6, 7, 8 lub 9 (odpowiednio po 5 i przed 10).

Tak to się robi...

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']);

}

Wynik,

  ["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"
    }
  }

... spróbuj i daj nam znać, jak idziesz!

Aktualizacja 1:

Dodaj to do pliku 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]);

}

Moja aktualizacja zawiera nieco łatwiejszy sposób obsługi ustawień pozycji menu, wystarczy podać nazwę strony podmenu i żądaną pozycję w menu. _{Jeśli jednak wybierzesz stronę podmenu $locationrówną stronie istniejącego klucza, zastąpi on ten klucz twoją, dlatego element menu zniknie, a element menu zostanie zastąpiony. W takim przypadku zwiększ lub zmniejsz numer, aby poprawnie zamówić menu. Podobnie, jeśli ktoś zainstaluje wtyczkę, która działa na ten sam obszar menu i dla którego ma to samo, $locationco element podmenu, wystąpi ten sam problem.} Aby to obejść, przykład Kaisera zapewnia podstawowe sprawdzenie tego.

Aktualizacja 2:

Dodałem dodatkowy blok kodu, który sprawdza wszystkie istniejące klucze w tablicy względem naszych pożądanych, $locationa jeśli zostanie znalezione dopasowanie, zwiększymy naszą $locationwartość 1, aby uniknąć wzajemnego zastępowania się elementów menu. To jest kod odpowiedzialny za to,

   //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;

Aktualizacja 3: (poprawiono skrypt, aby umożliwić sortowanie wielu pozycji podmenu)

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;

}

W powyższym przykładzie możesz kierować reklamy na wiele podmenu i wiele pozycji na podmenu, ustawiając odpowiednio parametry w $target_menuzmiennej, która zawiera wielowymiarową tablicę wartości.

$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....
);

Ta poprawka zapobiegnie wzajemnemu nadpisywaniu się elementów podmenu, jeśli mają one ten sam klucz (pozycję), ponieważ będzie on przechodził, aż znajdzie dostępny klucz (pozycja), który nie istnieje.

Menu administratora (i jego problemy)

Ponieważ w menu administratora poważnie brakuje jakichkolwiek haczyków i publicznego interfejsu API (które umożliwiają przenoszenie elementów), musisz skorzystać z kilku obejść. Poniższa odpowiedź pokazuje, co czeka na Ciebie w przyszłości i jak możesz się obejść, o ile mamy obecny stan podstawowy.

Najpierw muszę zauważyć, że scribu pracuje nad łatką do menu administratora, która powinna znacznie ułatwić obsługę. Obecna struktura jest dość popsuta i napisałem o niej artykuł, który wkrótce będzie przestarzały. Spodziewaj się, że WP 3.6 całkowicie zmieni rzeczy.

Jest też kwestia, że ​​nie powinieneś już używać stron Opcje do motywów. Do tego celu służy obecnie „Theme Customizer” .

Wtyczka

Napisałem wtyczkę, która testuje to z domyślną stroną „Opcje motywu” dla strony TwentyEleven / Ten options. Jak widać, nie ma prawdziwego interfejsu API, który pozwalałby na dowolne pozycje. Musimy więc przechwycić globalne.

W skrócie: wystarczy postępować zgodnie z komentarzami i rzucić okiem na powiadomienia administratora, które dodałem, aby dać ci jakieś wyniki debugowania.

<?php
/** Plugin Name: (#70916) Move Submenu item */

add_action( 'plugins_loaded', array( 'wpse70916_admin_submenu_items', 'init' ) );

class wpse70916_admin_submenu_items
{
    protected static $instance;

    public $msg;

    public static function init()
    {
        is_null( self :: $instance ) AND self :: $instance = new self;
        return self :: $instance;
    }

    public function __construct()
    {
        add_action( 'admin_notices', array( $this, 'add_msg' ) );

        add_filter( 'parent_file', array( $this, 'move_submenu_items' ) );
    }

    public function move_submenu_items( $parent_file )
    {
        global $submenu;
        $parent = $submenu['themes.php'];

        $search_for = 'theme_options';

        // Find current position
        $found = false;
        foreach ( $parent as $pos => $item )
        {
            $found = array_search( $search_for, $item );
            if ( false !== $found )
            {
                $found = $pos;
                break;
            }
        }
        // DEBUG: Tell if we didn't find it.
        if ( empty( $found ) )
            return $this->msg = 'That search did not work out...';

        // Now we need to determine the first and second item position
        $temp = array_keys( $parent );
        $first_item  = array_shift( $temp );
        $second_item = array_shift( $temp );

        // DEBUG: Check if it the item fits between the first two items:
        $distance = ( $second_item - $first_item );
        if ( 1 >= $distance )
            return $this->msg = 'We do not have enough space for your item';

        // Temporary container for our item data
        $target_data = $parent[ $found ];

        // Now we can savely remove the current options page
        if ( false === remove_submenu_page( 'themes.php', $search_for ) )
            return $this->msg = 'Failed to remove the item';

        // Shuffle items (insert options page)
        $submenu['themes.php'][ $first_item + 1 ] = $target_data;
        // Need to resort the items by their index/key
        ksort( $submenu['themes.php'] );
    }

    // DEBUG Messages
    public function add_msg()
    {
        return print sprintf(
             '<div class="update-nag">%s</div>'
            ,$this->msg
        );
    }
} // END Class wpse70916_admin_submenu_items

Powodzenia i miłej zabawy.

Niestandardowe filtry

Istnieje inna możliwość osiągnięcia tego. Nie pytaj mnie, dlaczego wcześniej o tym nie myślałem. W każdym razie istnieje filtr dedykowany do niestandardowej kolejności menu. Po prostu ustaw, trueaby zezwolić na niestandardowe zamówienie. Następnie masz drugi hak, aby zamówić pozycje w menu głównym. Tam po prostu przechwytujemy global $submenui przełączamy nasze pozycje podmenu.

Przykład ten przesuwa element dietetyczne powyżej te widgety pozycji wykazać jego funkcjonalność. Możesz dostosować to, co chcesz.

<?php
defined( 'ABSPATH' ) OR exit;
/**
 * Plugin Name: (#70916) Custom Menu Order
 * Description: Changes the menu order of a submenu item.
 */

// Allow a custom order
add_filter( 'custom_menu_order', '__return_true' );
add_filter( 'menu_order', 'wpse70916_custom_submenu_order' );
function wpse70916_custom_submenu_order( $menu )
{
    // Get the original position/index
    $old_index = 10;
    // Define a new position/index
    $new_index = 6;

    // We directly interact with the global
    $submenu = &$GLOBALS['submenu'];
    // Assign our item at the new position/index
    $submenu['themes.php'][ $new_index ] = $submenu['themes.php'][ $old_index ];
    // Get rid of the old item
    unset( $submenu['themes.php'][ $old_index ] );
    // Restore the order
    ksort( $submenu['themes.php'] );

    return $menu;
}