Change Parent Name with wp_list_pages?

Question

I use the following line in a code which outputs subpages and a parent. This code outputs the name of the parent page. I would like to replace this with the word "Overview."

How do I achieve this in wp_list_pages with as little code as possible? Thanks!

$children = wp_list_pages("title_li=yo&include=".$post->post_parent."&echo=0"); // list the parent page

The full code:

<?php
    if ( is_page() ) {
    $parent = get_post($post->post_parent);
    $parent_title = get_the_title($parent);
    $grandparent = $parent->post_parent;
    $grandparent_title = get_the_title($grandparent);
    $current_page_parent = ( $post->post_parent ? $post->post_parent : $post->ID );

    // is the homepage the granparent? = third level page
    if ($grandparent == is_page('0')) {
        $children = wp_list_pages("title_li=&include=".$post->post_parent."&echo=0"); // list the parent page
        $children .= wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0"); // append the list of children pages to the same $children variable
        if ($children) {
            ?>
            <ul class="submenu">
              <?php echo $children; /*print list of pages*/ ?>
            </ul>
        <?php
        }

    // is the homepage the parent? = second level page
    } elseif ($post->post_parent ==is_page('0')) {
        $children = wp_list_pages('title_li=&child_of='.$post->ID.'&echo=0');
        if ($children) {
            ?>
            <ul><li class="current_page_item"><a href="<?php echo get_permalink( $parentid ) ?>">Overview</a></li><?php echo $children; ?></ul>
        <?php
        } else {// your else stuff
        } } }
?>

Answer 1

You could of course use some preg_replace() tricks to solve this, but here's a little (untested) idea using the the_title filter instead:

add_filter( 'the_title', 'wpse_title' ); 
$children = wp_list_pages("title_li=&include=".$post->post_parent."&echo=0");    

where our filter callback is:

function wpse_title( $title )
{
    remove_filter( current_filter(), __FUNCTION__ );
    return __( 'Overview' );
}

Remark 1:

I think you should consider replacing the wp_list_pages() method of generating the single parent link and instead use get_permalink( $parent_id ) or get_page_link( $parent_id ) from the parent page ID. Then you can easily from control the link name.

 <li>
      <a href="<?php echo get_permalink( $parent_id ); ?>">Overview</a>
 </li>

You already use this for one of the levels, so why not for others as well?

Remark 2:

You could also use get_post_ancestors() to help you get the current tree level position.

For example:

$ancestors_ids = get_post_ancestors( get_the_ID() );
$level         = count( $ancestors_ids ) ;

Then you can get the parent ID, of the current page, with:

$parent_id = ( $level > 0 ) ? array_shift( $ancestors_ids ) : 0;

Here's an example of how the case $level = 2 could look like:

<ul class="submenu">
    <li>
        <a href="<?php echo get_permalink( $parent_id ); ?>">Overview</a>
    </li>
    <?php echo wp_list_pages("title_li=&child_of=".$parent_id."&echo=0&depth=1"); ?>
</ul>

Maybe your $level = 1 could then be:

<ul class="submenu">
    <li>
        <a href="<?php echo get_permalink( $parent_id ); ?>">Overview</a>
    </li>
    <?php echo wp_list_pages("title_li=&child_of=".get_the_ID()."&echo=0&depth=1"); ?>
</ul>

etc ..

Answer 2

Try this code snippets once:

$args = array('post_type' => 'page', 'parent' => 0);
  $parent_pages = get_pages($args);
  if( $parent_pages ){
    echo '<ul>' . "\n";
    foreach( $parent_pages as $page){
      $children = wp_list_pages("title_li=&child_of=".$page->ID."&echo=0");
      if( $children ) {
        echo '<li><a href="'. get_page_link( $page->ID ) .'">Overview</a></li>' . "\n"  ;
        echo '<ul>' . "\n";
        echo $children;
        echo '</ul>' . "\n";
      }else{
        echo '<li><a href="'. get_page_link( $page->ID ) .'">' . $page->post_title . '</a></li>' . "\n" ;
      }
    }
    echo '</ul>' . "\n";
  }

But I have a question. what will happen with child pages of sub pages? If one sub page treat as a parent page then it will convert to overview text?