Add WordPress Plugin Template Files was originally published on Apr 4, 2017 and has recently been updated on Aug 5, 2020 to reflect emerging trends.
If you’ve ever worked with WooCommerce theming, you’ve probably had to copy some of their templates files to your own theme in order to override the HTML. It’s a great system that allows frontenders the ability to change the output to match designs. In this article, I’ll walk you through how to do just that — easily add WordPress plugin template files.
Just wanna get straight to the code? Click here.
Let’s get started!
In this tutorial, we’ll create a
templates folder within the plugin where we’ll add our… you guessed it, templates. Here we’ll place the templates that can be overridden in themes. These templates will be loaded via a custom plugin template function that will be called in place of WordPress’
Step 1: Locating the right template
In order for this to work, WordPress needs to be able to find the correct template file to load — the plugin or theme template. With the code below, WordPress will first look in the theme’s
templates folder, if not found then will search in the main theme’s folder and then if still not found will fallback to the plugin’s
Step 2: Loading the template file
Now that WordPress can find the right template, we need a function to load it. This is what will be used in place of
Step 3: Override the WordPress template file
Lastly, we’ll override the default WordPress template file with the code below.