Question about the template-loader.php file

I am studying the WP code and have a doubt regarding the end of the /wp-includes/template-loader.php file, which handles the template that must be loaded for a certain URL request.

if($template = apply_filters('template_include', $template)){
    include($template);
}elseif(current_user_can('switch_themes')){
    $theme = wp_get_theme();
    if($theme->errors()){
        wp_die($theme->errors());
    }
}

The first part is very clear. A certain template has been set to be loaded and WP offers the possibility to filter it before proceeding.

But I don’t get the second part of it.

From the wp_get_theme() documentation, $theme will contain a Theme object. But then nothing is being included, so nothing is actually happening.

What is the purpose of that?

Answers:

Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

The conditional first checks against what gets returned from the template_include hook. In most cases, a template will be found, and there will be no issue. We’ll only move onto the 2nd conditional if template_include cannot find or cannot load the template. We then look at the WP_Theme object, which does some base-line checks to see if something is wrong with the theme. You can look at the linked WP_Theme object to see which errors can be generated, but it’s generally just making sure that the theme is reachable and readable. If something is critically wrong with the theme, it adds a notice to the object and displays it to the user to fix the error.

Do note that this error would only show up to a logged-in user with the switch themes capability (administrators by default). Presumably, they would know how to fix the error or escalate the issue to someone who does.

If there’s nothing wrong with the theme, it’s assumed to either be intentionally left out or user error ( i.e., bad filename or misspelling ). It would be unreasonable to check a file-directory for similarly named templates. It would be unreasonable to error out on a missing template if it were intentionally left out.


All methods was sourced from stackoverflow.com or stackexchange.com, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

0 0 votes
Article Rating
Subscribe
Notify of
guest

0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x