Add "echo" option to wp_list_pages ( as well as _page_level_out() )

[MC_incubus]

wp_list_pages() and _page_level_out() both have hardcoded echoes. The enclosed patch gives each an echo switch, while maintaining backwards compat.

[ryan]

What's the use case? Someone who doesn't want to echo would probably be using get_pages() so that they could do their own thing, yes?

[MC_incubus]

Well, the use case for me was that I wanted to use wp_list_pages() in a 'the_content' filter. Wrote a plugin that replaces <!--subpages--> with the list of pages under that current page (had a lot of requests for this).

So I need to be able to do a str_replace() to put in wp_list_pages() for <!--subpages-->

Yes, I could make a copy of the function, rename it, and modify it... but that seems silly when all I need is wp_list_pages() with a return instead of an echo.

[ryan]

Okay. It's in there.

​http://trac.wordpress.org/changeset/2566