Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

Como exibir uma lista de páginas filhas para uma página pai no WordPress

Recentemente, um de nossos leitores nos perguntou como exibir páginas secundárias de uma página do WordPress. Essa é uma pergunta que recebemos com bastante frequência no WPBeginner e destaca uma necessidade comum de melhorar a navegação no site e a experiência do usuário.

Se você organizar seu site WordPress com páginas pai e filho, talvez queira exibir as páginas ou subpáginas filho na página pai principal. Isso ajuda os usuários a ver facilmente todas as informações disponíveis em uma seção específica e a navegar rapidamente para os subtópicos relevantes.

Talvez você também queira mostrar o link da página principal em cada subpágina para facilitar a navegação, criando um efeito semelhante ao de uma trilha de navegação. Essa navegação simplificada evita que os usuários se percam nas profundezas do seu site e aprimora a experiência geral de navegação.

Neste artigo, mostraremos como exibir facilmente uma lista de páginas secundárias para uma página principal no WordPress.

Displaying a list of child pages for a parent page in WordPress

Quando você precisa mostrar uma lista de páginas secundárias?

O WordPress vem com dois tipos de post padrão chamados posts e páginas. As postagens são o conteúdo do blog e geralmente são organizadas com categorias e tags.

As páginas são conteúdos únicos ou independentes que são perenes, como a página “Sobre nós” ou a página “Fale conosco”, por exemplo.

No WordPress, as páginas podem ser hierárquicas, o que significa que você pode organizá-las com páginas pai e filho. Por exemplo, talvez você queira criar uma página Product (Produto) com páginas secundárias para Features (Recursos), Pricing (Preços) e Support (Suporte).

Para criar uma página secundária, siga nosso guia sobre como criar uma página secundária no WordPress.

Depois de criar as páginas pai e filha, talvez você queira listar as páginas filhas na página pai principal.

Agora, uma maneira fácil de fazer isso é editar manualmente a página principal e adicionar uma lista de links individualmente.

Manually add child page links

No entanto, você precisará editar manualmente a página principal sempre que adicionar ou excluir uma página secundária. Não seria melhor se você pudesse simplesmente criar uma página secundária e ela apareceria automaticamente como um link na página principal?

Dito isso, vamos dar uma olhada em outras maneiras dinâmicas de exibir rapidamente uma lista de páginas secundárias na página principal do WordPress. Mostraremos três métodos para que você possa escolher o que for melhor para você:

Método 1. Exibir páginas secundárias na página principal usando um plug-in

Esse método é mais fácil e recomendado para todos os usuários.

Primeiro, você precisa instalar e ativar o plug-in Page-list. Para obter mais detalhes, consulte nosso guia passo a passo sobre como instalar um plug-in do WordPress.

Após a ativação, você precisa editar a página principal e simplesmente adicionar o seguinte shortcode onde deseja exibir a lista de páginas secundárias.

[subpáginas]

Agora você pode salvar sua página e visualizá-la em uma nova guia do navegador. Você perceberá que ela exibe uma lista simples com marcadores de todas as páginas secundárias.

Plain list of child page links

Se desejar, você pode adicionar algumas CSS personalizadas para alterar a aparência da lista. Aqui estão alguns exemplos de CSS que você pode usar como ponto de partida.

ul.page-list.subpages-page-list {
    list-style: none;
    list-style-type: none;
    background-color: #eee;
    border: 1px solid #CCC;
    padding: 20px;
}

Depois de aplicar seu CSS personalizado, você pode visualizar a página principal. Esta é a aparência em nosso site de teste do WordPress.

Child pages list with CSS

O plug-in fornece vários parâmetros de shortcode que permitem definir a profundidade, excluir páginas, número de itens e muito mais. Para obter detalhes, consulte a página do plug-in para obter a documentação detalhada.

Método 2. Listar páginas filhas de uma página pai usando o código

Esse método é um pouco avançado e requer que você adicione código ao seu site WordPress. Se você nunca fez isso antes, dê uma olhada no nosso guia sobre como copiar e colar código no WordPress.

Para listar páginas secundárias em uma página principal, você precisa adicionar o seguinte código em um plug-in de snippets de código ou no arquivo functions.php do seu tema:

function wpb_list_child_pages() { 
 
global $post; 
 
if ( is_page() && $post->post_parent )
 
    $childpages = wp_list_pages( 'sort_column=menu_order&title_li=&child_of=' . $post->post_parent . '&echo=0' );
else
    $childpages = wp_list_pages( 'sort_column=menu_order&title_li=&child_of=' . $post->ID . '&echo=0' );
 
if ( $childpages ) {
 
    $string = '<ul class="wpb_page_list">' . $childpages . '</ul>';
}
 
return $string;
 
}
 
add_shortcode('wpb_childpages', 'wpb_list_child_pages');

Na WPBeginner, sempre recomendamos adicionar código no WordPress com o plug-in WPCode.

O WPCode permite que você adicione facilmente códigos personalizados sem editar os arquivos do tema, para que você não precise se preocupar com a quebra do site.

WPCode

Primeiro, você precisa instalar e ativar o plug-in gratuito WPCode. Para obter instruções passo a passo, consulte este guia sobre como instalar um plug-in do WordPress.

Depois que o plug-in for ativado, navegue até Code Snippets ” Add Snippet no painel do WordPress. A partir daí, passe o mouse sobre a opção “Add Your Custom Code (New Snippet)” (Adicionar seu código personalizado (novo snippet)) e clique no botão “Add Custom Snippet” (Adicionar snippet personalizado).

Add a new custom code snippet in WPCode

Em seguida, você precisa escolher “PHP Snippet” como o tipo de código na lista de opções exibida na tela.

Select PHP Snippet as the code type

Em seguida, adicione um título para seu snippet, que pode ser qualquer coisa que o ajude a lembrar para que serve o código.

Agora, basta colar o código acima na caixa “Code Preview” (Visualização de código).

Paste code into the Code Preview box

Depois disso, basta alternar a chave de “Inativo” para “Ativo” e clicar no botão “Salvar snippet” na parte superior da página.

Activate and save your custom code snippet

Esse código primeiro verifica se uma página tem um pai ou se a própria página é um pai.

Se for uma página pai, ela exibirá as páginas filhas associadas a ela. Se for uma página filha, ela exibirá todas as outras páginas filhas de sua página pai.

Por fim, se essa for apenas uma página sem nenhuma página filha ou pai, o código simplesmente não fará nada. Na última linha do código, adicionamos um shortcode para que você possa exibir facilmente páginas secundárias sem modificar os modelos de página.

Para exibir páginas secundárias, basta adicionar o seguinte shortcode em uma página ou widget de texto na barra lateral:

[wpb_childpages]

Não se esqueça de salvar suas alterações e visualizá-las em uma guia do navegador. É assim que aparece em nosso site de teste.

Plain link list

Agora você pode estilizar essa lista de páginas usando algum CSS personalizado. Aqui estão alguns exemplos de código CSS que você pode usar como ponto de partida.

ul.wpb_page_list {
    list-style: none;
    list-style-type: none;
    background-color: #eee;
    border: 1px solid #CCC;
    padding: 20px;
}

Método 3. Exibição dinâmica de páginas infantis sem nenhum código curto

O uso de códigos de acesso é conveniente, mas o problema com eles é que você terá que adicionar códigos de acesso em todas as páginas que tenham páginas pai ou filho.

Você pode acabar tendo códigos de acesso em muitas páginas e, às vezes, pode até se esquecer de adicioná-los.

Uma abordagem melhor seria editar o arquivo de modelo de página em seu tema, para que ele possa exibir automaticamente as páginas secundárias.

Para fazer isso, você precisa editar o modelo main page.php ou criar um modelo de página personalizado em seu tema.

Você pode editar o tema principal, mas essas alterações desaparecerão se você alterar ou atualizar o tema. Por isso, seria melhor criar um tema filho e fazer as alterações no tema filho.

Em seu arquivo de modelo de página, você precisa adicionar esta linha de código onde deseja exibir as páginas secundárias.

<?php wpb_list_child_pages(); ?>

Isso é tudo. Seu tema agora detectará automaticamente as páginas secundárias e as exibirá em uma lista simples.

Você pode personalizar os estilos com CSS e formatação. Aqui está um exemplo de como o site da OptinMonster mostra a página principal e as subpáginas:

OptinMonster Sub Pages Example

