Criando menus e páginas administrativas no WordPress: Parte 1

Ae pessoal bem vindos a esse tutorial do Worldpress, Vamos la! eu dividi em 2 partes esse tutorial vamos a Primeira!:

Alguns plugins precisam ser configurados. Não seria interessante sugerir ao usuário que mudasse o valor de uma ou outra variável no arquivo PHP do plugin para configurá-lo como desejado. O WordPress permite que páginas administrativas sejam criadas e através delas podemos disponibilizar ao usuário uma interface que o permite configurar e tambem interagir com o plugin.

Os menus administrativos do WordPress são criados “on the fly“, ou seja, eles são recriados a cada acesso a uma das páginas da administração. Os menus são dinâmicos e podem serem modificados ou adicionados novos itens e subitens.

Para criarmos menus e páginas administrativas precisamos executar as seguintes tarefas:

  1. Criar uma função no arquivo do plugin contendo os códigos utilizados para criar os menus;
  2. Registrar tal função através da add_action() usando o gancho “admin_menu”;
  3. Criar o HTML da página a ser exibida quando o menu for clicado.

Vejamos um exemplo ilustrativo dessas tarefas.

<?php
// ...
function
prefixo_funcao_menu()
{
   
 add_options_page( 'Título na tag title', 'Título no menu', 10,
'identificao-unica', 'prefixo_funcao_conteudo' );
}
function prefixo_funcao_conteudo()
{
    echo '<div>';
    echo '...';
}
add_action( 'admin_menu', 'prefixo_funcao_menu' );
?>

No exemplo acima temos duas funções: prefixo_funcao_menu() e prefixo_funcao_conteudo().

A primeira foi registrada junto ao gancho “admin_menu” através da add_action() e quando chamada criará um novo item ao menu de Configurações através da função add_options_page().

A segunda é chamada pela função add_options_page() no quinto parâmetro e responsável por imprimir na tela o HTML da página.

O HTML da página poderia estar contido num arquivo em vez de estar englobado numa função como no exemplo acima. Neste caso a função add_options_page() deveria ser utilizada da seguinte forma:

add_options_page(
'Título na tag title', 'Título no menu', 10,
'arquivo-da-pagina-opcao.php' );

Há várias funções utilizadas para criar itens de menu em locais específicos bem como para criar novos grupos de menu, o que chamamos de “top-level menu”. Essa última opção é utilizada quando o plugin possui várias páginas e optamos por mantê-las relacionadas e organizadas.

Vejamos então como criar novos grupos de menu ou “top-level menu”. Há duas funções para esse propósito, são elas: add_menu_page() e add_submenu_page(). Essa segunda adiciona novos itens de menu ao menu principal criado com a primeira.

Observe os códigos abaixo responsáveis por criarem um novo grupo de menu com um submenu.

<?php
// ...
function prefixo_funcao_menu()
{
add_menu_page( 'Título na tag title', 'Título no menu', 10,
'pasta-plugin/treinamentos.php' );
add_submenu_page(
'pasta-plugin/treinamentos.php', 'Título na tag title', 'Título no
submenu', 10, 'pasta-plugin/inscricao.php' );
}
add_action( 'admin_menu',
'prefixo_funcao_menu' );
?>

Antes de compreendermos o código acima, vamos conhecer os parâmetros das funções utilizadas.Mas isso na segunda parte. —>

Fonte: iMasters

You can leave a response, or trackback from your own site.

Leave a Reply

Powered by WordPress | Find Low APR Credit Cards at BestInCreditCards.com | Thanks to iApplyForCreditCards.com, RPG Soundtracks and Transfer of Equity
SEO Powered by Platinum SEO from Techblissonline