Normal Wordpress Menu parece com:
Home | Blog | Sobre nós | Contato
Mas eu vi muitas páginas com descrições nesses links:
Página inicial | Nossos Blogs | Sobre nós | Contato
.... nos encontre ... | leia mais | informação básica | Formulário de Contato
Como conseguir isso?
(Eu quero que seja a função principal para todos os meus temas, então sem plugins por favor, eu só quero saber como é feito)
Você precisa de um walker personalizado para o menu de navegação.
Basicamente, você adiciona um parâmetro 'walker'
às opções wp_nav_menu()
e chama uma instância de uma classe aprimorada:
wp_nav_menu(
array (
'menu' => 'main-menu',
'container' => FALSE,
'container_id' => FALSE,
'menu_class' => '',
'menu_id' => FALSE,
'depth' => 1,
'walker' => new Description_Walker
)
);
A classe Description_Walker
estende Walker_Nav_Menu
e altera a função start_el( &$output, $item, $depth, $args )
para procurar $item->description
.
Um exemplo básico:
/**
* 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
);
}
}
Ou, alternativamente como @nevvermind comentou , você poderia herdar todas as funcionalidades da função start_el
dos pais e apenas append a descrição para $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 )
);
}
Amostra de saída:
Agora habilite o campo de descrição em wp-admin/nav-menus.php
para obter a capacidade de editar este campo. Se você não WP apenas trash seu conteúdo completo de postagem para ele.
Leitura adicional:
E é isso.
Desde WordPress 3.0 , você não precisa de um walker personalizado mais!
Existe o walker_nav_menu_start_el
filter, veja https://developer.wordpress.org/reference/hooks/walker_nav_menu_start_el/
Exemplo:
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);
Isso não é melhor nem pior que outras sugestões; é apenas diferente. É curto e doce também.
Em vez de usar o campo de descrição como @toscho sugere, você poderia preencher o campo "Título" em cada item de menu com o texto desejado e, em seguida, usar este CSS:
.menu-item a:after { content: attr(title); }
Também seria fácil usar jQuery para anexá-lo, mas o texto é ornamental o suficiente para que o CSS pareça apropriado.
Você também pode escrever um elemento <span>
após o rótulo de navegação nos menus e usar a seguinte regra de CSS para alterar sua configuração display
(é inline
por padrão):
span {display:block}