Esperamos que este artigo tenha ajudado você a listar páginas filhas para uma página pai no WordPress. Talvez você também queira ver nosso guia sobre as páginas mais importantes a serem criadas em um novo site do WordPress e nossa comparação dos melhores construtores de páginas do WordPress do tipo arrastar e soltar para criar layouts personalizados sem nenhum código.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Divulgação: Nosso conteúdo é apoiado pelo leitor. Isso significa que, se você clicar em alguns de nossos links, poderemos receber uma comissão. Veja como o WPBeginner é financiado, por que isso é importante e como você pode nos apoiar. Aqui está nosso processo editorial.

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Reader Interactions

80 ComentáriosDeixe uma resposta

  1. Philip

    Hello this works, except that the parent is also displaying, how do i show just the child pages, thanks

    • WPBeginner Support

      The simplest method for what it sounds like you’re wanting would be to not have content on the parent page and only have your content in the child pages.

      Administrador

  2. Sachit Shori

    Thank you so much. You saved me.

    • WPBeginner Support

      You’re welcome :)

      Administrador

  3. Emmanuel Husseni

    Hello Wpbeginner,

    Please how can i sort all the child page alphabetically on the parent page. I’ve follow all step but the sub pages are showing randomly on the parent page.

    Waiting for response. ….Thanks

    • WPBeginner Support

      You would change the two instances of menu_order in our code to be: post_title

      Administrador

  4. Iyke O.

    How do I make the list collapsible on sidebar.

  5. Stacie

    Easy to follow and did the job. Thanks so much for sharing!

    • WPBeginner Support

      You’re welcome, glad our content could be helpful :)

      Administrador

  6. Aaro

    Can I assign a css class to this function? So that when I make css changes to ul elements it wouldn’t affect other ul’s on the site.
    Or any other simple solution for this?

    • WPBeginner Support

      You could add your CSS class in the ul section of the function :)

      Administrador

  7. Keshav Murthy

    Hi, WPB Team,

    Thank you so much for this Snippet and the tutorial.

    It saved my ton of time and helped me too.

    With Warm Regards,
    Keshav Murthy

    • WPBeginner Support

      Glad our tutorial could help :)

      Administrador

  8. Gary Granai

    I installed the plugin code snippets in wordpress 4.9.8

    I copied the code on https://www.wpbeginner.com/wp-tutorials/how-to-display-a-list-of-child-pages-for-a-parent-page-in-wordpress/#respond and added it to a new snippet in code snippets.

    I made a page and then a page which was given the attribute of having the first page as the parent page.

    The child parent relationship is shown in the list of pages in the attributes drop down.

    When I open the parent page I see nothing that shows a child page.

    I then tried using the functions.php page.

    I added the code copied from https://www.wpbeginner.com/wp-tutorials/how-to-display-a-list-of-child-pages-for-a-parent-page-in-wordpress/#respond to the bottom of the code on the functions page.

    When I open the parent page, I it does not display. What displays is an error message saying there is unexpected code.

    I restored the functions.php page to its original statuc.

    What changes must I make to what I have tried to do.

    • WPBeginner Support

      Hi Gary,

      Make sure that you publish the child page before testing the code. Also carefully copy the code again to make sure that you are not copying the numbers or any unexpected characters.

      Administrador

  9. Itika

    I have a question. I have added sub pages in parent page but when I am opening the site in mobile and clicking on parent page it opens the empty parent page. To view the drop down sub pages one have to hold the button of parent page. How can I fix it. I don’t want that empty page to open. I want that if we touch on parent page it opens the drop down menu.
    Please suggest how to do it.

  10. Denise

    For third level pages (grandchild), I want to show the same menu that is seen on the child pages (all the child links of the parent). With this snippet, when on a grandchild page, I only see the other grandchild pages in the menu. How would this code need to be modified to show the all child links even when on grandchild pages?

  11. vicky

    how to get child page ids not the granchild ids…………….pls help im a bigginner

  12. Meredith L

    I’m relatively new to blogging and I recently switched over to the Kale Wordpress theme. I have been trying to do page attribute pages (under the parent page Recipes) so I can have separate categories for appetizers, desserts, etc. Everything seems to go through on the admin part but then on the site itself there are no page attributes/drop down form the Recipes category. What am I doing wrong? It is all set to public so I’m not sure what the problem is.

  13. Daves

    Thank you for this code. But I don’t want this to be shown on the homepage (static page), just on the parent pages only. Please how can it be done?

    Thank you.

  14. Boris Budeck

    I am using Generatepress Theme (created a child theme from it for customizing) and I can’t get this to work. The shortcode is displayed in the output page, it seems it is not even ercognized as being a shortcode. I use Elementor widgets and neither text nor shortcode widgets work.

    Any idea of how to make it work when using elementor widgets?

  15. Frederic

    a great post, it’s exactly what I’m looking for since many hours ! and it works like a charm, just adding the code in the function.php of the theme then adding the short code in the page where I want the sub pages to appear, and voilà!!!
    wonderful, thanks a lot for your generosity !!

  16. Mariano

    Hi!

    Thanks for the code. How can I display the featured image of each child page?

  17. Ron

    Like with so many of the snippets we find, one has to go through all the comments in order to get it to work. What’s wrong with testing what you write?

  18. Alicia

    Can you do a drop down menu for parent/child pages on wordpress.com, or does it have to be the .org version?

  19. Razvan

    What if I want to display child posts, not child pages?

  20. Rudy

    Using this code ends up displaying the parent page along with the child pages, which is redundant. As I understand it, what we really need is to display only the child pages, not the parent page. Any suggested modification that can do this?

  21. Milos

    On plugins update, for some strange reason I always get an error:

    Fatal error: Cannot redeclare wpb_list_child_pages() (previously declared in …/wp-content/themes/pagelines/functions.php:25) in …/wp-content/themes/pagelines/functions.php on line 34

  22. Jeffrey Fry

    How can you also display the date of the child page?

  23. ethann

    Hello great article,
    Can you please help me creating a dropdown of child pages in parent page.I need this functionality for one of my wordpress project and i am totally newbie to wordpress.

  24. Alex

    Am I the only one that cannot get it to work?

    I have the following structure

    About
    — Page 1
    — Page 2
    — Page 3

    When on the “About” or a child page (1, 2 or 3) I would like to have a list with my parent page (About) and all children (1, 2, 3) – Anyone got that working?

    Thanks! :)

    • Kendra

      OMG sorry this is annoying Please ignore my other posts. Didn’t realize you couldn’t paste code into the comments.

      I was NOT able to get it to work with wpb_list_child_pages();

      I WAS able to get it to work with echo do_shortcode( ‘[wpb_childpages]’)

      And to get the title of the parent page, i inserted this above the child page list:
      $current = $post->ID;

      $parent = $post->post_parent;

      $grandparent_get = get_post($parent);

      $grandparent = $grandparent_get->post_parent;

      PHP if ($root_parent = get_the_title($grandparent) !== $root_parent = get_the_title($current)) {echo get_the_title($grandparent); }else {echo get_the_title($parent);

  25. Jean Bishop

    I am using this code and it works great. Is it possible to also display categories in menus along with pages?

  26. Michelle

    Hi,

    I want to do the following

    Parent page must be either for sale and or for rent
    Then I want the child for example a province (gauteng) to link to the for sale and the for rent parent.
    How do I do that?

    Michelle

  27. Zakhar

    How can i create shortcode with param, for example, [wpb_childpages id=”1″], where id=”1″ is an id of parent page?

  28. Strand

    Hi,

    Is it possible to limit the links to a specific number such as maximum 12 child pages?

    Thanks

  29. Aander

    Thank you,

    Could you explain, please, how can I organize child pages in drop down list that would be accessible through the parent page? (I don’t want the visitors could see all child pages in a form of a blogroll.)

    I.e., on the parent page I want to create drop down list (listbox) to which child pages would be added in predefined order (say in alphabetical order). After reading Introduction a visitor can proceed by choosing any page from the list at her wish (child pages has no logical connection so in any case she will search the exact page).

    Is ‘my dream’ realizable?

    Thank you again.

  30. Quantum-mecha

    How do I add pagination for Child Page?

    Thanks!

  31. Astrid

    Hi WPBeginner Staff,

    I used the code you guys provided with the “short code option” and it worked (links to child pages). However, I wanted to use the permanent option, and that didn’t work.

    When I added this line of code [ ] the parent page returns a 500 error and no child pages are displayed at atll.

    What am I doing wrong?

    On a side note if I wanted to display and excerpt with its respective image how would I go about it? Thanks!

    • Astrid

      I was able to figure this out.

      I added the code snippet then added this shortcode [wpb_childpages] to the parent page where I wanted the child pages displayed. Awesome!

      Now in order to display excerpts and an image would I use the same queries– just like posts under a category.

      Thanks in advance :)

      • Jade

        Hey I was wondering what you meant by ‘query’? How exactly did you get the excerpts and images to display in the parent page?

        Thanks!

  32. Pradeep

    Could someone confirm that the example page used in this tutorial http://optinmonster.com/how-it-works/ uses this feature or not? To me it looks like it they are using tabs, instead of child pages.

    If I’m right, could someone direct me to a resource to get that feature, as I’m desperately looking for a fluid solution like the one they have in that page?

    Many thanks,

    Pradeep

  33. Andrew Roberts

    For the non-shortcode option, you might want to let users know they need to either change
    return $string; to
    echo $string; or
    in their page template echo out the function
    echo page_list_child_pages();

    Thanks to Erik for pointing this out above

    • Gaby

      Thank you! I was wondering why the code wouldn’t work…

  34. Howard

    Hi, I can get this to work when I am visiting my domain with a subdirectory (e.g – example.com/home) but when viewing the site without this (example.com) the list of sub pages is not listed. Can anyone point me as to where I am going wrong?

    Thanks in advance – very new to Wordpress.

  35. Emily Jennewein

    How do you get this function to display the parent page itself at the top of the list along with the list of child and grandchild pages? On the child pages it does not list the parent page.

  36. Michael

    how can i customized this to just display the child page of a specific page?

  37. Yester

    How do u add a active class on the current ?

  38. Jenny

    Is there now a plugin that can do same ?

    and also can we decide where the box with submenus pages will go in any are of the page not just top of page? Using a plugin

  39. WPBeginner Staff

    Yes it can be used for custom post types. Like this:


    function wpb_list_child_pages() {

    global $post;

    if ( 'movie' == get_post_type() && $post->post_parent )

    $childpages = wp_list_pages( 'post_type=movie&sort_column=menu_order&title_li=&child_of=' . $post->post_parent . '&echo=0' );
    else
    $childpages = wp_list_pages( 'post_type=movie&sort_column=menu_order&title_li=&child_of=' . $post->ID . '&echo=0' );

    if ( $childpages ) {

    $string = '' . $childpages . '';
    }

    return $string;

    }

    add_shortcode('wpb_childpages', 'wpb_list_child_pages');

  40. Daniela

    This is great! Is there a way to do the same for Custom Post Types that have child posts?

    • Caroline

      Also wondering!

      If anyone knows, please help!

  41. dpc

    Is there a way to modify this in order to print custom post type child posts on a custom post type post page? Thanks, it is very handy!

  42. Sokeara

    It’s very greate for me! Anyways I would like to know how can I display title and thumbnail of child page to parent page.

    • Ashley Bell

      Hi, I have the same query. I really like how the list is styled on the Beginners Blueprint page but I have no idea how to start. Can someone recommend an article to read or give some advice, thanks.

  43. amitabha197

    There is an error in the pages which are not having child pages so I have slightly modified
    if( count($childpages) != 0 ) {
    $string = ” . $childpages . ”;
    }

    instead of
    if( $childpages ){
    $string = ” . $childpages . ”;
    }

    • Matt Rock

      I couldn’t get the template code “wpb_list_child_pages();” to work, but echo shortcode did the trick. Cheers!

      • Erik

        Just change the “return $string” to “echo $string” (this will print out the pages).

        • fariha

          thanks, it worked

  44. Coen Siebenheller

    I’ve added the code to the functions.php and when i add the [wpb_childpages] shortcode in side my text it works. But when try to add to one of my templates it doesn’t show a thing. Anybody knows what i’m doing wrong?

  45. Elena Rapisardi

    Great explanation!!
    Is there a way to display always the parent pages?

  46. Quin

    This is brilliant, thanks.

    Is there a way to adapt it so the Parent displays the Grandchild, and not the Child?

Deixe uma resposta

Obrigado por deixar um comentário. Lembre-se de que todos os comentários são moderados de acordo com nossos política de comentários, e seu endereço de e-mail NÃO será publicado. NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.