Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

Hinzufügen von Menübeschreibungen in Ihren WordPress-Themes

Das WordPress-Menüsystem verfügt über eine integrierte Funktion, mit der Sie Beschreibungen zu Menüpunkten hinzufügen können. Allerdings ist diese Funktion standardmäßig ausgeblendet. Selbst wenn sie aktiviert ist, wird ihre Anzeige ohne Hinzufügen von Code nicht unterstützt. Die meisten Themes sind nicht auf die Beschreibung von Menüpunkten ausgelegt. In diesem Artikel zeigen wir Ihnen, wie Sie Menübeschreibungen in WordPress aktivieren und wie Sie Menübeschreibungen in Ihren WordPress-Themes hinzufügen können.

How to add menu descriptions in WordPress themes

Hinweis: Für dieses Tutorial benötigen Sie ein gutes Verständnis von HTML, CSS und WordPress-Theme-Entwicklung.

Wann und warum sollten Sie Menübeschreibungen hinzufügen?

Einige Benutzer denken, dass das Hinzufügen von Menübeschreibungen bei der Suchmaschinenoptimierung helfen wird. Wir sind jedoch der Meinung, dass der Hauptgrund für die Verwendung von Menübeschreibungen darin besteht, eine bessere Nutzererfahrung auf Ihrer Website zu bieten.

Beschreibungen können verwendet werden, um Besuchern mitzuteilen, was sie finden werden, wenn sie auf einen Menüpunkt klicken. Eine interessante Beschreibung wird mehr Nutzer dazu bringen, auf die Menüs zu klicken.

Menu Descriptions

Schritt 1: Aktivieren Sie Menübeschreibungen

Gehen Sie zu Erscheinungsbild “ Menüs. Klicken Sie auf die Schaltfläche Bildschirmoptionen in der oberen rechten Ecke der Seite. Markieren Sie das Feld Beschreibungen.

Enabling menu descriptions in WordPress

Dadurch wird das Beschreibungsfeld in Ihren Menüpunkten aktiviert. Zum Beispiel so:

Description field added to menu items

Jetzt können Sie Menübeschreibungen zu Einträgen in Ihrem WordPress-Menü hinzufügen. Allerdings werden diese Beschreibungen noch nicht in Ihren Themes angezeigt. Um Menübeschreibungen anzuzeigen, müssen wir etwas Code hinzufügen.

Schritt 2: Fügen Sie die Walker-Klasse hinzu:

Die Klasse Walker erweitert die bestehende Klasse in WordPress. Sie fügt im Grunde nur eine Codezeile hinzu, um Beschreibungen von Menüpunkten anzuzeigen. Fügen Sie diesen Code in die Datei functions.php Ihres Themes ein.

class Menu_With_Description extends Walker_Nav_Menu {
	function start_el(&$output, $item, $depth, $args) {
		global $wp_query;
		$indent = ( $depth ) ? str_repeat( "\t", $depth ) : '';
		
		$class_names = $value = '';

		$classes = empty( $item->classes ) ? array() : (array) $item->classes;

		$class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item ) );
		$class_names = ' class="' . esc_attr( $class_names ) . '"';

		$output .= $indent . '<li id="menu-item-'. $item->ID . '"' . $value . $class_names .'>';

		$attributes = ! empty( $item->attr_title ) ? ' title="' . esc_attr( $item->attr_title ) .'"' : '';
		$attributes .= ! empty( $item->target ) ? ' target="' . esc_attr( $item->target ) .'"' : '';
		$attributes .= ! empty( $item->xfn ) ? ' rel="' . esc_attr( $item->xfn ) .'"' : '';
		$attributes .= ! empty( $item->url ) ? ' href="' . esc_attr( $item->url ) .'"' : '';

		$item_output = $args->before;
		$item_output .= '<a'. $attributes .'>';
		$item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after;
		$item_output .= '<br /><span class="sub">' . $item->description . '</span>';
		$item_output .= '</a>';
		$item_output .= $args->after;

		$output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
	}
}

