Документация WordPress

locate_template

Q: locate_template

locate_template() - это функция в WordPress, которая используется для поиска и локализации файла шаблона в вашей теме или в плагине. Эта функция особенно полезна, когда вам нужно загрузить файл шаблона для вывода определенной части вашего сайта.

locate_template() — это функция в WordPress, которая используется для поиска и локализации файла шаблона в вашей теме или в плагине. Эта функция особенно полезна, когда вам нужно загрузить файл шаблона для вывода определенной части вашего сайта.

locate_template() ищет файл шаблона с именем ‘template-parts/content.php’. Если файл найден в текущей активной теме или в плагине, он возвращается как абсолютный путь к файлу. Затем этот файл может быть загружен с помощью include, require или использован в вашем коде.

Если файл шаблона не найден, вы можете выполнить альтернативное действие или вывести сообщение об ошибке.

Функция в ядре WordPress:

<?php
/**
 * Retrieves the name of the highest priority template file that exists.
 *
 * Searches in the STYLESHEETPATH before TEMPLATEPATH and wp-includes/theme-compat
 * so that themes which inherit from a parent theme can just overload one file.
 *
 * @since 2.7.0
 * @since 5.5.0 The `$args` parameter was added.
 *
 * @param string|array $template_names Template file(s) to search for, in order.
 * @param bool         $load           If true the template file will be loaded if it is found.
 * @param bool         $load_once      Whether to require_once or require. Has no effect if `$load` is false.
 *                                     Default true.
 * @param array        $args           Optional. Additional arguments passed to the template.
 *                                     Default empty array.
 * @return string The template filename if one is located.
 */
function locate_template( $template_names, $load = false, $load_once = true, $args = array() ) {
	$located = '';
	foreach ( (array) $template_names as $template_name ) {
		if ( ! $template_name ) {
			continue;
		}
		if ( file_exists( STYLESHEETPATH . '/' . $template_name ) ) {
			$located = STYLESHEETPATH . '/' . $template_name;
			break;
		} elseif ( file_exists( TEMPLATEPATH . '/' . $template_name ) ) {
			$located = TEMPLATEPATH . '/' . $template_name;
			break;
		} elseif ( file_exists( ABSPATH . WPINC . '/theme-compat/' . $template_name ) ) {
			$located = ABSPATH . WPINC . '/theme-compat/' . $template_name;
			break;
		}
	}

if ( $load && '' !== $located ) {
		load_template( $located, $load_once, $args );
	}

return $located;
}
?>

locate_template() позволяет вам создавать более гибкие и настраиваемые темы, позволяя переопределять шаблоны по умолчанию и создавать кастомные шаблоны для разных частей вашего сайта.

theme