# WCPOS Polylang 통합

WCPOS에 [Polylang](https://polylang.pro/) 인식을 추가하여 POS가 단일 언어의 상품만 표시하도록 합니다 — 상품 검색, 카탈로그 그리드 또는 계산원 업무 흐름에 중복 번역이 표시되지 않습니다. WCPOS Pro 매장은 매장별 언어를 고정할 수 있으며, 무료 설치는 Polylang 기본 언어로 대체됩니다.

## 기능[​](#what-it-does "기능으로 직접 링크")

* WCPOS 상품 및 옵션 REST 쿼리를 언어별로 필터링합니다.
* WCPOS **fast-sync** 라우트(POS가 로컬 색인을 새로 고칠 때 사용하는 가벼운 `posts_per_page=-1` + `fields` 요청)를 가로채 번역 중복 항목이 클라이언트에 전달되지 않도록 합니다.
* 무료 설치에서는 Polylang 기본 언어를 적용합니다.
* Pro 설치에서는 각 매장이 매장 편집기의 새 **언어** 섹션에서 자체 언어를 선택할 수 있습니다.
* fast-sync 페이로드를 빌드할 때 WCPOS **POS 전용** 상품 공개 설정을 준수합니다.

Polylang이 활성화되어 있지 않으면 통합은 아무 작업도 하지 않고 정상적으로 종료됩니다 — 오류 없이 Polylang을 활성화하기 전에 플러그인을 미리 설치할 수 있습니다.

## 설치[​](#installation "설치으로 직접 링크")

1

#### Polylang 설치

[Polylang](https://wordpress.org/plugins/polylang/)(또는 Polylang Pro)을 설치하고 사이트 언어를 평소처럼 구성합니다. 하나 이상의 언어가 기본값으로 설정되어 있는지 확인하세요.

2

#### WCPOS Polylang 설치

WCPOS 확장 기능 디렉터리의 다음 위치에서 설치합니다: `WP Admin > POS > 설정 > 확장`, 또는 [GitHub 릴리스 페이지](https://github.com/wcpos/wcpos-polylang/releases)에서 최신 릴리스를 다운로드한 뒤 다음 경로를 통해 업로드합니다: `플러그인 > 새로 추가 > 플러그인 업로드`.

3

#### (Pro) 매장별 언어 설정

WCPOS Pro에서 [여러 매장](/ko/stores/.md)을 운영하는 경우 다음 경로로 이동합니다: `POS > 매장`, 매장을 편집한 다음 **언어** 사이드바 섹션에서 해당 언어를 선택합니다. Polylang 기본 언어를 사용하려면 *기본값*으로 둡니다.

## 매장별 언어 (Pro)[​](#per-store-language-pro "매장별 언어 (Pro)으로 직접 링크")

WCPOS Pro에서는 플러그인이 매장 편집기 사이드바에 **언어** 섹션을 추가합니다. 각 매장은 단일 Polylang 언어 슬러그에 고정할 수 있으며, 해당 매장에 제공되는 상품은 해당 언어로만 필터링됩니다. *기본값*으로 남겨 둔 매장은 Polylang 기본 언어를 사용합니다.

매장별 값은 매장 글에 `_wcpos_polylang_language` 메타로 저장되며 WCPOS Pro 매장 REST API(`/wcpos/v1/stores`)를 통해 노출됩니다. 따라서 다른 매장 설정처럼 POS를 통해 왕복 동기화됩니다.

## 호환성 참고 사항[​](#compatibility-notes "호환성 참고 사항으로 직접 링크")

* **POS 전용 상품:** WCPOS 설정에서 POS 전용 모드가 활성화되어 있으면 온라인 전용 상품 ID가 빠른 동기화 페이로드에서 제외되어 POS에 노출되지 않습니다.
* **무료 설치:** 매장별로 언어를 변경하는 UI는 없습니다 — 플러그인은 Polylang의 기본 언어를 사용합니다. 매장별 언어가 필요하면 [WCPOS Pro](/ko/getting-started/pro-license.md)로 업그레이드하세요.
* **플러그인 사용 불가:** Polylang이 비활성화되어 있으면 플러그인은 아무 작업도 하지 않습니다. 오류를 발생시키거나 POS를 차단하지 않습니다.

## 개발자 훅[​](#developer-hooks "개발자 훅으로 직접 링크")

고급 사용을 위해 플러그인은 몇 가지 필터를 제공합니다:

| 필터                               | 용도                                                                                        |
| ---------------------------------- | ------------------------------------------------------------------------------------------- |
| `wcpos_polylang_resolved_language` | 특정 요청에 사용할 언어를 재정의합니다. 확인된 슬러그 및 `WP_REST_Request` 객체를 받습니다. |
| `wcpos_polylang_default_language`  | 매장별 값이 설정되지 않았을 때의 대체 언어를 재정의합니다.                                  |
| `wcpos_polylang_is_supported`      | Polylang 감지 여부와 관계없이 플러그인을 강제로 켜거나 끕니다.                              |
| `wcpos_polylang_minimum_version`   | 최소 Polylang 버전을 요구합니다(기본값: 버전 제한 없음).                                    |

## 요구 사항[​](#requirements "요구 사항으로 직접 링크")

WooCommerce

<!-- -->

: WooCommerce가 설치 및 활성화되어 있음

Polylang

<!-- -->

: 하나 이상의 언어가 구성된 Polylang(무료 또는 Pro)

WCPOS

<!-- -->

: 무료 버전도 작동하지만, 매장별 언어 선택에는 WCPOS Pro가 필요합니다

## 관련 문서[​](#related "관련 문서으로 직접 링크")

* [WCPOS WPML 통합](/ko/extensions/wpml.md)
* [WCPOS WP Multilang 통합](/ko/extensions/wp-multilang.md)
* [다중 매장](/ko/stores/.md)
* 출처: [github.com/wcpos/wcpos-polylang](https://github.com/wcpos/wcpos-polylang)