Schritt 3. Aktivieren Sie Walker im wp_nav_menu

WordPress-Themes verwenden die Funktion wp_nav_menu(), um Menüs anzuzeigen. Wir haben auch ein Tutorial für Anfänger darüber veröffentlicht, wie man benutzerdefinierte Navigationsmenüs in WordPress-Themes hinzufügt. Die meisten WordPress-Themes fügen Menüs in der Vorlage header.php hinzu. Es ist jedoch möglich, dass Ihr Theme eine andere Vorlagendatei für die Anzeige von Menüs verwendet hat.

Was wir jetzt tun müssen, ist die Funktion wp_nav_menu() in Ihrem Theme zu finden (höchstwahrscheinlich in header.php) und sie wie folgt zu ändern.


<?php $walker = new Menu_With_Description; ?>

<?php wp_nav_menu( array( 'theme_location' => 'primary', 'menu_class' => 'nav-menu', 'walker' => $walker ) ); ?>

In der ersten Zeile setzen wir $walker auf die Klasse walker, die wir zuvor in functions.php definiert haben. In der zweiten Zeile des Codes ist das einzige zusätzliche Argument, das wir zu unseren bestehenden wp_nav_menu-Argumenten hinzufügen müssen, 'walker' => $walker.

Schritt 4. Gestalten der Beschreibungen

Die Walker-Klasse, die wir zuvor hinzugefügt haben, zeigt in dieser Codezeile die Beschreibungen der Elemente an:

$item_output .= '<br /><span class="sub">' . $item->description . '</span>';

Der obige Code fügt dem Menüpunkt einen Zeilenumbruch durch Hinzufügen eines
Tag hinzufügt und dann die Beschreibungen in einen span mit der Klasse sub einschließt. Etwa so:

<li id="menu-item-99" class="menu-item menu-item-type-post_type menu-item-object-page"><a href="http://www.example.com/about/">Über uns<br /><span class="sub">Wer sind wir?</span></a></li>

Um die Darstellung der Beschreibungen auf Ihrer Website zu ändern, können Sie CSS in das Stylesheet Ihres Themes einfügen. Wir haben dies mit Twenty Twelve getestet und dieses CSS verwendet.

.menu-item {
border-left: 1px solid #ccc;
}

span.sub { 
font-style:italic;
font-size:small;
}

Wir hoffen, dass Sie diesen Artikel nützlich finden und dass er Ihnen hilft, cool aussehende Menüs mit Menübeschreibungen in Ihrem Theme zu erstellen. Noch Fragen? Hinterlassen Sie sie in den Kommentaren unten.

Zusätzliche Ressourcen

Wie man WordPress-Navigationsmenüs gestaltet

Hinzufügen von benutzerdefinierten Elementen zu bestimmten WordPress-Menüs

Bill Ericksons Menüs mit Beschreibungsklasse

Offenlegung: Unsere Inhalte werden von unseren Lesern unterstützt. Das bedeutet, dass wir möglicherweise eine Provision verdienen, wenn Sie auf einige unserer Links klicken. Mehr dazu erfahren Sie unter Wie WPBeginner finanziert wird , warum das wichtig ist und wie Sie uns unterstützen können. Hier finden Sie unseren redaktionellen Prozess .

Das ultimative WordPress Toolkit

Erhalte KOSTENLOSEN Zugang zu unserem Toolkit - eine Sammlung von WordPress-bezogenen Produkten und Ressourcen, die jeder Profi haben sollte!

Reader Interactions

