워드프레스 편집 화면에서 아래 위젯을 이용해 기존의 태그를 가져오거나, 새로운 태그를 작성할 수 있습니다.
그런데 WPML을 사용하는 경우에 태그를 추가할 때 작성중인 언어의 태그가 나오는 것이 아닌, 엉뚱한 언어의 태그가 달려 나오는 경우가 종종 있을 것입니다. 이 포스트에서는 그 원인이 무엇인지, 그리고 어떻게 해결할 수 있는지에 대해 작성하려고 합니다. 단, 새 버전의 에디터인 구텐베르크에서 글 작성을 한다고 가정합니다.
새로운 태그를 추가하거나, 기존 태그를 검색할 때는 WP REST API를 사용하게 됩니다. 이 때 엔드포인트는 /wp-json/wp/v2/tags/ 입니다. 조회시 GET으로, 생성시 POST로 메시지를 보냅니다.
워드프레스가 요청을 받으면 설치된 WPML 플러그인이도 초기화됩니다. 이 때 현재 사용자가 어떤 언어를 사용하는지 결정합니다. WPML이 사용자의 언어를 인식하는 방법은 몇 가지가 있지만, 가장 기본적으로 사용되는 방법은 쿠키입니다.
WPML이 언어를 위해 2개의 쿠키 값을 사용하는데 프론트를 위해서는 wp-wpml_current_language, 관리자 화면을 위해서는 wp-wpml_current_admin_language_{해시} 입니다.
WPML에서 언어를 선택할 때 이 쿠키 값이 변경됩니다. 관리자 화면 상단 관리 바에서 언어를 선택하면 이 값이 갱신됩니다.
태그 언어가 꼬이는 경우 분석
문제는 이 언어 값을 표시하는 문맥이 한 가지가 아니기 때문에 발생합니다. 이 언어 표시는 두 가지의 문맥을 가집니다.
- 현재 보여줄 언어
- 현재 편집 중인 포스트의 언어
첫번째 보여줄 언어는 포스트 편집 화면이 아닌 곳에서 나타납니다. 예를 들어 포스트 목록에서 나오는 언어는 현재 선택한 관리자 화면의 언어를 보여줍니다. 반면 포스트 편집 화면에서는 현재 편집 중인 포스트의 언어를 보여 줍니다.
wp-wpml_current_admin_language_{해시} 로 된 곳에 ‘en’으로 되어 있을 것입니다.
wp-wpml_current_admin_language_{해시} 로 된 곳에 ‘ko’으로 되어 있을 것입니다.사실 WPML은 이런 흐름을 생각했을 것입니다.
- 사용자가 포스트 편집을 위해 관리자 화면에서 영어를 선택합니다.
- 관리자 화면에 표시되는 언어가 영어로 표시됩니다. 또 포스트 목록에는 언어가 영어인 포스트가 나옵니다.
- 이렇게 되면 쿠키에 기록된 언어가 모두 영어로 기록되므로, 태그 검색, 작성 때에는 모두 영어로 번역된 태그를 검색할 것입니다.
그러나 문제는 아래처럼 작업하지 않을 때 발생합니다.
- 사용자는 언어를 한국어로 선택한 상태(즉, 쿠키에 저장된 값은 ‘ko’)입니다.
- 동료로부터 영어로 번역된 포스트의 점검을 위해 영어로 작성된 포스트 편집 URL을 전달받았습니다. 이때 불행히도 lang 파라미터가 누락되어 있었습니다.
- 대시보드의 언어는 한국어지만, URL을 통해 직접 접근하였고 lang 파라미터가 누락되어 쿠키의 값은 ‘ko’가 그대로 변하지 않습니다.
- WPML은 이 때 쿠키 값을 변경하지 않습니다. 그리고 관리자 표시 화면은 어떨까요? 포스트 편집 화면으로 들어왔고, 포스트의 언어는 영어이므로 영어로 표시가 될 겁니다.
- 그리고 태그 검색시 쿠키 값이 ‘ko’이므로 태그 검색은 한국어 태그에서 검색을 할 겁니다.
- 빰! 버그 발생. 포스트 언어는 영어인데, 태그는 한국어 태그가 달리는 현상이 발생합니다.
사용자가 F12 키를 눌러 쿠키 값을 직접 확인하지 않는 이상 이것을 직접 확인할 수 있는 방법이 없습니다. WPML이 여러 기능을 제공하기는 하지만, 너무 산만하고 어렵다는 느낌을 가지게 되는데 이런 일들이 많이 겪지 않은가 생각합니다.
WPML 버전은 4.3.19입니다. 나중에는 이런 점이 수정되었으면 좋겠네요. 이것을 어거지로 고치는 PHP쪽 코드를 아래 첨부합니다. 동작은 100% 보장하지 못하니, 적절히 의미만 캐치하셔서 사용하세요. 한편 자바스크립트 쪽에서는 미들웨어라는 게 있어서 중간에 기능을 변경하는 방법이 있는 것 같은데, 아직 그 부분은 정확히 알지 못합니다. 혹시 알아내게 되면 후속으로 포스팅하겠습니다.
<?php
add_action(
'wpml_language_cookie_added',
function ($lang_code) {
static $determined = null;
if (is_null($determined)) {
$uri = parse_url($_SERVER['REQUEST_URI']);
$ref = parse_url($_SERVER['HTTP_REFERER']);
parse_str($ref['query'] ?? '', $ref_qs);
$is_post_edit = ($_SERVER['REQUEST_METHOD'] ?? '') === 'GET' &&
($uri['path'] ?? '') === '/wp-json/wp/v2/tags' &&
($ref['path'] ?? '') === '/wp-admin/post.php' &&
($ref_qs['action'] ?? '') === 'edit' &&
isset($ref_qs['post']);
$is_new_tag = ($_SERVER['REQUEST_METHOD'] ?? '') === 'POST' &&
($uri['path'] ?? '') === '/wp-json/wp/v2/tags' &&
($ref['path'] ?? '') == '/wp-admin/post.php';
if ($is_post_edit || $is_new_tag) {
global $wpml_request_handler;
$cookie_name = 'wp-wpml_current_admin_language_' .
md5($wpml_request_handler->get_cookie_domain());
$info = wpml_get_language_information(null, $ref_qs['post']);
// 나중에 현재 언어를 쿠키 변수에서 인식한다. 이 값을 임시로 변경 처리하여
// 사용자가 현재 선택한 언어가 아닌, 현재 포스트의 언어를 참조하도록 조정한다.
$_COOKIE[$cookie_name] = $determined = $info['language_code'];
} else {
$determined = $lang_code;
}
}
}
);