02/03/2011

Artigos

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

9 comentários
Tweet

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:

1
2
3
4

if ( function_exists( 'register_nav_menu' ) ) {
register_nav_menu( 'meu_menu', 'Este é meu primeiro menu' );
register_nav_menu( 'segundo_menu', 'Este é meu segundo menu' );
}

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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

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

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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

/* 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 . '<li>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 = '<strong>';
$append = '</strong>';
$description = ! empty( $item->description ) ? '<p>'.esc_attr( $item->description ).'</p>' : ''; // aqui é aonde a informação está a descrição

if($depth != 0)
{
$description = $append = $prepend = "";
}

$item_output = $args->before;
$item_output .= '<a>';
$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 .= '</a>';
$item_output .= $args->after;

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

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:

1	'walker' => new descricao_walker()

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

9 comentários

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

Veja os outros posts de Paulo Rodrigues

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!

Artigos

Criando Menus no WordPress

Habilitando e registrando o menu

Retornando o menu

Habilitando descrição

Por Paulo Rodrigues

Nós fazemos

Posts recentes

Artigos

Criando Menus no WordPress

Habilitando e registrando o menu

Retornando o menu

Habilitando descrição

Por Paulo Rodrigues

Tag Cloud

Nós fazemos

Posts recentes