4%29 Preview template - ChrisWinters/includes GitHub Wiki

When previewing an Include a custom empty template is used to display the content - this feature can be enabled and disabled within settings. The preview is only viewable to logged in administrators. The purpose of the blank template is to show off an example of saved Includes to ensure the content works as expected.

Advanced users can override the default template by creating the file template-parts/includes-preview.php. Once defined the plugin will automatically use that template to preview saved Includes.

The preview template comes with two action hooks before and after content display.

Template hook: do_action('includes_before_content');

/**
 * Open container, row, and col before included content.
 */
function includes_before_content(): void {
	$html  = '<div class="container">';
	$html .= '<div class="row">';
	$html .= '<div class="col">';
	return $html;
}

add_action( 'includes_before_content', 'includes_before_content' );

Template hook: do_action('includes_after_content');

/**
 * Close col, row, and container after included content.
 */
function includes_after_content(): void {
	$html  = '</div><!-- .col -->';
	$html  = '</div><!-- .row -->';
	$html .= '</div><!-- .container -->';
	return $html;
}

add_action( 'includes_after_content', 'includes_after_content' );