52 KommentareEine Antwort hinterlassen

  1. Syed Balkhi

    Hey WPBeginner readers,
    Did you know you can win exciting prizes by commenting on WPBeginner?
    Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
    You can get more details about the contest from here.
    Start sharing your thoughts below to stand a chance to win!

  2. Matthew Blaxton

    In PHP 8.0 and higher this with throw a critical error.

    You need to find this line:
    function start_el( $output, $item, $depth, $args ) {

    Changing that line to the following should make the error disappear:
    function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 ) {

    • WPBeginner Support

      Thank you for sharing that for those on PHP 8.

      Admin

  3. Norman

    Hi,
    How can you make the description clickable too?

    • WPBeginner Support

      We cover that in step 4 :)

      Admin

  4. kayvan A.Gilani

    To Add Menu Descriptions in My WordPress Themes, I did step 1 and 2 of this blog but couldn’t follow in step 3 to move forward and perform the total change.

    • WPBeginner Support

      If you cannot find the function in your theme, we would recommend reaching out to your specific theme’s support and they should be able to assist.

      Admin

  5. yiannis

    Hi,
    How to disable product category description in max mega menu ?
    I have already gone to Mega Menu > General Settings and set Menu Item Descriptions to disabled but the problem exists.

    • WPBeginner Support

      You would want to reach out to the plugin’s support and they would be able to assist with the setting not working correctly

      Admin

    • WPBeginner Support

      You’re welcome :)

      Admin

  6. Lanka

    Thank you so much, you saved me

  7. dan

    Can this work with the WP_Bootstrap_Navwalker ?

    as i’ve tried it and it breaks my site….

  8. kalpana

    Thank you so much….was very useful to me….you saved my day

  9. Steven

    how to turn off the description in mobile layout?

  10. Anzani Zahrani

    Hello.. Please Help..
    How to add title category, not using title category description ?

  11. Ido Schacham

    Totally helpful, thanks!

  12. Rahman

    Great Tip but in menu description it does not support html tags. can anyone know about this?

    Thanks

  13. Iryna

    Hi Guys,

    Any ideas how to allow html tags in the description?
    remove_filter(’nav_menu_description‘, ’strip_tags‘);
    this one not work for me.

    • Damien Carbery

      @Iryna: Can you post your code somewhere e.g. pastebin.com.
      Where you call remove_filter() will determine whether it works – it has to be called after the add_filter() call.
      Calling it just before the wp_nav_menu() call might work.

  14. Max

    Is there anyway for the description not to be hyperlinked?

  15. Ashok

    thanks…it worked. but in menu description it does not support html tags.

  16. igorasas

    May already be there ready to plug-in? How this hack will work with the theme of „Twenty TwelveVersion: 1.5“
    ? And just as with the plugin wpml?

  17. Phong

    Thank you, this was really helpful to just copy paste this and get the quick picture.

  18. Chad

    Hey man, I added the walker class to functions.php, but I cannot find the wp_nav_menu in genesis theme. What am I missing? I have no idea what to do next?!?!

  19. Ksenia

    You expain very well – detailed and clearly. 1 minute and menu items descriptions are ok. Thank you!

  20. Mary Anne

    Thank you so much for this tutorial. It was recommended to me and it worked perfectly for making the changes I wanted to make. However, in making these changes, I’ve lost my drop down sub-item menus. Any idea what affected that in the code change?

    Thank you for your time and tutorial

    • WPBeginner Support

      It seems like a CSS issue, we are sorry we couldn’t be more specific. Try using Google Chrome’s developer tools to debug it.

      Admin

  21. Paul Renault

    I have implemented the menu descriptions and it worked great. Now my client is asking for a line break within one of the descriptions. I have tried putting a carriage return and inserting a tag into the description field through the admin. It doesn’t appear in the front end. WP removes these edits. Is there a way to remedy this?

      • Paul Renault

        The client wants a line break. Is there a way that I can insert a tag in the description? If I put one in now it gets removed.

  22. Barry

    Great tutorial guys, just want to know how to implement this on a custom menu displayed using the Custom Menu widget?

  23. Oryan Consulting

    Thank you! Been working on WordPress for years and I’ve never even heard of this before. I was looking to remove the descriptions as they were very redundant on the site I’m working on. I looked everywhere for where they were coming from.

    Oh joy!

  24. sambassador

    works!

    but for php 5.4 you’ll have to match the wp walker arguments for the start_el function:

    function start_el( &$output, $object, $depth = 0, $args = array(), $current_object_id = 0 )

    and find replace $item with $object.

  25. Steve Covello

    You Rock!! Worked perfectly.

  26. Kevin Gilbert

    Perfect. This was just what I needed to finish up on a site. I had some issues with the CSS, but I finally figured it out and got it working. Thanks for the great articles.

  27. Jon

    Excellent tip. Worked perfectly!

  28. Jedediah White

    This worked perfectly for me. The class function is perfect too. Thanks a lot!

  29. Pankaj

    I needed to create same thing and I was totally lost.

    I was planning to do some stupid things to get this thing done.

    thank god I found this post and saved time and stress!

    I simply love this site got to know so much things.

    Thanks you so much for showing the easiest things here.

    • Pankaj

      The span tag is coming on sub-menus too.

      its not showing there but it is taking that much of space which makes it look too odd.

      is there any workaround for the same??

  30. DiTesco

    This is really a great tutorial and I was wondering if this would work on the Thesis 1.8.5? If not, it would be great if you can provide one. I will most certainly help you put it out there. Thumbs up!

  31. svet

    I followed your tutorial and added description to my menu. Thanks! However, when I am in mobile mode menu converts into dropdown menu and menu title and description are connected. For example, if my menu item is „about“ and description „more about me“, the mobile version shows „aboutmore about me“. Is there a way to fix this?

    • David

      I had the same problem. Here’s what I did.

      I changed this:
      $description = ! empty( $item->description ) ? ‚<span>‘.esc_attr( $item->description ).'</span>‘ : “;

      To this:
      $description = ! empty( $item->description ) ? ‚<br /><span>‘.esc_attr( $item->description ).'</span>‘ : “;

      Not sure if it’s the best solution, but it worked for me.

      • Garrett Hyder

        Thanks guys, I ran into what SVET and DAVID did with the mobile menu.
        The code seems to have changed my change was simply appending in a span with the dash seperator and in my desktop query simply suppressed it as was unneeded there.

        $item_output .= ‚ – ‚;

        Within my Desktop Only Query set the span to display none;
        @media only screen and (min-width: 740px) {
        header #submenu li span.dash { display:none; }

        Hope that helps, handled my issue nicely.

  32. Nicola

    Great post – very clear, exactly what I needed and worked perfectly. Thank you!

  33. Samedi Amba

    Thanks for the Great Tutorial. I’ve done the major steps well, as you can see from
    http://ueab.ac.ke/demo/index

    I was stuck with the styling-how do I reduce the space between the Main Menu Label and the description? Your help is greatly appreciated.

    • Editorial Staff

      It has to do with the line-height of your .menu a class of your theme. If you reduce that, then the spacing will reduce itself.

      Admin

  34. Chris Rouse

    Great post. I’ve tried to dig into this before but the previous instructions I found were not this easy to follow. I was able to drop the functions.php code in, figure out how to change the walker class in my header file (different for the theme I use, but straight forward), and get things going in about 15 minutes from start to finish.

    One piece that you might want to add is how to include the right border on the last menu item using the :last-child property.


    .menu-item:last-child {
    border-right: 1px solid #ccc;
    }

  35. Damien Carbery

    Instead of extending Walker_Nav_Menu it would be nice (and easier) if a filter was provided e.g.
    If the core code had:
    $item_output .= apply_filters( ‚walker_nav_menu_description‘, $item->description);

    Then the custom filter function would just have:
    return “ . $description . “;

  36. Cathy Earle

    Great info … going to start adding this to my sites. Thank you!

Eine Antwort hinterlassen

Danke, dass du einen Kommentar hinterlassen möchtest. Bitte beachte, dass alle Kommentare nach unseren kommentarpolitik moderiert werden und deine E-Mail-Adresse NICHT veröffentlicht wird. Bitte verwende KEINE Schlüsselwörter im Namensfeld. Lass uns ein persönliches und sinnvolles Gespräch führen.