Функция GET_TEMPLATE_DIRECTORY() в WordPress: описание, использование, производительность

## Функция GET_TEMPLATE_DIRECTORY() в WordPress

**Версия:** WP 1.5.0  
**Описание:** Эта функция возвращает путь к директории активной темы на вашем сайте WordPress.

### Использование
Функция используется в сочетании с другими функциями:
- get_template()
- get_theme_root()

### Вызовы функции
Функция get_template_directory() используется в get_parent_theme_file_path().

### Производительность
- 1 вызов: 0.000028 сек (очень быстро)
- 50000 вызовов: 0.17 сек (тоже быстро)

### Возвращаемое значение
**Тип:** Строка. Это путь к директории шаблона текущей активной темы.

### Как использовать функцию
Ваша задача — получить путь к директории с помощью:

```php
get_template_directory();

Примеры использования

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

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

Пример 2: Получение пути к теме с помощью константы TEMPLATEPATH

echo TEMPLATEPATH;
//> /home/example.com/public_html/wp-content/themes/theme_name

Изменения в версии

• С 1.5.0 — Функция введена.
• С 6.4.0 — Оптимизация выполнения фильтров, которые теперь запускаются только один раз для текущей темы.
• С 6.4.1 — Удалена оптимизация.

Код функции

Вот как выглядит код функции в файле wp-includes/theme.php:

function get_template_directory() {
$template = get_template();
$theme_root = get_theme_root( $template );
$template_dir = "$theme_root/$template";

/**
 * Фильтрует путь к директории активной темы.
 *
 * @since 1.5.0
 *
 * @param string $template_dir Путь к директории активной темы.
 * @param string $template     Имя директории активной темы.
 * @param string $theme_root   Абсолютный путь к директории тем.
 */
return apply_filters( 'template_directory', $template_dir, $template, $theme_root );

}

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

Следующие функции также могут быть полезны для работы с темами:

• get_parent_theme_file_path(): Путь к файлам родительской темы.
• get_stylesheet_directory(): Путь к директории стилей темы.
• get_theme_file_path(): Путь к файлу темы.
• register_theme_directory(): Регистрация директории темы.

Заключение

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