KBoard에서 통합 페이지(게시판 페이지) 설정이 되어 있지 않을 때 발생하는 리다이렉트 파라미터와 SEO 문제를 해결하기 위한 방안을 안내해 드립니다.

1. 통합 페이지 설정 권장

KBoard는 게시판별로 특정 페이지를 매핑하여 고유한 URL 구조를 생성합니다. 가장 깔끔한 해결책은 워드프레스 내에 빈 페이지를 하나 만드신 후, KBoard 게시판 설정에서 해당 페이지를 통합 페이지로 지정하는 것입니다. 이렇게 하면 해당 페이지의 슬러그를 기반으로 주소가 생성되어 파라미터 노출을 최소화할 수 있습니다.

2. kboard_content_get_url 필터훅 활용

상세 페이지의 URL 생성 방식을 강제로 변경하고 싶다면 kboard_content_get_url 필터훅을 사용할 수 있습니다. 테마의 functions.php 파일에 아래와 같은 형태로 코드를 추가하여 URL 구조를 커스텀할 수 있습니다.

add_filter('kboard_content_get_url', 'my_kboard_content_get_url', 10, 2);

function my_kboard_content_get_url($url, $content){

// 여기서 $url 변수를 원하는 구조로 재구성하여 리턴합니다.

return $url;

}

3. SEO 플러그인(Rank Math 등) Canonical 수정

이미 생성된 파라미터 주소가 canonical로 잡히는 문제는 Rank Math의 필터훅을 사용하여 해결해야 합니다. rank_math/frontend/canonical 필터를 사용하여 URL에 포함된 kboard_content_redirect 파라미터를 제거한 순수 URL만 반환하도록 설정하면 SEO 오염을 방지할 수 있습니다.

4. 리다이렉트 방지 로직 점검

KBoard 코어 파일 내에서 게시판 ID와 페이지 ID가 매핑되지 않았을 때 자동으로 리다이렉트 주소를 생성하는 로직이 작동합니다. 이를 근본적으로 막으려면 앞서 말씀드린 통합 페이지 매핑이 가장 확실한 방법이며, 매핑이 어려운 특수한 상황이라면 별도의 PHP 로직으로 $_GET['kboard_content_redirect'] 값이 들어올 때 canonical 태그만 강제로 교체하는 코드를 삽입해야 합니다.

추가로 구체적인 코드 구현 방법이나 특정 상황에 맞는 필터 적용이 필요하시면 코스모스팜 공식 커뮤니티의 기술지원 게시판을 활용해 보시는 것을 추천드립니다.