워드프레스 6.7 업데이트 후 케이보드 한국어 번역 문제

Last Updated: 2024년 11월 14일 2개 댓글
무료 전자책 애드센스 웨비나

워드프레스 6.7 버전이 2024년 11월 12일(우리나라 시각으로 11월 13일 오전)에 공개되었습니다. 워드프레스 6.7에서는 사용자 경험과 개발자 편의성이 크게 향상되었습니다. 특히 Twenty Twenty-Five 테마 도입과 함께 사이트 편집 인터페이스를 혁신적으로 개선했으며, 쿼리 루프 블록 성능 최적화, HEIC 이미지 업로드 지원 등 실용적인 기능들을 추가했습니다.

이번 업데이트의 핵심은 개발자 친화적인 API와 성능 최적화에 있습니다. PHP 8.x 호환성 강화, 새로운 템플릿 등록 API, 인터랙티비티 API 개선 등을 통해 워드프레스 생태계의 기술적 발전을 도모했으며, 500개 이상의 버그 수정과 200개 이상의 코어 기능 개선을 통해 전반적인 안정성과 사용성을 높였습니다.

워드프레스 6.7은 메이저 버전이므로 중요한 사이트인 경우 업데이트를 실시하기 전에 백업을 실시할 것을 권장합니다.

워드프레스 6.7로 업데이트 후에 케이보드에서 한국어 번역이 제대로 로드되지 않는 문제가 발생하고 있습니다. 곧 케이보드 개발자가 이 문제를 해결하는 업데이트를 릴리스할 것이라 생각됩니다. 이 글에서는 Kboard 업데이트가 나올 때까지 임시적으로 해결하는 방법에 대하여 설명하겠습니다.

워드프레스 6.7의 주요 특징

워드프레스 6.7은 사용자 경험과 개발자 생산성을 크게 향상시킨 버전으로, Twenty Twenty-Five라는 새로운 기본 테마와 함께 확대/축소 보기, HEIC 이미지 업로드 지원, 유동적 타이포그래피 기능 등을 도입했습니다. 개발자를 위한 새로운 API(템플릿 등록, 미리보기 옵션, 인터랙티비티)와 블록 에디터의 445개 개선, 464개 버그 수정, 55개 접근성 개선을 통해 워드프레스 생태계의 기술적 발전을 이끌었으며, PHP 8.x 호환성 강화와 스크립트 로더 최적화 등으로 전반적인 성능과 안정성을 높였습니다.

사용자 경험 개선

  • Twenty Twenty-Five라는 새로운 기본 테마 출시
  • 사이트 편집을 위한 확대/축소 보기 기능 추가
  • 쿼리 루프 블록 성능 최적화
  • 데이터 보기 인터페이스 개선

미디어 및 파일 지원

  • HEIC 이미지 업로드 지원
  • 자동 이미지 크기 조정 기능
  • 배경 이미지 지원 확대

타이포그래피 기능

  • 글꼴 크기 프리셋 추가
  • 유동적 타이포그래피 기능 도입
  • 다양한 화면 크기에 대응하는 텍스트 크기 조정

개발자를 위한 API

  • 새로운 템플릿 등록 API
  • 미리보기 옵션 API 추가
  • 인터랙티비티 API 개선
  • 블록 바인딩 API 업데이트

기술적 개선 사항

  • PHP 8.x 호환성 강화
  • 스크립트 로더 최적화
  • 보안 메커니즘 강화
  • 성능 및 로딩 속도 개선

기타 주요 업데이트

  • 500개 이상의 버그 수정
  • 200개 이상의 코어 기능 개선
  • 블록 라이브러리 사용성 향상

워드프레스 6.7 업데이트 후 케이보드 한국어 번역 문제

워드프레스 6.7에서 국제화(i18n)의 개선으로 인해 플러그인 번역 로딩 방식이 변경되었습니다. 이 변경사항에 따라 텍스트 도메인을 init 액션 이후에 로드해야 하며, 너무 이른 시점에 번역을 로드하면 경고 메시지가 발생하고 번역이 제대로 적용되지 않습니다. KBoard 플러그인의 현재 번역 로딩 코드가 워드프레스 6.7의 새로운 국제화 모범 사례를 따르지 않아 한국어 번역이 제대로 로드되지 않는 문제가 발생하는 것으로 보입니다.

워드프레스 6.7로 업데이트하면 한국어 버전에서도 케이보드의 문자열(입력 필드 라벨 등)이 영어로 표시됩니다.

케이보드 플러그인의 텍스트 도메인 로딩 시점을 plugins_loaded에서 init 액션으로 변경하고, 번역 파일 경로와 로딩 방식을 최적화하여 문제를 해결할 수 있습니다.

케이보드 개발자가 조만간 이 문제를 해결한 업데이트를 내놓을 것으로 생각됩니다. 업데이트가 나오기 전에 이 문제를 해결하고 싶다면 다음과 같은 방법으로 가능합니다.

1 FTP를 통해 서버에 접속하여 케이보드 설치 폴더(/wp-content/plugins/kboard)로 이동하여 index.php 파일을 엽니다.

파일질라(FileZilla)를 사용하는 경우 해당 파일을 마우스 오른쪽 버튼으로 클릭한 다음, 보기/편집을 누릅니다.

2 파일을 열고 75번 라인 부근에 있는 다음 코드를 찾습니다.

add_action('plugins_loaded', 'kboard_plugins_loaded');
function kboard_plugins_loaded(){
	if(!session_id() && (!is_admin() || kboard_id()) && !wp_is_json_request()){
		session_start();
	}
	
	// 언어 파일 추가
	load_plugin_textdomain('kboard', false, dirname(plugin_basename(__FILE__)) . '/languages');
}

위의 코드를 다음 코드로 대체합니다.

add_action('init', 'kboard_load_textdomain', 1);

function kboard_load_textdomain() {
    $current_locale = get_locale();
    $mofile = WP_PLUGIN_DIR . '/kboard/languages/kboard-' . $current_locale . '.mo';
    
    if (file_exists($mofile)) {
        load_textdomain('kboard', $mofile);
    }
    
    load_plugin_textdomain('kboard', false, dirname(plugin_basename(__FILE__)) . '/languages');
}

3 파일을 저장하여 업데이트된 파일을 서버로 업로드합니다. (파일질라에서 저장 버튼을 누르면 수정된 파일이 업로드됩니다.)

이제 케이보드 게시판을 새로 고침하면 문자열이 한글로 제대로 표시될 것입니다. 여전히 제대로 표시되지 않으면 캐시 플러그인의 캐시를 삭제하고 브라우저 캐시도 삭제해보세요. 경우에 따라 서버 캐시를 삭제해야 할 수도 있습니다.

파일을 수정하려면 FTP/SFTP를 이용할 수 있어야 합니다.

💡FTP/SFTP 사용 방법

참고

2 개 댓글

Leave a Comment

    • 도움이 되셨다니 다행입니다.워드프레스 6.7 업데이트 직후에 이 문제가 발생했지만, 지금은 케이보드가 업데이트되어 한국어 번역 문제가 수정되었을 것입니다. 케이보드 플러그인을 최신 버전으로 업데이트해보시기 바랍니다.

      응답