WordPress.org

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

ko:Plugin API/Action Reference/template redirect

소개

이 액션훅은 워드프레스가 어느 템플릿을 불러올 것인지를 결정하기 이전에 실행됩니다. 쿼리된 콘텐츠 전부를 리다이렉트를 하기 원할 때 유용한 훅입니다.

예제

리다이렉트 시키기

다음 예제는 비회원인 사람이 'goodies'라는 페이지를 방문했을 때 사용자정의 '가입' 페이지로 리다이렉트 시키는 예제입니다.

function my_page_template_redirect()
{
    if( is_page( 'goodies' ) && ! is_user_logged_in() )
    {
        wp_redirect( home_url( '/signup/' ) );
        exit();
    }
}
add_action( 'template_redirect', 'my_page_template_redirect' );

wp_redirect() 함수 사용 후 exit()함수 또는 die() 함수를 사용하는 것을 잊지 마세요.

다른 템플릿 불러오기

이 훅으로 다른 템플릿을 불러오는 것은 좋지 않습니다. 만약 당신이 다른 템플릿을 인클루드 하고 exit() (또는 die()) 함수를 사용하면 template_redirect 훅이 실행될 것이고, 사이트의 기능을 망가뜨릴 수 있습니다. 대신 template_include 필터훅을 사용해서 당신이 사용하고 싶은 템플릿의 경로를 리턴하는 방법을 사용하세요. 이것은 워드프레스의 로딩 프로세스를 간섭하지 않고 다른 템플릿을 사용할 수 있게 합니다.

소스 파일

이 액션은 wp-includes/template-loader.php 에 적용되었습니다.

관련 훅

See also index of Function Reference and index of Template Tags.