Support

December 15, 2015 at 2:05 pm

The fix for EEH_Template::locate_template was included in the update that was released today.

December 16, 2015 at 5:17 am

Please let us know if you have any problems 🙂

The changes alter the behavior for templates that could not be overridden previously, they will check the sites current theme folder first so can be overridden using that location.

December 17, 2015 at 3:06 am

I believe so yes.

EE_Template_Layout should all run the template through locate_template(), they will all be using absolute paths but with the new changes you should be able to override them.

December 17, 2015 at 4:32 am

FHEE__EEH_Template__locate_template__template_folder_paths can be used to add additional paths to search but again it depends on which template file.

but the path list is modified (theme path and original filepath added) after the filter, so the user doesn’t really have the ability to change the path list.

That only happens with templates using an absolute path, the theme is checked for the template file, then the absolute path that was passed to the locate_template() call is used.

You can still load custom versions of the file from within your theme (although I do agree with your point about using get_stylesheet_directory() for child themes)

You can also use ‘FHEE__EEH_Template__locate_template__full_template_paths’ to alter the template paths after all changes have been made. There’s a little extra work involved as you need to use basename() to grab the template filename from one of the paths, then add another full custom path to the array in whichever order you prefer.

December 17, 2015 at 6:47 am

We won’t be adding a different way to include custom template paths in the near future locate_template allows for custom versions to load, however I have created a ticket to use get_stylesheet_directory() so that templates locate checks the child theme.

I’ll check in with developers to confirm this and update this thread shortly.

December 17, 2015 at 9:12 am

I can’t say 100% that we will not modify that function, but currently we have no plans to alter how templates using absolute paths are overridden.

You can load custom templates by placing the custom template (with the same name) within your theme root directory.

So currently if you want to load custom templates within a different directory than root you can use a function like this:

function theme_directory_espresso_locate_template( $full_template_paths ) {

	//Pull a single template path from the array and use that to find the filename currently being searched for.
	$single_template_full_path = reset( $full_template_paths );
	$template_filename = basename( $single_template_full_path);

	//Build the new full template path to check within iced-mocha
	$theme_espresso_template_dir = get_stylesheet_directory() . '/content/espresso/' . $template_filename;

	//Add the new template path to the paths check by locate_template()
	array_unshift( $full_template_paths, $theme_espresso_template_dir );
	
	return $full_template_paths;

}
add_filter( 'FHEE__EEH_Template__locate_template__full_template_paths', 'theme_directory_espresso_locate_template' );

That will load from your child theme within the /content/espresso/ directory.

December 17, 2015 at 9:32 am

You’re most welcome 🙂

Please let us know if you have any further questions.