Entry Content – Post Content Navigation

In this episode, you’ll take a look at the Genesis framework function genesis_do_post_content_nav, which is found in genesis/lib/structure/post.php. This function is setting up the arguments which are passed into the WordPress Core function wp_link_pages. The intent of this function is handle in post navigation, i.e. paginated posts. Did you know that functionality even exists?

I’m also introducing you to a PHP construct called str_replace() which allows you to swap out parts of a string by searching for a given pattern. As part of your customization hands-on work in this lab, you’ll be replacing the “Pages:” string, which is hardcoded in Genesis. You’ll need to use str_replace() or some like functionality to do this customization as this content is not filtered, meaning it is not passing through a filter event.

I do note in this episode that another strategy which StudioPress could do is to move these hardcoded literals, such as __( 'Pages:', 'genesis' ) into a configuration file as part of a “configuration architecture.”

Customized code sample

	add_filter( 'wp_link_pages_args', 'change_link_pages_args' );
	/**
	* Change the Link Pages Arguments - a demonstration of how to change
	* "unfiltered" (meaning not passed through apply_filters())
	* string data using PHP instruction str_replace().
	*
	* @since 1.0.0
	*
	* @param array $args
	*
	* @return array
	*/
	function change_link_pages_args( array $args ) {
	$args['before'] = str_replace( 'Pages:', 'Read More:', $args['before'] );
	return $args;
	}

view raw

post-content-nav.php

hosted with ❤ by GitHub