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

por Paulo Rodrigues 02/03/2011 Comentários

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

  • . 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