메뉴 항목 설명? wp_nav_menu () 용 맞춤 워커

일반 Wordpress 메뉴는 다음과 같습니다.

홈 | 블로그 | 회사 소개 | 접촉

그러나이 링크 아래에 설명이있는 많은 페이지가 있습니다.

홈페이지 | 블로그 | 회사 소개 | 연락처
.... 우리를 만나십시오 ... | 더 읽기 | 기본 정보 | 문의 양식

이것을 달성하는 방법?

(모든 테마의 핵심 기능이되기를 원하므로 플러그인을 사용하지 마십시오. 어떻게했는지 알고 싶습니다)

탐색 메뉴를위한 사용자 지정 워커가 필요합니다.

기본적으로 옵션에 매개 변수 '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를 사용하지 않으면 전체 게시물 내용을 휴지통에 버립니다.

더 읽을 거리 :

• 관련 버그
• 마크 업 및 서식이 다른 유사한 예
• 프로그래밍 방식으로 메뉴 관리 화면에서 설명 상자 사용
• 나중에 사용하기 위해 항목 설명을 수집하십시오.

그리고 그게 다야.

이후 워드 프레스 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));

        // insert description as last item *in* link ($input_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);

이것은 다른 제안보다 나쁘지 않습니다. 그냥 다릅니다. 짧고 달콤합니다.

@toscho가 제안한 대로 description 필드를 사용하는 대신 원하는 텍스트로 각 메뉴 항목의 "Title"필드를 채운 다음이 CSS를 사용할 수 있습니다.

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

jQuery 를 사용하여 쉽게 추가 할 수도 있지만 텍스트는 장식용으로 CSS가 적절 해 보입니다.

<span>메뉴에서 탐색 레이블 다음에 요소를 작성 하고 다음 CSS 규칙을 사용하여 display설정 을 변경할 수도 있습니다 ( inline기본적으로).

span {display:block}