WCPOS Polylang 통합
WCPOS에 Polylang 인식을 추가하여 POS가 단일 언어의 상품만 표시하도록 합니다 — 상품 검색, 카탈로그 그리드 또는 계산원 업무 흐름에 중복 번역이 표시되지 않습니다. WCPOS Pro 매장은 매장별 언어를 고정할 수 있으며, 무료 설치는 Polylang 기본 언어로 대체됩니다.
기능
- WCPOS 상품 및 옵션 REST 쿼리를 언어별로 필터링합니다.
- WCPOS fast-sync 라우트(POS가 로컬 색인을 새로 고칠 때 사용하는 가벼운
posts_per_page=-1+fields요청)를 가로채 번역 중복 항목이 클라이언트에 전달되지 않도록 합니다. - 무료 설치에서는 Polylang 기본 언어를 적용합니다.
- Pro 설치에서는 각 매장이 매장 편집기의 새 언어 섹션에서 자체 언어를 선택할 수 있습니다.
- fast-sync 페이로드를 빌드할 때 WCPOS POS 전용 상품 공개 설정을 준수합니다.
Polylang이 활성화되어 있지 않으면 통합은 아무 작업도 하지 않고 정상적으로 종료됩니다 — 오류 없이 Polylang을 활성화하기 전에 플러그인을 미리 설치할 수 있습니다.
설치
Polylang 설치
Polylang(또는 Polylang Pro)을 설치하고 사이트 언어를 평소처럼 구성합니다. 하나 이상의 언어가 기본값으로 설정되어 있는지 확인하세요.
WCPOS Polylang 설치
WCPOS 확장 기능 디렉터리의 다음 위치에서 설치합니다: WP Admin > POS > 설정 > 확장, 또는 GitHub 릴리스 페이지에서 최신 릴리스를 다운로드한 뒤 다음 경로를 통해 업로드합니다: 플러그인 > 새로 추가 > 플러그인 업로드.
(Pro) 매장별 언어 설정
WCPOS Pro에서 여러 매장을 운영하는 경우 다음 경로로 이동합니다: POS > 매장, 매장을 편집한 다음 언어 사이드바 섹션에서 해당 언어를 선택합니다. Polylang 기본 언어를 사용하려면 기본값으로 둡니다.
매장별 언어 (Pro)
WCPOS Pro에서는 플러그인이 매장 편집기 사이드바에 언어 섹션을 추가합니다. 각 매장은 단일 Polylang 언어 슬러그에 고정할 수 있으며, 해당 매장에 제공되는 상품은 해당 언어로만 필터링됩니다. 기본값으로 남겨 둔 매장은 Polylang 기본 언어를 사용합니다.
매장별 값은 매장 글에 _wcpos_polylang_language 메타로 저장되며 WCPOS Pro 매장 REST API(/wcpos/v1/stores)를 통해 노출됩니다. 따라서 다른 매장 설정처럼 POS를 통해 왕복 동기화됩니다.
호환성 참고 사항
- POS 전용 상품: WCPOS 설정에서 POS 전용 모드가 활성화되어 있으면 온라인 전용 상품 ID가 빠른 동기화 페이로드에서 제외되어 POS에 노출되지 않습니다.
- 무료 설치: 매장별로 언어를 변경하는 UI는 없습니다 — 플러그인은 Polylang의 기본 언어를 사용합니다. 매장별 언어가 필요하면 WCPOS Pro로 업그레이드하세요.
- 플러그인 사용 불가: Polylang이 비활성화되어 있으면 플러그인은 아무 작업도 하지 않습니다. 오류를 발생시키거나 POS를 차단하지 않습니다.
개발자 훅
고급 사용을 위해 플러그인은 몇 가지 필터를 제공합니다:
| 필터 | 용도 |
|---|---|
wcpos_polylang_resolved_language | 특정 요청에 사용할 언어를 재정의합니다. 확인된 슬러그 및 WP_REST_Request 객체를 받습니다. |
wcpos_polylang_default_language | 매장별 값이 설정되지 않았을 때의 대체 언어를 재정의합니다. |
wcpos_polylang_is_supported | Polylang 감지 여부와 관계없이 플러그인을 강제로 켜거나 끕니다. |
wcpos_polylang_minimum_version | 최소 Polylang 버전을 요구합니다(기본값: 버전 제한 없음). |