<
Menu

Tableless


startup

Por que eu não gosto do nome startup

javascript-dose-certa

Qual a dose certa de JavaScript

featured-image8

O Designer Gladiador

crossdevice

Experiência cross-device


Criando Menus no WordPress

Aprenda a adicionar menus e edite no seu próprio painel de administração com as páginas ou links que você quer

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: http://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 <li>. 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: http://www.kriesi.at/archives/improve-your-wordpress-navigation-menu-output

  • Por Paulo Rodrigues

    Paulo Rodrigues é residente de Salvador-BA, especialista em criação de sites e desenvolvimento web desde de 2008. Foi com o desenvolvimento front-end que se apaixonou por esse caminho sem volta, atualmente além de interfaces, Paulo desenvolve para WordPress.

    http://www.twitter.com/paulorodriguesw

    Mais posts do autor

    Comentários (13)

    • charles Lins

      Descobrindo a área “description” facilitou a questão da classe.
      Perguntas: se faço um tema e todo o menu feito, qual a vantagem de usar este recurso do WP?
      Apenas com: add_theme_support(‘menus’); foi suficiente para inserir 1 menu no meu tema. Para que tantos códigos extras citados neste post?
      Seria para sanar minha necessidade de linkar as sub-páginas?

    • http://www.twitter.com/paulorodriguesw Paulo Rodrigues

      Charles, tudo que você disse não está errado. Você pode sim, fazer dar forma que você faz, mas assim você só ativa o suporte aos menus. No que eu expliquei, é como você determinasse um menu em determinada area, entende?
      Eu gosto de mostrar tudo que se é possivel. Explicar todo tipo de parametro, tudo detalhado, para depois voce reduzir a quantidade de código.
      Ex: para retornar a regiao do menu, só é necessário poucos parametros, no maximo 5, mas eu expliquei toda a lista, depois que se entende, você aprende a reduzir.
      Enfim, não gosto de ensinar receita de bolo, e sim, passar um conteúdo para que meus leitores entendam o que o que se é passado.

    • Christian Nascimento

      Gostei do artigo. Parabéns!

    • Christian Nascimento

      Um exemplo mais detalhado de como inserir este recurso numa página:

      ‘menu’,'container’ => ‘ul’,'menu_class’ => ‘menu’)); ?>

    • http://www.sozuera.com Diego

      Já faz algum tempo que estou desenvolvendo meu site e estava a procura exatamente dessa informação. Muito obrigado por ela, foi de grande ajuda!

    • Thiano

      Tudo bem,

      Lendo o post gostaria de entender um detalhe, onde insiro o código:

      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’ => ”,
      ) );

      Desculpa a pergunta, mas comecei a usar o wodpress a pouco tempo!

      Att,
      Thiano

    • Paulo Rodrigues

      Thiano, aonde você que quer que o menu seja reproduzido.
      Abraço!

    • Pingback: Iniciando desenvolvimento de sites com WordPress – Parte I | Tableless | Tableless

    • Rafael

      Obrigado pela informação, ajudou bastante!

    • Marcos Depresbiteris

      Paulo, preciso saber se você desenvolveria uma funcionalidade para colocar em meu site – Grato – Marcos Depresbiteris

    • Eduardo Cardillo

      Cara, isso vai me ajudar muito!!!!

      Poder incluir descrição e uma classe para cada item vai me dar possibilidade de customizar meu menu sem plugin!!!

      Parabéns pela dica…

    • Luiz GC

      No caso se eu quiser que o menu fique fixo durante a rolagem do site (vertical no caso), qual container eu devo colocar? Existe um específico ou devo criar um container fixo, para inserir o menu?

    • Jefferson Elias

      Obrigado. Muito bom! Deu Muito Certo!