template_redirect
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
do_action( 'template_redirect' )Описание
Этот хук-действие выполняется непосредственно перед тем, как WordPress определяет, какую страницу шаблона загрузить.
Это удобный хук, если нужно выполнить перенаправление, полностью зная содержимое, которое было запрошено.
Примечание: загрузка другого шаблона не является хорошим применением этого хука. Если подключить другой шаблон, а затем использовать exit() или die(), последующие хуки template_redirect не будут выполнены, что может нарушить работу сайта. Вместо этого используйте хук-фильтр 'template_include', чтобы вернуть путь к новому шаблону, который вы хотите использовать. Это позволит применить альтернативный шаблон, не вмешиваясь в процесс загрузки WordPress.
Оригинал (английский)
This action hook executes just before WordPress determines which template page to load.
It is a good hook to use if you need to do a redirect with full knowledge of the content that has been queried.
Note: Loading a different template is not a good use of this hook. If you include another template and then use exit() or die(), no subsequent template_redirect hooks will be run, which could break the site’s functionality. Instead, use the ‘template_include’ filter hook to return the path to the new template you want to use. This will allow an alternative template to be used without interfering with the WordPress loading process.
Исходный код
wp-includes/template-loader.php:23
do_action( 'template_redirect' );История изменений
| Версия | Описание |
|---|---|
| 1.5.0 | Introduced. |
