블로그

site_url
워드프레스의 site_url 필터는 워드프레스가 생성하는 사이트 주소(URL)를 동적으로 변경하거나 수정할 수 있게 해주는 강력한 후크로, 테마나 플러그인 개발 시 사이트 URL이 필요한 곳에 커스텀 로직을 적용하여 URL 경로를 조작하거나, 다중 사이트 환경에서 특정 조건에 따라 URL을 다르게 반환하는 등의 용도로 사용됩니다. 이 필터는 기본적으로 get_site_url() 함수 호출 시 적용되며, add_filter('site_url', 'your_function_name', 10, 4) 형태로 사용해 자신의 함수를 연결하면, 반환되는 URL 값에 영향을 줄 수 있습니다.

site_url 필터의 주요 특징
- 작동 방식: 워드프레스 코어에서 site_url() 함수를 호출하여 URL을 가져올 때 실행됩니다.
- 매개변수: 첫 번째 매개변수로는 현재 URL 문자열이 전달되며, 사용자는 이 값을 수정하여 반환할 수 있습니다.
- 사용 예시:
  - 관리자 영역에서 URL 변경: 특정 조건(예: 관리자 페이지 여부)에 따라 관리자 URL을 다른 경로로 반환할 수 있습니다.
  - URL 리디렉션: 특정 페이지나 조건에서 다른 URL로 리디렉션할 때 사용될 수 있습니다.
  - 다중 사이트 설정: 서브디렉토리 설치 환경에서 도메인 변경 없이 URL 구조를 조절할 수 있습니다.
```
add_filter( 'site_url', 'custom_site_url_filter', 10, 2 );

function custom_site_url_filter( $url, $path ) {
    // 만약 관리자 페이지라면 특정 URL로 변경 (예: HTTPS 적용)
    if ( is_admin() ) {
        return str_replace( 'http://', 'https://', $url );
    }
    // 그 외의 경우 원래 URL 반환
    return $url;
}
```
2026년 01월 13일
login_init
로그인 폼이 초기화될 때 발생합니다.

주요 역할 및 특징
- 초기화 시점 트리거: login_init 훅은 wp-login.php 파일이 로드될 때 가장 먼저 호출되며, 실제 사용자 인증(비밀번호 확인 등) 관련 작업이 시작되기 전에 실행됩니다.
- 사용자 정의 액션 추가: 개발자는 이 훅을 사용하여 로그인 페이지에 사용자 정의 메시지를 추가하거나, 추가적인 보안 검사를 수행하거나, 특정 조건에서 사용자를 다른 페이지로 리디렉션하는 등의 작업을 할 수 있습니다.
- 보안 및 사용자 경험 개선: 기본 로그인 프로세스에 기능을 추가하여 보안을 강화하거나(예: X-Frame-Options 헤더 설정 제거 등), 사용자 경험을 맞춤 설정하는 데 활용됩니다.
- 인증 전 실행: 이 훅이 실행될 때는 아직 현재 사용자가 인증되지 않은 상태이므로, 인증된 사용자를 대상으로 하는 작업에는 적합하지 않습니다. 인증 후 작업은 init과 같은 다른 훅을 사용해야 합니다.
요약하자면, login_init은 워드프레스 로그인 페이지의 동작을 개발자가 원하는 대로 확장하고 수정할 수 있게 해주는 진입점(entry point)입니다.
2026년 01월 13일

wp_signon()은 워드프레스에서 사용자 자격증명을 받아 로그인 처리를 하는 함수로, 사용자 로그인 정보(아이디, 비밀번호, ‘remember me’ 설정)를 배열로 전달하면, 성공 시 WP_User 객체, 실패 시 WP_Error 객체를 반환하며 로그인 쿠키를 설정해 줍니다. 예제는 사용자 정보를 배열로 만들어 wp_signon()에 전달하고, 반환 값으로 로그인 성공 여부를 확인하여 오류 메시지를 출력하거나 사용자 세션을 설정하는 방식입니다.

if ( 'POST' === $_SERVER['REQUEST_METHOD'] ) {
    // POST 데이터에서 로그인 정보 가져오기
    $creds = array(
        'user_login'    => $_POST['username'], // 폼 필드 이름에 맞게 수정
        'user_password' => $_POST['password'], // 폼 필드 이름에 맞게 수정
        'remember'      => isset($_POST['rememberme']) // 'remember me' 체크 여부
    );

    // wp_signon 함수 호출
    $user = wp_signon( $creds, false ); // 두 번째 인자는 'false'로 설정하여 보안 강화

    // 로그인 결과 확인
    if ( is_wp_error( $user ) ) {
        echo '로그인 실패: ' . $user->get_error_message();
        // 로그인 실패 시 처리 (예: 오류 메시지 표시)
    } else {
        // 로그인 성공 시 처리
        // $user 객체는 성공한 사용자의 정보를 담고 있습니다.
        // wp_set_current_user($user->ID); // 세션 설정 (선택 사항, wp_signon이 자동으로 처리하는 경우도 있음)
        // wp_set_auth_cookie($user->ID); // 쿠키 설정 (선택 사항)
        echo '로그인 성공! 사용자: ' . $user->display_name;
        // 성공 후 리디렉션 등 추가 작업
        // wp_redirect( home_url() );
        // exit;
    }
}

// 관리자 사용자 'admin_user'를 자동 로그인 시키는 예시
$creds = array(
    'user_login'    => 'admin_user',
    'user_password' => 'your_secure_password', // 실제 비밀번호로 변경
    'remember'      => true
);

$user = wp_signon( $creds, false );

if ( !is_wp_error( $user ) ) {
    // 성공 시
    echo '자동 로그인 성공!';
    // 현재 사용자 설정 및 쿠키 설정 (필요시)
    // wp_set_current_user($user->ID);
    // wp_set_auth_cookie($user->ID);
} else {
    // 실패 시
    echo '자동 로그인 실패: ' . $user->get_error_message();
}

2026년 01월 10일

wp_authenticate

WordPress에서 wp_authenticate는 사용자 로그인 자격 증명(아이디/이메일 및 비밀번호)을 검증하는 핵심 함수입니다. 이 함수는 WP_User 객체를 반환하거나, 인증 실패 시 WP_Error를 반환합니다.

주의: wp_authenticate()는 단순히 인증만 수행하며, 실제 세션을 생성하고 로그인 처리(쿠키 설정)를 하려면 wp_signon()을 사용해야 합니다.

2026년 01월 10일

블로그

wp_update_user

wp_insert_user

is_email