Получение пути к файлу родительской темы в WordPress

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

Использование

Функция использует:

• get_template_directory()

Формат вызова

get_parent_theme_file_path( $file );

Где:

• $file (string) — имя файла, путь к которому нужно получить в директории темы. По умолчанию значение пустое (''), что означает, что функция вернёт путь к основной директории темы.

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

echo get_parent_theme_file_path();
// > /home/example.com/public_html/wp-content/themes/theme_name

Этот код вернёт путь к папке текущей темы.

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

echo get_parent_theme_file_path( '/js/custom.js' );
// > /home/example.com/public_html/wp-content/themes/theme_name/js/custom.js

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

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

Функция возвращает строку — путь к файлу.

Как это работает

Функция сначала убирает началь��ый слэш (/) из имени файла. Если файл не указан, то функция вернёт путь к основной директории темы. Если файл указан, будет создан полный путь к нему.

Код функции

function get_parent_theme_file_path( $file = '' ) {
    $file = ltrim( $file, '/' );

    if ( empty( $file ) ) {
        $path = get_template_directory();
    } else {
        $path = get_template_directory() . '/' . $file;
    }

    /**
     * Фильтр для пути к файлу в родительской теме.
     *
     * @param string $path Путь к файлу.
     * @param string $file Имя запрашиваемого файла.
     */
    return apply_filters( 'parent_theme_file_path', $path, $file );
}

Связанные функции

Вот несколько функций, которые могут быть вам полезны при работе с файлами тем:

• get_parent_theme_file_uri() — получает URI файла родительской темы.
• get_stylesheet_directory() — возвращает путь к директории стилей.
• get_template_directory() — возвращает путь к директории шаблонов.

Заключение

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