KBoard SEO 메타 태그 제거 방법과 중복 메타 해결 과정

워드프레스에서 게시판 플러그인인 KBoard를 사용하다 보면 KBoard SEO 메타 태그 제거가 필요한 경우가 있습니다. Rank Math나 다른 SEO 플러그인을 함께 쓰고 있는데 게시판 페이지 소스에서 KBoard SEO 메타 태그와 SEO 플러그인 메타 태그가 함께 보인다면 한쪽 설정을 정리해 주는 것이 좋습니다.

저도 게시판 페이지의 소스 코드를 확인하다가 description, canonical, og 태그가 겹쳐 보이는 것을 보고 처음에는 SEO 플러그인 설정 문제라고 생각했습니다. 그런데 확인해보니 KBoard 자체에서도 게시판용 SEO 태그를 출력하고 있었고, 이 부분을 따로 비활성화해야 중복 문제가 줄어들었습니다.

KBoard SEO 메타 태그 제거가 필요한 상황

KBoard는 게시판 페이지에 맞춰 자체적으로 메타 정보를 출력합니다. 단독으로 사용할 때는 큰 문제가 되지 않지만, Rank Math SEO 같은 플러그인을 함께 쓰면 같은 역할의 태그가 두 번 들어갈 수 있습니다.

이런 상태에서는 검색 엔진이 대표 설명이나 canonical 주소를 해석할 때 불필요한 신호가 생길 수 있습니다. 특히 게시판 페이지를 검색에 노출시키고 있다면 메타 설명과 대표 URL이 한쪽에서만 정리되는 편이 더 안정적입니다.

자식 테마 functions.php에서 먼저 처리하기

가장 먼저 시도해볼 수 있는 방법은 자식 테마의 functions.php 파일에 코드를 추가하는 방식입니다. 테마 파일 편집기로 들어가 Astra Child 같은 자식 테마를 선택한 뒤 functions.php를 열면 됩니다.

아래 코드를 functions.php 하단에 추가합니다.

add_action('init', 'my_init');

function my_init(){

    include_once KBOARD_DIR_PATH . '/class/KBSeo.class.php';

    $seo = new KBSeo();

    remove_action('kboard_head', array($seo, 'ogp'));
    remove_action('kboard_head', array($seo, 'twitter'));
    remove_action('kboard_head', array($seo, 'description'));
    remove_action('kboard_head', array($seo, 'author'));
    remove_action('kboard_head', array($seo, 'date'));
    remove_action('kboard_head', array($seo, 'canonical'));
    remove_action('kboard_head', array($seo, 'rss'));
}

코드를 넣은 뒤에는 워드프레스 캐시와 LiteSpeed Cache를 함께 삭제하고 게시판 페이지 소스를 다시 확인하는 것이 좋습니다. 이 방법으로 해결되면 플러그인 원본 파일을 건드리지 않아도 되기 때문에 관리가 편합니다.

코드 추가로 해결되지 않을 때 확인할 파일

functions.php 방식으로 KBoard SEO 메타 태그 제거가 되지 않는다면 KBoard 플러그인 내부 파일을 직접 확인해야 합니다. 수정 대상은 보통 아래 경로에 있습니다.

/wp-content/plugins/kboard/class/KBSeo.class.php

이 파일 안에는 KBoard SEO 메타 태그를 출력하는 코드가 들어 있으며, description, canonical, Open Graph 관련 설정도 함께 포함되어 있습니다.

add_action('kboard_head', array($this, 'ogp'));
add_action('kboard_head', array($this, 'twitter'));
add_action('kboard_head', array($this, 'description'));
add_action('kboard_head', array($this, 'author'));
add_action('kboard_head', array($this, 'date'));
add_action('kboard_head', array($this, 'canonical'));
add_action('kboard_head', array($this, 'rss'));

이 부분을 제거하거나 주석 처리하면 KBoard에서 출력하던 SEO 메타 태그가 더 이상 나오지 않습니다. 다만 플러그인 원본 파일을 수정하는 방식이라 KBoard 업데이트 후 다시 원래대로 돌아갈 수 있다는 점은 기억해야 합니다.

