WPML 언어 전환기 사용자 정의 – 배치, 스타일 및 동작

WPML 언어 전환기의 기능

추가 설정 없이 WPML은 다음과 같은 언어 전환기를 제공합니다.

• 선택한 순서대로 사이트의 모든 활성 언어를 보여줍니다.
• 각 언어를 고유 명칭(Deutsch, Français) 또는 현재 사이트 언어(독일어, 프랑스어) 중 원하는 방식으로 표시합니다.
• 선택적으로 국기를 표시합니다(테마에 맞게 크기가 조정되는 스프라이트).
• 누락된 번역을 자연스럽게 처리합니다. 해당 언어를 건너뛰거나 해당 언어의 홈페이지로 연결합니다.
• 모든 WordPress 메뉴, 위젯 영역, 푸터 또는 글 위아래의 인라인에 배치할 수 있습니다.
• 모든 페이지 빌더 레이아웃에 사용할 수 있는 Gutenberg 블록으로 제공됩니다.
• 방해가 될 수 있는 특정 페이지(404, 결제, 계정)에서는 숨길 수 있습니다.
• 빠른 페이지 로드를 위해 렌더링된 HTML을 캐시합니다.

대부분의 사이트는 기본 제공되는 배치와 기본값을 사용합니다. 더 세밀한 제어가 필요한 테마 개발자는 WPML의 API를 사용하여 코드로 사용자 정의 전환기를 구축할 수 있습니다.

설정 위치

WPML > 설정 > 언어 전환기를 엽니다. 이 페이지는 UI 탭이 아닌 질문별로 그룹화되어 있습니다. 변경하려는 내용과 일치하는 섹션을 선택하세요.

표시되는 언어와 순서

언어 전환기 옵션 카드에는 모든 활성 언어가 나열된 드래그 앤 드롭 영역이 있습니다. 여기서의 순서가 사이트의 모든 전환기에서의 순서를 결정합니다. 언어를 위아래로 드래그하여 순서를 변경하고 저장하세요.

동일한 카드에서 다음을 선택하세요.

• 고유 명칭과 현재 언어 레이블: Deutsch(고유 명칭) 또는 독일어(현재 언어)를 표시합니다. 고유 명칭은 해당 언어 사용자에게 더 친근하게 다가가며, 현재 언어는 처음 방문하는 방문자에게 더 명확합니다.
• 국기 켜기 또는 끄기: 국기 사용 여부와 국기 형식을 선택합니다.

번역이 누락된 경우 발생하는 일

모든 페이지가 모든 언어로 번역되는 것은 아닙니다. 번역이 없는 언어를 처리하는 방법 옵션은 현재 페이지의 번역이 없는 언어에 대해 전환기가 수행할 작업을 결정합니다.

• 언어 건너뛰기(기본값). 이 페이지의 전환기에서 해당 언어가 사라집니다. 방문자가 실제로 읽을 수 있는 언어만 표시되므로 가장 깔끔한 UX를 제공합니다.
• 누락된 번역에 대해 해당 언어의 홈으로 링크. 전환기 항목에 해당 언어의 홈페이지가 대신 표시됩니다. 모든 페이지에서 모든 언어에 항상 접근할 수 있도록 하려는 경우에 유용하지만, 방문자가 예상치 못한 콘텐츠에 도달할 수 있습니다.

이 선택은 UX에 영향을 미치므로 신중하게 고려할 가치가 있습니다.

전환기가 표시되는 위치

동일한 설정 페이지에서 각각 독립적으로 전환할 수 있는 5가지 배치가 있습니다.

• 메뉴 언어 전환기. WordPress 메뉴(헤더, 푸터, 사이드바 등 테마에서 메뉴를 할당하는 모든 위치)에 전환기를 배치합니다. 메뉴별로 다른 배치를 원하면 여러 개를 추가할 수 있습니다. 각 메뉴 전환기에는 배치된 위치를 보여주는 미리 보기 행이 있습니다.
• 위젯 언어 전환기. 테마에 등록된 위젯 영역(사이드바, 헤더 영역, 푸터 열)에 전환기를 추가합니다.
• 푸터 언어 전환기. 모든 페이지 하단에 전환기를 자동으로 렌더링하는 단일 전역 토글입니다.
• 글의 번역에 대한 인라인 링크. 각 글의 위나 아래에 “이 글은 X(으)로 제공됩니다”라는 링크를 표시하는 단일 확인란입니다.
• 사용자 정의 전환기. 기본 제공되는 배치로 충분하지 않은 경우 테마 개발자는 템플릿 파일에서 WPML의 전환기 API를 호출할 수 있습니다. 설정 페이지에는 렌더링 옵션을 위한 사용자 정의 버튼이 표시됩니다.

특정 페이지에서 전환기 숨기기

404 페이지, 계정 화면, 결제 등 일부 페이지에는 전환기가 필요하지 않습니다. WPML의 조건부 표시 규칙을 사용하면 테마에서 display:none CSS를 사용하지 않고도 페이지별로 전환기를 숨길 수 있습니다.

동일한 설정 > 언어 전환기 페이지에서 페이지별 규칙을 설정할 수 있습니다. 전환기를 숨길 페이지를 선택하세요. 이 규칙은 모든 전환기 배치에 한 번에 적용됩니다.

URL 파라미터 유지

방문자가 전환기를 클릭하면 WPML은 대상 언어에 대한 URL을 다시 작성합니다. 기본적으로 쿼리 문자열 파라미터(?utm_source=newsletter, 필터 파라미터 등)는 삭제됩니다. 이로 인해 분석 캠페인과 필터링된 목록이 손상될 수 있습니다.

URL 인수 유지 필드에는 전환 시 유지하려는 쿼리 키가 나열됩니다. 여기에 입력한 내용(한 줄에 하나씩)은 방문자와 함께 번역된 URL로 전달됩니다.

전환기를 위한 사용자 정의 CSS

추가 CSS 아래의 단일 텍스트 영역은 사이트의 모든 전환기에 한 번에 스타일을 적용합니다. 테마 파일을 건드리지 않고 전환기를 테마에 맞추는 데 유용합니다.

전환기 템플릿 캐싱

성능 카드에는 언어 전환기 템플릿 캐시라는 단일 확인란이 있습니다. 이 옵션을 켜면 WPML이 모든 전환기 배치의 렌더링된 HTML을 캐시하여 트래픽이 많은 사이트에서 페이지 로드 속도를 높입니다.

주의 사항: 전환기 옵션을 변경했는데 프런트엔드에 변경 사항이 반영되지 않는 경우 가장 먼저 캐시를 확인해야 합니다. 캐시를 끄고 다시 로드하면 변경 사항이 나타납니다. 그런 다음 운영 환경을 위해 캐싱을 다시 켜세요.

테마 코드의 사용자 정의 전환기

기본 제공 배치가 적합하지 않은 사이트(페이지 헤더 내부의 특정 위치에 있는 전환기, 테마에서 렌더링하는 사용자 정의 드롭다운, WordPress 메뉴 또는 위젯 영역 외부의 모든 것)를 위해 WPML은 테마 개발자가 사용자 정의 전환기를 구축할 수 있는 API를 제공합니다.

사용자 정의 언어 전환기 카드에는 활성화 토글과 사용자 정의 버튼이 있습니다. 활성화되면 테마 템플릿 코드는 WPML의 문서화된 PHP API를 사용하여 어디서나 전환기를 렌더링할 수 있습니다.