Criando Menus no WordPress

Depois da versão 3.0, a criação de menus no WordPress tornou-se muito importante, pois se utiliza um gerenciador para reproduzir as informações do menu. No menu, pode-se criar links, integrar páginas e páginas de arquivo.

Habilitando e registrando o menu

Em functions.php do seu tema, adicione:

[cce lang=”php”]

if ( function_exists( ‘register_nav_menu’ ) ) {

register_nav_menu( ‘meu_menu’, ‘Este é meu primeiro menu’ );

register_nav_menu( ‘segundo_menu’, ‘Este é meu segundo menu’ );

}

[/cce]

De início, verificamos a função register_nav_menu. Dentro da função, abrigamos dois parâmetros, que são: nome do menu (de preferência sem espaços e letras minusculas) e a descrição do menu. Ambos são obrigatórios nesta função.

Essa função já habilita o suporte para os menus.

Retornando o menu

Adicione o seguinte código onde queira que o retornasse o menu:

[cce lang=”php”]

wp_nav_menu( array(

‘menu’ => ‘meu_menu’,

‘theme_location’ => ‘meu_menu’,

‘container’ => ‘div’,

‘container_class’ => ‘classe_do_container’,

‘container_id’ => ‘id_do_container’,

‘menu_class’ => ‘classe_do_menu’,

‘echo’ => true,

‘menu_id’ => ‘id_do_menu’,

‘before’ => ”,

‘after’ => ”,

‘link_before’ => ”,

‘link_after’ => ”,

‘depth’ => 0,

‘walker’ => ”,

) );

[/cce]

Como perceberam, a função wp_nav_menu recebe alguns parâmetros, para não haver dúvidas, explico melhor abaixo.

• menu: O nome do menu em que deseja retornar (valor determinado na função register_menu)
• theme_location: Onde vai está localizado o menu (valor determinado na função register_menu)
• container: Se alguma tag irá envolver a lista do menu
• container_class: Classes do container
• container_id: O ID do container
• menu_class: Classes da lista do menu
• menu_id: O ID da lista do menu
• echo: Usado para retorno do menu, em uma vez que seu valor seja falso, o menu não será retornado ou visível.
• before: Se algum elemento entrará antes do menu
• after: Se algum elemento entrará depois do menu
• link_before: Se algum elemento entrará antes do link
• link_after: Se alguém elementro entrará depois do menu
• depth: Quantos níveis de hierarquia devem ser incluídos
• walker: Objeto para personalização do menu

Habilitando descrição

Para terminar a explicação, os Menus do WordPress contém uma opção para descrição nos menus. É uma forma melhor de explorar o conteúdo e também explicar um pouco mais o parâmetro walker, que ficou um pouco difícil de se entender.

Primeiro, ative a opção de descrição desta forma: Abra a seção de menus no painel de administração e vá a Screen Options (Opções de tela) e ative a opção Description (Descrição)

Vamos personalizar o menu para receber as informações de descrição, adicione em functions.php:

[cce lang=”php”]

/* Código por: https://www.kriesi.at/archives/improve-your-wordpress-navigation-menu-output */

class descricao_walker 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 . ‘

• 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 ) .’”‘ : ”;

  $prepend = ‘**‘;

  $append = ‘**‘;

  $description = ! empty( $item->description ) ? ‘

  ‘.esc_attr( $item->description ).’

  ‘ : ”; // aqui é aonde a informação está a descrição

  if($depth != 0)

  {

  $description = $append = $prepend = “”;

  }

  $item_output = $args->before;

  $item_output .= ‘‘; $item_output .= $args->link_before .$prepend.apply_filters( ‘the_title’, $item->title, $item->ID ).$append; $item_output .= $description.$args->link_after; //aqui aonde a descrição estará sendo retornada $item_output .= ‘‘;

  $item_output .= $args->after;

  $output .= apply_filters( ‘walker_nav_menu_start_el’, $item_output, $item, $depth, $args );

  }

  }

  [/cce]

  No código, foi criado uma classe retorna todo o item do menu, ou seja, a . Está comentado no código onde você vai encontrar os códigos da descrição. É necessário entender um pouco de PHP para alterar esse código e personalizar ainda mais o seu menu.

  Para retornar essa classe, vamos usar o walker do menu, altere o valor, assim:

  [cce lang=”php”]’walker’ => new descricao_walker() [/cce]

  Você pode determinar o valor da descrição no mesmo lugar aonde você altere as informações do menu.

  Fonte da descrição: https://www.kriesi.at/archives/improve-your-wordpress-navigation-menu-output