FileZilla로 KBSeo.class.php 수정하기

서버 파일을 직접 수정할 때는 FileZilla를 많이 사용합니다. FileZilla 공식 사이트에서 Client 버전을 내려받고 설치하면 됩니다.

다운로드 화면에서 여러 버전이 나오면 무료 버전을 선택하면 됩니다. 일반적인 워드프레스 파일 수정에는 무료 버전만으로 충분합니다.

Lightsail이나 일반 VPS에 접속할 때는 SFTP 방식으로 연결하는 경우가 많습니다. 호스트에는 서버 IP를 넣고, 포트는 22번을 사용합니다. 사용자명과 키 파일은 서버 환경에 맞게 입력해야 합니다.

접속 후에는 KBoard 플러그인 폴더로 이동한 뒤 class 폴더 안에서 KBSeo.class.php 파일을 찾습니다.

파일을 우클릭한 뒤 보기 또는 편집을 선택하면 로컬 편집기로 열립니다. 수정 후 저장하면 FileZilla에서 변경 파일을 다시 업로드할지 묻습니다.

파일스터 플러그인으로 수정하는 방법

FTP 접속이 어렵다면 워드프레스 관리자 화면에서 파일스터 플러그인을 사용할 수도 있습니다. 플러그인 추가 화면에서 파일 관리자 프로 또는 파일스터를 검색한 뒤 설치하면 관리자 안에서 파일을 열 수 있습니다.

파일스터로 들어간 뒤 같은 경로로 이동합니다.

/wp-content/plugins/kboard/class/

여기서 KBSeo.class.php 파일을 찾아 수정하면 됩니다. 다만 관리자 화면 안에서 플러그인 원본 파일을 바꾸는 방식이므로, 수정 전에는 파일을 내려받아 백업해두는 편이 안전합니다.

문제 원인 정리

이번 문제의 핵심은 KBoard와 SEO 플러그인이 서로 비슷한 역할을 동시에 수행한다는 점이었습니다. KBoard는 게시판용 KBoard SEO 메타 태그를 넣고, Rank Math 같은 SEO 플러그인은 사이트 전체 SEO 태그를 관리합니다.

둘 중 하나만 출력되면 괜찮지만, 둘 다 같은 페이지에서 작동하면 description, canonical, Open Graph 태그가 겹칠 수 있습니다. 그래서 SEO 플러그인을 기준으로 사이트 메타 정보를 관리하고 있다면 KBoard SEO 메타 태그 제거를 통해 게시판 쪽 출력을 줄이는 방식이 더 깔끔합니다.

수정 후 확인할 부분

수정이 끝났다면 바로 게시판 페이지 소스를 확인해야 합니다. 브라우저에서 게시판 페이지를 연 뒤 페이지 소스 보기를 눌러 description, canonical, og 태그가 중복으로 남아 있는지 보면 됩니다.

캐시가 남아 있으면 수정한 내용이 바로 보이지 않을 수 있습니다. LiteSpeed Cache, 서버 캐시, CDN 캐시를 함께 삭제한 뒤 다시 확인하는 것이 좋습니다. 제 경우에는 캐시를 지운 뒤 게시판 페이지의 메타 태그가 한쪽으로 정리된 것을 확인할 수 있었습니다.

이후 페이지 소스를 다시 점검했을 때 중복으로 출력되던 KBoard SEO 메타 태그도 정상적으로 제거된 상태였습니다.

FAQ

관련 글 추천

• KBoard 애드센스 추가 방법 – 원하는 위치에 광고 넣은 과정 정리
• URL 표준화 설정으로 워드프레스 중복 URL 정리하는 방법
• Rank Math 페이지 매김 중복 문서 오류가 계속 발생할 때 확인할 설정
• 빙 웹마스터 도구 선명도 사용법 – 방문자 행동 분석 확인하는 방법