Name: file-locator
Owner: Caldera Labs
Description: Return a WordPress file path or file contents, checking in child theme, then theme, then as an absolute file path
Created: 2015-02-27 03:38:33.0
Updated: 2015-09-14 03:41:22.0
Pushed: 2015-03-14 21:05:27.0
Homepage: null
Size: 144
Language: PHP
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
Return a file path or file contents, checking in child theme, then theme, then as an absolute file path.
//Load a file called "food.html" from current themes "templates" folder
$file = calderawp_file_locator( 'templates/food.html' );
if ( is_string( $file ) ) {
echo $file;
}
//load a php file from your plugin, if a file "noms.php" of same name is not in template
$file = calderawp_file_locator( 'noms.php' );
//By default only file extensions php|html|htm are allowed.
//TO override this use the "calderawp_file_locator_allow_extensions" filter before calling it, like this:
add_filter( 'calderawp_file_locator_allow_extensions', function( $allowed, $context ) {
if ( 'slug_json_loader' === $context ) {
$allowed = array( 'json' );
}
return $allowed;
}, 10, 2 );
return calderawp_file_locator( 'hats.json', 'slug_json_loader' );
//Use a special single-{$post-type}.php, in this case single-hat.php from plugin if theme/child theme doesn't have that file.
filter( 'template_includes', function( $template ) {
if ( 'single-hat.php' == $template && ! is_file( calderawp_file_locator( $template ) ) ) {
$template = calderawp_file_locator( trailingslashit( plugin_dir_path( __FILE__ ) ) . $template );
}
return $template;
0 );
@see https://core.trac.wordpress.org/ticket/13239
Copyright 2015 CalderaWP LLC & Josh Pollock.
Licensed under the terms of the GNU General Public License version 2 or later. Please share with your neighbor.
The actual file locating code is basically copypasta from https://github.com/pods-framework/pods/blob/master/classes/PodsView (c) Pods Foundation. Much GPL, very thanks.