Функция get_parent_theme_file_path() в WordPress с примерами.

Главная - WordPress Codex - Функция get_parent_theme_file_path() в WordPress с примерами.
Доступна с версии: 4.7
Раздел: Тема
Написал: Александр Сокирка

Функция get_parent_theme_file_path() в WordPress используется для получения полного пути от корневого каталога сайта до текущей родительской темы. Она не возвращает слэш на конце пути.

string get_parent_theme_file_path( string $file = '' )

Аргументы:

  • $file (string) (необязательный): Путь к файлу относительно корневого каталога родительской темы. По умолчанию пустая строка.

Возвращаемое значение:

  • (string): Полный путь к файлу в родительской теме или путь к папке с родительской темой.

Пример 1: Получение пути до папки текущей темы

Этот пример демонстрирует получение пути к корневому каталогу родительской темы. Результат аналогичен использованию функции get_template_directory().

echo get_parent_theme_file_path();
// Результат: /home/example.com/public_html/wp-content/themes/theme_name

Пример 2: Получение пути к файлу в текущей теме

В этом примере мы получаем полный путь к файлу custom.js, который находится в папке js родительской темы.

echo get_parent_theme_file_path('js/custom.js');
// Результат: /home/example.com/public_html/wp-content/themes/theme_name/js/custom.js

Пример 3: Подключение файла стилей из родительской темы

Этот пример показывает, как использовать get_parent_theme_file_path(), чтобы подключить файл стилей из родительской темы.

function genius_enqueue_parent_theme_styles() {
    // Получаем полный путь к файлу style.css в родительской теме
    $parent_style_path = get_parent_theme_file_path('style.css');

    // Проверяем, существует ли файл
    if ( file_exists( $parent_style_path ) ) {
        // Подключаем файл стилей родительской темы
        wp_enqueue_style( 'parent-theme-style', get_template_directory_uri() . '/style.css' );
    }
}
add_action( 'wp_enqueue_scripts', 'genius_enqueue_parent_theme_styles' );

Пример 4: Подключение файла скрипта из родительской темы

Этот пример демонстрирует, как подключить файл скрипта из родительской темы.

function genius_enqueue_parent_theme_scripts() {
    // Получаем полный путь к файлу custom.js в родительской теме
    $parent_script_path = get_parent_theme_file_path('js/custom.js');

    // Проверяем, существует ли файл
    if ( file_exists( $parent_script_path ) ) {
        // Подключаем файл скрипта родительской темы
        wp_enqueue_script( 'parent-theme-custom-js', get_template_directory_uri() . '/js/custom.js', array(), null, true );
    }
}
add_action( 'wp_enqueue_scripts', 'genius_enqueue_parent_theme_scripts' );

Заключение

Функция get_parent_theme_file_path() является удобным инструментом для получения полного пути к файлам в родительской теме в WordPress. Это особенно полезно при разработке дочерних тем, где доступ к ресурсам родительской темы является необходимым. Использование этой функции позволяет легко и безопасно подключать файлы из родительской темы, проверяя их наличие перед подключением.

Функция работает аналогично get_template_directory(), но позволяет указать имя файла, чтобы сразу получить путь к нему. В отличие от get_theme_file_uri(), она возвращает путь к файлу, а не URL, и не учитывает дочернюю тему. Для учета дочерней темы используйте get_theme_file_path().

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема