wordpressor
  • 0
Эксперт

Описание пунктов меню? Пользовательский ходок для wp_nav_menu()

  • 0

Обычное меню WordPress выглядит так:

Главная | Блог | О нас | Контакт

Но я видел много страниц с описаниями по этим ссылкам:

Домашняя страница | Наши блоги | О нас | Контакты

….познакомьтесь с нами…| читать дальше| основная информация| Форма обратной связи

Как этого добиться?

(Я хочу, чтобы это была основная функция для всех моих тем, поэтому никаких плагинов, пожалуйста, я просто хочу знать, как это делается)

Share
  1. Вам нужен пользовательский ходок для навигационного меню.

    По сути, вы добавляете параметр 'walker' к wp_nav_menu() параметрам и вызываете экземпляр расширенного класса:

    wp_nav_menu(
        array (
            'menu'            => 'main-menu',
            'container'       => FALSE,
            'container_id'    => FALSE,
            'menu_class'      => '',
            'menu_id'         => FALSE,
            'depth'           => 1,
            'walker'          => new Description_Walker
        )
    );
    

    Класс Description_Walker расширяет Walker_Nav_Menu и изменяет функцию start_el( &$output, $item, $depth, $args ) поиска $item->description .

    Основной пример:

    /**
     * Create HTML list of nav menu items.
     * Replacement for the native Walker, using the description.
     *
     * @see    https://wordpress.stackexchange.com/q/14037/
     * @author fuxia
     */
    class Description_Walker extends Walker_Nav_Menu
    {
        /**
         * Start the element output.
         *
         * @param  string $output Passed by reference. Used to append additional content.
         * @param  object $item   Menu item data object.
         * @param  int $depth     Depth of menu item. May be used for padding.
         * @param  array|object $args    Additional strings. Actually always an 
                                         instance of stdClass. But this is WordPress.
         * @return void
         */
        function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 )
        {
            $classes     = empty ( $item->classes ) ? array () : (array) $item->classes;
    
            $class_names = join(
                ' '
            ,   apply_filters(
                    'nav_menu_css_class'
                ,   array_filter( $classes ), $item
                )
            );
    
            ! empty ( $class_names )
                and $class_names = ' class="'. esc_attr( $class_names ) . '"';
    
            $output .= "<li id='menu-item-$item->ID' $class_names>";
    
            $attributes  = '';
    
            ! empty( $item->attr_title )
                and $attributes .= ' title="'  . esc_attr( $item->attr_title ) .'"';
            ! empty( $item->target )
                and $attributes .= ' target="' . esc_attr( $item->target     ) .'"';
            ! empty( $item->xfn )
                and $attributes .= ' rel="'    . esc_attr( $item->xfn        ) .'"';
            ! empty( $item->url )
                and $attributes .= ' href="'   . esc_attr( $item->url        ) .'"';
    
            // insert description for top level elements only
            // you may change this
            $description = ( ! empty ( $item->description ) and 0 == $depth )
                ? '<small class="nav_desc">' . esc_attr( $item->description ) . '</small>' : '';
    
            $title = apply_filters( 'the_title', $item->title, $item->ID );
    
            $item_output = $args->before
                . "<a $attributes>"
                . $args->link_before
                . $title
                . '</a> '
                . $args->link_after
                . $description
                . $args->after;
    
            // Since $output is called by reference we don't need to return anything.
            $output .= apply_filters(
                'walker_nav_menu_start_el'
            ,   $item_output
            ,   $item
            ,   $depth
            ,   $args
            );
        }
    }
    

    Или, в качестве альтернативы, как прокомментировал @nevvermind, вы можете унаследовать все функции родительской start_el функции и просто добавить описание к $output :

    function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 ) 
    {
        parent::start_el( $output, $item, $depth, $args );
        $output .= sprintf( 
            '<i>%s</i>', 
            esc_html( $item->description ) 
        );
    }
    

    Пример вывода:

    введите описание изображения здесь

    Теперь включите поле описания wp-admin/nav-menus.php , чтобы получить возможность редактировать это поле. Если вы этого не сделаете, WP просто выкинет в него весь ваш пост.

    введите описание изображения здесь

    Дальнейшее чтение:

    И это все.

    • 0
  2. Начиная с WordPress 3.0, вам больше не нужен настраиваемый ходок!

    Есть walker_nav_menu_start_el фильтр, см. https://developer.wordpress.org/reference/hooks/walker_nav_menu_start_el/

    Пример:

    function add_description_to_menu($item_output, $item, $depth, $args) {
    
       if (strlen($item->description) > 0 ) {
          // append description after link
          $item_output .= sprintf('<span class="description">%s</span>', esc_html($item->description));
        
          // or.. insert description as last item inside the link ($item_output ends with "</a>{$args->after}")
          // $item_output = substr($item_output, 0, -strlen("</a>{$args->after}")) . sprintf('<span class="description">%s</span >', esc_html($item->description)) . "</a>{$args->after}";
       }   
       return $item_output;
    }
    add_filter('walker_nav_menu_start_el', 'add_description_to_menu', 10, 4);
    
    • 0
  3. Это не лучше и не хуже других предложений; это просто другое. Тоже коротко и мило.

    Вместо того, чтобы использовать поле описания, как предлагает @toscho, вы можете заполнить поле «Название» в каждом пункте меню нужным текстом, а затем использовать этот CSS:

    .menu-item a:after { content: attr(title); }

    Также было бы легко использовать jQuery, чтобы добавить его, но текст достаточно декоративный, поэтому CSS кажется уместным.

    • 0
  4. Вы также можете написать <span> элемент после метки навигации в меню и использовать следующее правило CSS, чтобы изменить его display настройку ( inline по умолчанию):

    span {display:block}
    
    • 0

Оставить ответ

You must login to add an answer.