이 가이드는 스프레드시트, PIM, ERP 또는 공급업체 피드 등 WordPress 외부에서 카탈로그를 관리하는 상점을 위한 것입니다. 상품은 가져오기 도구, REST API 또는 예약된 작업을 통해 WooCommerce로 전송되며, 상품 에디터를 여는 일은 거의 없습니다.
WPML, WPML Multilingual & Multicurrency for WooCommerce가 필요하며, 번역을 포함하여 가져오려면 WPML 내보내기 및 가져오기가 필요합니다.
1부. 외부에서 관리하는 다국어 상점의 작동 방식
번역 그룹으로 연결된 언어당 하나의 상품
각 언어에는 고유한 ID를 가진 자체 WooCommerce 상품이 있습니다. WPML은 언어를 번역 그룹으로 연결합니다. 원본은 상점의 기본 언어로 된 상품이며, 다른 언어는 해당 상품의 번역입니다.
예시 상점에서 Zip-Up Hoodie는 영어로 상품 14, 독일어로 121, 프랑스어로 122입니다. 이 중 어느 것에 대한 REST API 응답이든 동일한 맵을 포함합니다: "translations": {"de":"121","en":"14","fr":"122"}.
- SKU는 모든 언어에서 동일합니다. 가변 상품의 변형도 동일한 변형 SKU를 유지합니다.
- SKU는 외부 시스템의 키입니다. WooCommerce의 자체 조회인
wc_get_product_id_by_sku()는 번역이 아닌 원본 상품을 반환합니다. - 목록은 한 번에 하나의 언어를 반환합니다.
GET /wc/v3/products?sku=HP-HD-ZIP는 기본 언어만 반환합니다. 하나의 언어에 대해서는&lang=de를 추가하고, 모든 언어에 대해서는&lang=all를 추가하세요.
WPML이 모든 언어에 복사하는 항목과 번역하는 항목
상품 에디터, CSV 가져오기 또는 REST API를 통해 원본 상품이 변경되면 WPML은 다음 값을 모든 번역에 복사합니다:
- 정상가 및 할인가
- 재고 수량 및 재고 상태
- SKU, 무게 및 크기
- 상품 이미지 및 갤러리(각 언어는 이미지의 자체 복사본을 가짐)
- 카테고리 및 태그(번역된 카테고리 또는 태그로)
- 상향 판매 및 교차 판매(동일한 언어의 상품을 가리킴)
- 발행 상태
- 가변 상품의 경우: 각 변형의 가격 및 재고, 가격 범위, 새로운 전역 속성 용어(해당 번역으로, 예: Black에 대한 Schwarz 및 Noir) 및 새로운 변형
다음 항목은 번역되므로 각 언어에서 다르게 유지됩니다:
- 이름, 설명 및 짧은 설명
- 슬러그(상품의 주소, 예:
/de/produkt/kapuzenjacke-mit-reissverschluss/) - 속성 용어(예: Blue, Blau, Bleu)
- 상품별 속성 값(예: 이 상품에만 설정된 “Material”)
재고는 모든 언어에서 공유됩니다.
가격과 속성은 원본에 기록하세요. 시스템이 번역에 가격이나 속성을 기록하더라도 번역은 원본의 값을 유지합니다. 재고는 공유되므로 어느 언어에 기록하든 모든 언어의 재고가 됩니다.
두 번째 통화의 가격도 원본을 따릅니다(WooCommerce용 다중 통화 참조). REST API의 custom_prices("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) 또는 CSV 열 Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD 및 Meta: _price_USD를 사용하여 원본에 설정하세요. 그러면 모든 언어에서 해당 통화로 가격이 표시됩니다.
custom_prices는 다중 통화가 켜져 있고 통화가 상점의 통화 중 하나일 때 저장됩니다. 다음과 같이 전송하세요:
- 먼저 다중 통화를 켜세요. WPML설정다중 통화로 이동하여 다중 통화 모드 활성화를 선택하고 변경 사항 저장을 클릭하세요. 다음을 기준으로 통화 표시 아래에서 옵션(예: 사이트 언어)을 선택하고 변경 사항 저장을 클릭하세요. 그런 다음 통화 추가를 사용하여 각 통화를 추가하세요. 다중 통화가 꺼져 있으면 WPML은
custom_prices에서 아무것도 저장하지 않습니다. - 상점의 통화 코드를 사용하세요. WPML은 상점 통화의 가격만 저장합니다. 다른 코드의 가격은 저장되지 않습니다.
- 가변 상품의 경우 상위 상품이 아닌 각 변형에
custom_prices를 전송하세요. WPML은 이를 원본 변형에 저장하며 모든 언어에 표시됩니다. 상위 상품에 전송하면 저장되지 않습니다. meta_data에서 저장된 가격을 읽으세요(_regular_price_USD,_sale_price_USD,_price_USD). REST 호출에 대한 응답에는custom_prices필드가 포함되지 않습니다.
복제본 또는 독립적인 번역
WPML에는 두 가지 종류의 번역된 상품이 있습니다. 어떤 것을 가지고 있는지에 따라 가져오는 텍스트에 발생하는 일이 결정됩니다.
| 복제본 | 독립적인 번역 | |
|---|---|---|
| 설명 | WPML이 유지 관리하는 복사본 | 자체 텍스트가 있는 번역 |
| 원본을 다음 번에 저장한 후의 텍스트 | 원본의 텍스트로 대체됨 | 모든 항목 번역이 꺼져 있거나 상품이 없음으로 설정된 경우에만 유지됨 |
| 가격 및 재고 | 원본을 따름 | 원본을 따름 |
- 표시 위치: 복제본의 언어 상자에 “이 문서는 ...의 복제본이며 WPML에서 관리합니다.”라는 텍스트와 함께 독립적으로 번역 버튼이 표시됩니다.
- 복제본을 독립적인 번역으로 전환하는 방법: 복제본의 언어 상자에서 독립적으로 번역을 클릭하거나, 여러 상품의 경우 상품모든 상품으로 이동하여 번역 언어로 전환하고 상품을 선택한 다음 일괄 작업독립적으로 번역을 선택하세요.
- 2부의 프로세스에서 생성되는 항목: 프로세스 A는 모든 항목 번역을 사용하여 번역을 생성합니다. 프로세스 B는 독립적인 번역을 가져옵니다. 두 프로세스 모두 복제본이 필요하지 않습니다.
첫 번째 상품을 등록하기 전에 스토어 설정
- WooCommerce Multilingual 설정 마법사를 실행하세요. 이 마법사는 WPML Multilingual & Multicurrency for WooCommerce를 활성화할 때 열립니다. 마법사 화면에는 스토어 페이지, 전역 속성 및 다중 통화가 있습니다. 첫 번째 화면에서는 모든 언어로 상점, 장바구니, 결제 및 내 계정 페이지를 생성합니다.
- 전역 속성을 번역 가능하게 만드세요. 마법사의 “어떤 상품 속성을 번역하시겠습니까?” 화면에서 색상이나 크기와 같은 각 속성을 선택하세요. 나중에 이 설정은 상품속성편집의 번역 가능? 확인란과 동일하게 적용됩니다.
- 상품보다 속성 용어를 먼저 번역하세요. WPML번역으로 이동하여 분류 체계 탭을 열고 “번역할 분류 체계 선택”에서 속성을 선택한 다음 각 용어를 번역하세요. 모든 항목 번역을 켜면(프로세스 A) WPML이 새 용어를 대신 번역합니다.
2부. 코드 없이 구축하기
프로세스 선택: 단일 언어 또는 모든 언어
| 프로세스 A: WPML 번역 | 프로세스 B: 모든 언어 가져오기 | |
|---|---|---|
| 시스템에 보관되는 언어 | 스토어의 기본 언어만 | 모든 언어 |
| 가져오는 항목 | 원본 상품 | SKU로 연결된 원본 및 번역 |
| 번역 주체 | Private Translation Cloud(PTC) (새 탭에서 열림)를 사용한 모든 항목 번역 | 가져오기 전의 번역가 |
| 원본 텍스트가 변경될 때 | 모든 항목 번역이 변경 사항을 번역 | WPML이 번역을 업데이트가 필요한 상태로 표시하며, 다음 파일에서 새 텍스트를 가져옴 |
| 가격 및 재고 | 원본을 따름 | 원본을 따름 |
프로세스 A는 하나의 언어를 유지하면서 번역 파일 없이 다른 모든 언어를 추가하려는 스토어에 적합합니다. 프로세스 B는 PIM이나 번역가가 이미 모든 언어의 텍스트를 보유하고 있는 스토어에 적합합니다.
WooCommerce CSV 가져오기 도구 또는 WP All Import를 사용하는 프로세스 A
모든 항목 번역을 한 번 켜세요.
- WPML번역으로 이동하여 모든 항목 번역 설정을 클릭하세요.
- 콘텐츠를 선택하세요. “번역할 콘텐츠”에서 모든 상품을 유지하고 계속을 클릭하세요.
- 번역 발행 방식을 선택하세요. “발행 방법”에서 검토 없이 발행을 유지하세요.
- 모든 항목 자동 번역 활성화를 클릭하세요.
스토어의 기본 언어로만 상품을 가져오세요. 상품가져오기(WooCommerce의 CSV 가져오기 도구) 또는 All ImportNew Import(WooCommerce 애드온이 포함된 WP All Import)를 사용하세요. 파일에는 WPML 열이 필요하지 않습니다.
가져오기 자체에서 번역을 대기열에 추가합니다. 그런 다음 WPML은 모든 상품, 옵션, 카테고리 및 새 속성 용어를 각 언어로 번역하고 발행합니다. 수동으로 시작할 작업이 없으며 WPML 관리 화면 페이지를 열어 둘 필요도 없습니다. 진행 상황은 WPML번역에서 확인할 수 있습니다.
원본을 편집할 때 모든 항목 번역은 변경된 내용만 번역합니다. 나머지 번역은 그대로 유지됩니다.
모든 항목 번역은 외부 상품을 포함하여 발행된 상품을 번역합니다. 비공개 상품은 번역하지 않습니다. 임시글도 대기합니다. 임시글 자동 번역(WPML설정AI 번역의 고급 번역 에디터 상자에 있음)은 기본적으로 꺼져 있으며, 이 설정을 켜면 WPML은 임시글을 다시 저장할 때만 번역합니다. 임시글과 비공개 상품을 번역하려면 WPML번역에서 전송하세요(문제 해결 참조).
번역을 변경하려면 상품의 언어 상자에서 번역을 열고(... 번역 편집) 고급 번역 에디터에서 편집한 다음 저장 및 완료를 클릭하세요. 나중에 원본이 변경되더라도 변경되지 않은 문장에 대한 편집 내용은 유지됩니다.
WooCommerce CSV 가져오기 도구를 사용하는 프로세스 B
프로세스 B에서는 파일에 모든 언어가 포함됩니다.
첫 번째 가져오기를 수행하기 전에 가져온 번역에 대해 모든 항목 번역을 설정하세요.
- WPML번역으로 이동하세요. 모든 항목 번역이 꺼져 있으면 그대로 두고 파일로 넘어갑니다.
- WPML이 페이지, 글 및 문자열을 자동으로 번역하도록 하려면 모든 항목 번역 설정을 클릭하세요. “번역할 콘텐츠”에서 상품을 없음으로 설정하세요. 계속을 클릭하고 검토 없이 발행을 유지한 다음 모든 항목 자동 번역 활성화를 클릭하세요.
- 모든 항목 번역이 이미 켜져 있는 경우 “모든 항목 자동 번역이 활성화되었습니다” 상자에서 점 3개 메뉴를 클릭하고 콘텐츠 제한 조정을 선택한 다음 상품을 없음으로 설정하고 변경 사항 저장을 클릭하세요. 이미 진행 중인 번역은 계속 완료됩니다.
상품을 없음으로 설정하면 WPML은 가져온 상품 번역을 그대로 유지합니다. 원본이 변경되면 WPML은 해당 번역을 업데이트가 필요한 상태로 표시하며, 다음 파일에서 새 텍스트를 가져옵니다.
모든 언어가 포함된 파일 하나를 준비하세요. WooCommerce의 일반 열을 사용하고 4개의 WPML 열을 추가하세요.
| 열 | 포함 내용 | 예시 |
|---|---|---|
Meta: _wpml_import_translation_group | 언어를 연결하는 값(SKU 사용) | HP-JK-SHELL |
Meta: _wpml_import_language_code | 행의 언어 | de |
Meta: _wpml_import_source_language_code | 원본의 언어(스토어의 기본 언어이며 원본 행에서는 비워 둠) | en |
Meta: _wpml_import_after_process_post_status | WPML이 상품을 연결한 후의 상태 | publish |
- 언어별로 행을 정렬하되 원본을 먼저 배치하세요. 각 언어에서 상품이 옵션보다 먼저 옵니다.
- 상품을 임시글로 가져오기: 상품에는
Published=-1, 옵션에는1을 사용하세요. - 각 언어에 고유한 텍스트 지정: 이름, 설명, 카테고리(
Kleidung > Jacken) 및 속성 값(Blau, Grün)을 지정하세요. - 모든 언어에서 스토어의 속성 이름(
Color,Size)을 유지하세요. WPML번역분류 체계에서 속성 레이블을 번역하세요. - SKU별로 관련 상품 및 상위 상품을 지정하며, 모든 언어에서 동일한 SKU를 사용하세요.
예제 파일에 있는 옵션 상품의 독일어 행입니다.
Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish가져오기:
- 상품가져오기로 이동하여 “Choose a CSV file from your computer:”에서 파일을 선택하세요. 기존 상품 업데이트는 선택 해제한 상태로 둡니다. 계속을 클릭하세요.
- 매핑을 확인하세요. 4개의
Meta:열이 메타 데이터로 가져오기에 매핑됩니다. 가져오기 실행을 클릭하세요. - WPML내보내기 및 가져오기로 이동하세요. 화면에 “Good job. We see 33 posts that are imported and need language information.”이라고 표시됩니다. Run WPML Import를 클릭하세요.
- “Multilingual Import Complete”가 표시될 때까지 기다리세요.
3단계 전까지 모든 상품은 영어 임시글이고 모든 옵션은 영어 옵션이며, 원본에 연결된 항목은 없습니다. 3단계 이후에는 다음과 같이 변경됩니다.
- 각 상품과 각 옵션이 언어 간에 연결됩니다.
- 모든 항목이 발행됩니다.
- 번역은 독립적인 번역이 됩니다.
- 카테고리와 속성 용어가 언어 간에 연결되며, 각 언어의 옵션은 해당 언어의 용어를 사용합니다.
- 상향 판매는 같은 언어의 상품을 가리키며, 각 언어는 고유한 이미지 사본을 가집니다.
카테고리와 속성 용어는 상품 행 내에서 이동하므로 이 가져오기 도구는 별도의 분류 체계 가져오기가 필요하지 않습니다. 번역된 속성 용어가 상점에 이미 있는 경우 가져오기 도구가 이를 사용하며, Run WPML Import가 이를 원본에 연결합니다.
상품이 None으로 설정된 상태에서 WPML이 선택한 상품을 자동으로 번역하도록 하려면 다음을 수행하세요.
- 모든 항목 번역을 켜둔 상태로 유지하세요.
- 파일에
Meta: _wpml_import_tea열을 추가하고 번역할 각 상품의 값을1로 설정하세요. - 같은 파일에
Meta: _wpml_import_translation_group를 유지하세요. - 파일을 가져온 다음 WPML내보내기 및 가져오기로 이동하여 Run WPML Import를 클릭하세요. 진행 목록에 “Sending Posts for Automatic Translation”이 표시되며, WPML이 해당 상품을 번역하고 발행합니다.
WP All Import를 사용하는 B 과정
WP All Import Pro와 해당 WooCommerce 애드온이 필요합니다. 무료 버전은 사용자 정의 필드를 가져오지 않으며, WPML 열은 사용자 정의 필드입니다.
작업 순서는 속성 용어와 그 번역을 먼저 연결한 다음, 상품을 처리하는 것입니다. 그러면 번역된 상품 페이지에서 각 속성 값을 해당 언어로 제공합니다(예: Navy가 아닌 Bleu marine).
- 상점에 이미 있는 번역된 용어를 연결하세요. 상점에 이미 존재하는 번역된 속성 용어마다 상품속성으로 이동하여 해당 속성의 용어 설정을 클릭하고, 관리자 표시줄을 용어의 언어로 전환한 다음 용어의 이름을 클릭하세요. 언어 상자의 This is a translation of에서 원본을 선택하고 업데이트를 클릭하세요. 그러면 연결된 각 용어는 WPML번역분류 체계의 해당 언어 아래에 연필 아이콘을 표시합니다.
- 가져오기를 실행하기 전에 관리자 표시줄의 언어 전환기에서 관리자 언어를 상점의 기본 언어로 설정하세요.
- 카테고리를 가져오세요. All ImportNew ImportUpload a file에서 TaxonomiesProduct categories를 선택하세요. 용어 메타 아래에
_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group의 세 행을 추가하고 각각을 파일의 동일한 이름의 열에 매핑하세요. Other Category OptionsParent Term에서 상위 항목을 설정하세요. - 동일한 세 개의 용어 메타 행을 사용하여 같은 방법으로 속성 용어를 가져오세요(예: TaxonomiesProduct Color).
- 용어를 연결하세요. WPML내보내기 및 가져오기로 이동하여 Run WPML Import를 클릭하세요. WPML번역분류 체계(“Select the taxonomy to translate”에서 분류 체계 선택) 아래에서 각 용어가 각 언어의 국기 아래에 연필 아이콘이 있는 하나의 행을 가지는지 확인하세요. 연필 아이콘 위에 마우스를 올리면 번역된 이름이 표시됩니다. “+”는 해당 언어에 번역이 없음을 의미합니다. 번역된 용어가 자체 행에 나열되어 있다면 연결되지 않은 것입니다.
- 상품을 가져오세요. WooCommerce Products를 선택하세요. WooCommerce Add-On 섹션에서 SKU, 가격, 재고 및 속성을 매핑하세요. 사용자 정의 필드 아래에 3개의
_wpml_import_*행을 추가하세요. - Run WPML Import를 다시 클릭하고 Multilingual Import Complete가 표시될 때까지 기다리세요.
예제 용어 파일입니다.
name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy모든 언어를 포함하는 상품 파일의 두 가지 설정입니다.
- 옵션 행은 Set Product Type With XPath에 매핑하는 열에서 상위 항목과 동일한
variable유형을 가집니다. - 언어별 키를 사용하여 옵션을 상위 항목에 연결하세요. Variations 아래에서 All my variable products have SKUs or some other unique identifier...를 선택하고 SKU element for parent 및 Parent SKU element for variation을
HP-OW-RAIN-de와 같은 키에 매핑하세요. 모든 언어에서 동일한 실제 SKU를 GeneralSKU 및 번역 그룹에 매핑하세요. 다른 방법으로는 언어 파일당 한 번씩 가져오기를 수행하는 방법이 있습니다.
이 순서는 wp-admin, WP-CLI 또는 일정에 따라 WP All Import 가져오기를 시작하는지 여부에 관계없이 작동합니다.
일정에 따라 재고 및 가격 업데이트
원본 상품을 업데이트하세요. WPML이 즉시 재고와 가격을 모든 언어에 복사합니다.
WooCommerce CSV 가져오기 도구 사용 시:
- 변경할 열만 전송하세요. 빈 셀이 있는 열은 빈 값을 씁니다. 예제 파일은 다음과 같습니다.
SKU,Stock,Regular price,Meta: _wpml_import_language_code HP-JK-FIELD,11,95,en HP-JK-SHELL-BLU-S,5,72,en - 모든 행에 원본 언어와 함께
Meta: _wpml_import_language_code을 추가하세요. 그러면 각 행이 해당 언어의 상품인 원본을 업데이트합니다. 이 열이 없으면 행이 관리자의 현재 언어로 상품을 업데이트하므로 결과가 관리자 언어 전환기에 따라 달라집니다. - 관리자 표시줄의 언어 전환기에서 관리자 언어를 상점의 기본 언어로 설정하세요.
- 상품가져오기로 이동하여 파일을 선택하고 기존 상품 업데이트를 선택한 다음 계속 및 가져오기 실행을 클릭하세요.
가져오기 직후 모든 언어에 새 재고, 가격 및 가격 범위가 표시됩니다.
일정에 따른 WP All Import 사용:
- 공급업체의 피드 URL을 사용하여 All ImportNew ImportDownload a fileFrom URL로 이동하세요. WooCommerce Products를 선택하세요.
- WooCommerce Add-On 섹션에서 SKU, Regular Price 및 Stock Qty를 매핑하세요.
- Import Settings에서 Attempt to match to existing WooCommerce products before creating new ones를 선택하고 Custom field
_sku(으)로 일치시키세요. Create new WooCommerce products from records newly present in this import file을 끄세요. Update existing WooCommerce products with the data in this import file을 켜세요. - Choose which data to update에서 Custom Fields를 제외한 모든 항목을 끄고 Update only these Custom Fields, leave the rest alone을 선택하세요:
_regular_price, _price, _stock, _manage_stock. - 일정을 예약하세요. All ImportManage ImportsScheduling Options의 Manual Scheduling에 서버의 크론 작업을 위한 Trigger URL 및 Processing URL이 표시됩니다.
실행할 때마다 행이 원본 제품과 일치되며, 모든 언어에 각 제품과 옵션의 새 가격 및 재고가 적용됩니다.
전체 프로세스 B 파일을 업데이트로 다시 가져오는 경우 모든 행에서 Published을(를) 1(으)로 설정하세요. 그렇지 않으면 WPML 가져오기 실행을 클릭할 때까지 게시된 제품이 임시글로 변경됩니다. Update existing products를 선택한 다음 WPML 가져오기 실행을 클릭하세요. 제품은 발행됨 상태로 유지되며 파일의 텍스트가 번역을 즉시 대체합니다.
기존 카탈로그에 언어 추가
프로세스 A:
- WPML언어로 이동하여 사이트 언어 관리 및 숨기기를 클릭하고 언어 검색 및 추가…를 사용하여 언어를 선택하세요.
- 비용 계산을 클릭하세요. “Cost to translate your content into ...” 대화 상자에 항목과 단어가 나열됩니다. 저장을 클릭하세요.
모든 항목 번역은 다음에 WPML 관리 화면 페이지가 로드될 때 새 언어를 자체적으로 시작합니다. WPML은 새 언어로 된 모든 제품과 옵션을 번역하고 게시합니다. 기존 언어는 변경되지 않습니다.
프로세스 B:
- 새 언어의 행만 포함된 파일을 준비하세요. SKU를 번역 그룹으로, 원본의 언어를 원본 언어로 사용하고
Published=-1및publish을(를) 최종 상태로 사용하세요. - 제품가져오기로 이동하세요. Update existing products는 선택하지 않은 상태로 두세요. 가져오기 도구를 실행하세요.
- WPML내보내기 및 가져오기로 이동하여 WPML 가져오기 실행을 클릭하세요.
각 새 제품과 옵션은 SKU를 기준으로 일치되어 원본의 번역 그룹에 추가됩니다. 이는 한 번도 가져오지 않은 카탈로그를 포함하여 모든 카탈로그에서 작동합니다. 새 언어는 파일에서 자체 카테고리 및 속성 용어를 가져옵니다.
Update existing products는 언어를 추가하지 않으며 가져오기 도구가 해당 행을 건너뜁니다. 각 새 언어 제품은 “No matching product exists to update.”와 함께 나열되고 각 새 언어 옵션은 “A new variation cannot be created without a parent product.”와 함께 나열됩니다.
대규모 카탈로그 가져오기
- 원본을 먼저 가져오고 언어당 하나의 파일을 가져오세요.
- 마지막 파일 이후에 WPML 가져오기 실행을 한 번 수행하세요.
- 장시간 실행되는 경우 WP-CLI를 사용하세요:
wp wpml import process은(는) 버튼과 동일한 단계를 실행하고 각 단계의 개수를 보여줍니다.
3개 언어로 된 카탈로그에 대해 WooCommerce의 가져오기 도구와 한 번의 WPML 가져오기 실행을 사용했을 때 당사 연구실에서 소요된 시간은 다음과 같습니다:
| 언어당 제품 수 | 전체 가져오기 | 그중 WPML 가져오기 실행 |
|---|---|---|
| 500 | 약 30분 | 몇 분 |
| 1,000 | 약 1시간 | 약 10분 |
| 2,000 | 약 2시간 | 약 30분 |
각 규모는 한 번에 완료되었으며 모든 제품과 옵션이 모든 언어에 표시되고 연결되었습니다. 각 수치는 공유 연구실 서버에서 한 번 실행한 결과입니다. 대부분의 시간은 WooCommerce 가져오기 도구에서 소요되며 서버에 따라 다릅니다. 이 수치는 대략적인 규모로 참고하세요.
언어와 함께 제품 내보내기(WP All Export)
WP All Export는 기본적으로 WooCommerce Products 내보내기에 WPML 열 _wpml_import_language_code, _wpml_import_source_language_code 및 _wpml_import_translation_group을(를) 추가합니다. WPML 섹션에서는 모든 언어 또는 하나의 언어를 내보냅니다. 수동으로 실행하거나 일정에 따라 실행하는 내보내기 모두 해당 열을 채웁니다. 자세한 내용은 WP All Export를 사용하여 다국어 웹사이트 내보내기에서 확인하세요.
ERP 또는 PIM에서 동기화
ERP(전사적 자원 관리 시스템)는 기업에서 재고, 가격 및 주문을 관리하는 소프트웨어입니다. PIM(제품 정보 관리 시스템)은 제품 텍스트와 데이터를 관리하는 곳입니다.
이러한 시스템과 WooCommerce 간의 커넥터는 일반적으로 다음과 같이 작동합니다.
- 하나의 언어로 된 SKU를 키로 사용하여 카탈로그를 유지합니다
- SKU(
GET /wc/v3/products?sku=...)로 각 상품을 찾습니다 - WooCommerce REST API를 통해 기존 상품의 재고와 가격을 업데이트하고 새 상품을 생성합니다
- 정해진 일정에 따라 실행됩니다
WPML에서 작동하는 흐름은 다음과 같습니다.
- 커넥터는 상점의 기본 언어에만 기록합니다.
- 동일한 요청에서 WPML은 재고와 가격을 모든 언어로 복사합니다.
- 모든 항목 번역은 새 상품을 모든 언어로 번역합니다(프로세스 A).
- 커넥터가 임시글로 설정한 상품은 모든 언어에서 임시글로 변경됩니다.
- 커넥터가 삭제하는 상품은 WPML설정콘텐츠 삭제의 상품 행을 따릅니다. 동기화 중에는 아무것도 묻지 않으므로 원본 삭제를 원하는 동작으로 설정하세요. 모든 언어 삭제는 번역도 함께 제거하고, 해당 항목만은 번역을 게시된 상태로 유지합니다.
커넥터 공급업체에 다음 세 가지를 확인하세요.
- WooCommerce를 통해 기록합니까, 아니면 데이터베이스에 직접 기록합니까? 데이터베이스에 직접 기록된 변경 사항은 원본에만 적용됩니다. 번역은 이전 재고와 가격을 유지합니다.
- 어떤 언어에 기록합니까? 원본에 기록해야 합니다. 번역에 기록된 가격은 저장되지 않으며, 번역은 원본의 가격을 유지합니다.
- 언어당 하나의 상품을 생성합니까? WooCommerce는 동일한 SKU를 가진 두 번째 상품을 거부합니다. SKU가 없으면 복사본은 재고나 가격 업데이트를 받지 못하는 별개의 상품이 됩니다. 커넥터가 원본만 생성하도록 하고, WPML이 이를 번역하게 하세요.
3부. 사용자 정의 흐름 구축(개발자용)
WooCommerce REST API로 상품 및 번역 생성
먼저 용어를 생성한 다음 원본을 생성하고, lang 및 translation_of을 사용하여 각 번역을 생성하세요.
- 카테고리(및 모든 속성 용어) 번역:
POST /wp-json/wc/v3/products/categoriesJSON{ "name": "Wohnen und Geschenke", "slug": "wohnen-und-geschenke", "lang": "de", "translation_of": 32 }속성 용어의 경우 각 용어에 동일한 두 필드와 함께
POST /wc/v3/products/attributes/<id>/terms/batch를 사용하세요. - 원본 생성:
POST /wp-json/wc/v3/productsJSON{ "name": "Stoneware Coffee Mug", "type": "simple", "status": "publish", "sku": "HP-HG-MUG", "regular_price": "16.00", "manage_stock": true, "stock_quantity": 60, "categories": [ { "id": 32 } ], "lang": "en" } - 각 번역 생성: 번역된 텍스트, 번역된 카테고리,
lang및translation_of(원본의 ID)과 함께POST /wp-json/wc/v3/products를 사용합니다. SKU, 가격 또는 재고는 보내지 마세요. WPML이 원본에서 이를 복사합니다.JSON{ "name": "Steingut-Kaffeebecher", "slug": "steingut-kaffeebecher", "status": "publish", "categories": [ { "id": 38 } ], "lang": "de", "translation_of": 120 } - GET으로 결과 읽기. 생성 호출에 대한 응답에는 SKU, 가격 및 재고가 비어 있는 것으로 표시됩니다. 이는 응답이 작성된 후 WPML이 이를 복사하기 때문입니다. 직후에
GET /wc/v3/products/121을 수행하면 해당 항목이 표시됩니다.
옵션 상품의 경우 원본에만 원본의 옵션을 생성하세요(POST /wc/v3/products/<id>/variations/batch). 그런 다음 lang 및 translation_of을 사용하여 번역된 각 상위 항목을 생성합니다. WPML은 번역된 옵션을 자체적으로 생성하고, 각각을 원본 옵션에 연결하며, 해당 언어의 SKU, 가격, 재고 및 속성 용어를 복사합니다. 번역에 옵션을 게시하지 마세요.
?lang=을 사용하여 번역의 옵션 읽기: GET /wc/v3/products/137/variations?lang=fr. 각 옵션에는 lang, 해당 translations 맵 및 해당 언어의 옵션 이름이 포함됩니다.
언어당 하나의 상품 번역. 이미 번역이 있는 언어의 두 번째 상품 번역은 HTTP 400 wcml_translation_exists와 함께 거부되며 아무것도 생성되지 않습니다. 메시지에는 기존 번역의 ID가 지정됩니다. 대신 기존 번역을 업데이트하세요.
전체 필드 참조: WooCommerce Multilingual REST API.
WooCommerce REST API로 상품 업데이트
원본을 업데이트하세요. WPML은 동일한 요청에서 모든 언어로 변경 사항을 복사합니다.
{"regular_price": "59.00", "stock_quantity": 3}과 함께PUT /wc/v3/products/123/variations/124을 사용하면 모든 언어에서 해당 옵션의 가격과 재고가 변경되며 가격 범위도 이에 따릅니다.- 새로운 정상가, 할인가 또는 재고와 함께
PUT /wc/v3/products/120을 사용하면 모든 언어에서 해당 항목이 변경됩니다. - 새 속성 용어는 원본의 속성에 생성되며, 위의 1단계와 같이
lang및translation_of을 사용하여 번역됩니다. - 원본에 추가된 새 옵션(
POST /wc/v3/products/123/variations또는.../variations/batch)은 가격 및 재고와 함께 연결되어 동일한 요청에서 모든 언어에 도달합니다. 호출에 대한 응답에는 원본 언어만 나열되며, 직후에GET /wc/v3/products/130/variations?lang=de을 수행하면 새로 번역된 옵션이 나열됩니다. - 번역으로 전송된 가격이나 속성은 저장되지 않으며, 번역은 원본의 값을 유지합니다. 특정 언어로 전송된 재고 값은 모든 언어의 재고가 됩니다.
API를 통한 삭제: DELETE /wc/v3/products/<id>는 WPML설정콘텐츠 삭제의 상품 행을 따릅니다. API는 절대 묻지 않으며, 묻기로 설정된 경우 원본만 삭제합니다. 상점에서 원하는 동작으로 원본 삭제를 설정하세요. 모든 언어 삭제를 사용하면 삭제 시 모든 언어가 휴지통으로 이동하며, ?force=true는 모든 언어를 삭제합니다.
자체 가져오기 도구 또는 커넥터 작성
WooCommerce의 상품 기능을 사용하세요. WPML은 변경 사항을 확인하고 이를 모든 언어로 복사합니다.
$id = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();save() 이후 번역에 새로운 가격과 재고가 표시됩니다.
제품 데이터를 데이터베이스에 직접 쓰지 마세요(update_post_meta() 또는 SQL). 원본은 변경되지만 번역은 이전 값을 유지합니다.
WPML 열이 포함된 가져오기 후에는 코드에서 WPML 가져오기 단계를 실행하세요: wp wpml import process. Run WPML Import 버튼과 동일한 단계를 실행하고 각 단계와 개수를 출력합니다.
예약된 작업
WooCommerce의 제품 기능으로 원본을 변경하는 예약된 작업(WP-Cron)은 작업 자체의 요청에서 이러한 변경 사항을 모든 언어에 전달합니다:
- 정상가, 할인가 및 재고, 그리고 그에 따른 재고 상태
- 제품에 추가된 카테고리(번역된 카테고리로)
- 옵션 상품의 새로운 속성 용어(해당 번역으로)
- 옵션 상품의 가격 범위
4부. 문제 해결
가져온 번역이 연결되지 않은 별도의 제품으로 표시됨
증상: 번역된 행이 누락되었거나 영어(기본 언어) 제품으로 남아 있으며, 종종 비공개 상태이고 원본과의 연결이 없습니다.
원인:
- 파일에 WPML 열이 없습니다. 그러면 WooCommerce는 SKU가 이미 존재하는 모든 행을 건너뜁니다: “A product with this SKU already exists(이 SKU를 가진 제품이 이미 존재합니다).”
- 파일에 WPML 열이 있지만 WPML 가져오기 실행을 실행하지 않았습니다. 실행하기 전까지 모든 행은 원본과 연결되지 않은 기본 언어 제품이며, 파일의
Published열이 지정하는 상태(0의 경우 비공개,-1의 경우 임시글)를 가집니다. WPML내보내기 및 가져오기에 “Good job. We see 12 posts that are imported and need language information(잘하셨습니다. 가져온 글 중 언어 정보가 필요한 글이 12개 있습니다).”라고 표시됩니다.
해결 방법:
- WPML 가져오기 단계를 실행하지 않은 경우: WPML내보내기 및 가져오기로 이동하여 WPML 가져오기 실행을 클릭하세요.
- WPML 열이 없는 경우: 번역 행에 4개의 WPML 열을 추가하고 기존 제품 업데이트(Update existing products)를 선택 취소한 상태에서 새 가져오기로 다시 가져오세요. 그런 다음 WPML 가져오기 실행을 클릭하세요. 각 번역이 SKU를 통해 원본과 연결됩니다.
예방 방법: 항상 WPML 열을 포함하고, 가져오기 후에는 매번 WPML 가져오기 실행을 실행하세요.
가져온 번역이 원본 텍스트로 대체됨
증상: 번역된 이름과 설명을 가져왔지만, 원본을 다음번에 저장한 후 다시 원본 언어로 돌아갑니다.
원인: 번역이 복제본이었습니다. WPML은 원본을 저장할 때마다 복제본을 덮어씁니다.
해결 방법:
- 독립적으로 만드세요. 제품모든 제품으로 이동하여 번역 언어로 전환한 다음, 제품을 선택하고 일괄 작업독립적으로 번역을 선택하세요.
- 모든 항목 번역이 켜져 있는 경우 제품을 없음으로 설정하세요. WPML번역에서 “모든 항목 자동 번역이 활성화됨(Translate Everything Automatically is enabled)” 상자의 점 3개 메뉴를 클릭하고 콘텐츠 제한 조정(Adjust content limits)을 선택한 다음 제품(Products)을 없음(None)으로 설정하고 변경 사항 저장을 클릭하세요.
- 번역을 다시 가져오세요.
그 후에는 원본을 저장해도 가져온 텍스트가 유지됩니다.
예방 방법: 기존 번역으로 텍스트를 가져오기 전에 번역을 독립적으로 번역으로 설정하세요. 또는 WPML 열을 사용하여 번역을 새 제품으로 가져오세요(프로세스 B).
번역된 제품에 속성 값이 원본 언어로 표시됨
증상: 번역된 제품 페이지에 번역된 용어 대신 “Blue”, “Green”이 제공됩니다.
발생 원인: 속성 용어가 번역되기 전에 상품이 번역되었기 때문입니다.
지금 해결하는 방법:
- WPML → 번역으로 이동하여 분류 체계 탭을 여세요.
- “번역할 분류 체계 선택” 아래에서 속성(예: 상품 색상)을 선택하세요.
- 각 언어로 각 용어를 번역하고 저장을 클릭하세요. 동일한 화면에서 속성의 레이블을 번역하세요.
기존에 번역된 상품은 저장할 때마다 각 용어를 반영합니다. 상품을 다시 저장할 필요가 없습니다. 용어가 처음에 원본 이름의 사본으로 생성된 경우 슬러그는 원본 텍스트를 유지하므로, 동일한 대화 상자에서 변경하세요.
방지하는 방법: 상품을 번역하거나 가져오기 전에 속성 용어를 번역하세요.
가져오기 후 번역된 카테고리 또는 용어에 원본 이름이 유지됨
나타나는 현상: 번역된 상점에서 번역된 상품이 “Sunglasses”라는 카테고리에 있거나 “Blue” 옵션을 제공합니다.
발생 원인: 번역 행이 원본의 내보내기 파일에서 복사되었으며 카테고리, 태그 및 속성 용어 이름을 그대로 유지했기 때문입니다. WPML은 해당 이름으로 번역된 용어를 생성하고 올바르게 연결하지만 이름은 변경하지 않습니다. 원본의 ID로 지정된 상향 판매, 교차 판매, 이미지, 갤러리 및 변형 상위 항목은 올바른 언어로 다시 매핑됩니다.
지금 해결하는 방법: 위 섹션과 같이 WPML → 번역 → 분류 체계에서 용어 이름을 변경하세요. 이동 경로, 용어 링크, 보관함 제목 및 속성 옵션에 새 이름이 즉시 표시되며 상품을 다시 저장할 필요가 없습니다. 동일한 대화 상자에서 변경하지 않는 한 슬러그는 원본 텍스트를 유지합니다.
방지하는 방법: 번역 행에 번역된 카테고리, 태그 및 속성 용어 이름을 원본과 동일한 순서로 작성하세요. 관련 상품 및 상위 항목은 SKU로 지정하세요.
다른 언어의 재고 또는 가격이 원본보다 뒤처짐
나타나는 현상: 원본에는 새 재고 또는 가격이 표시되지만 번역에는 이전 상태가 표시됩니다.
발생 원인: 변경 사항이 WooCommerce 또는 WPML을 거치지 않았기 때문입니다.
- 커넥터가 데이터베이스에 직접 기록했습니다.
- WPML이 비활성화된 상태에서 가져오기가 실행되었습니다.
확인하는 방법: 상품 에디터에서 원본을 여세요. 설명 에디터 아래에 날짜 및 시간과 함께 “Last edited on”이 표시됩니다. 해당 시간이 상품 데이터 상자의 새 가격이나 재고보다 이전이거나 WPML이 비활성화된 상태에서 변경이 이루어진 경우, 업데이트가 동기화를 거치지 않은 것입니다.
지금 해결하는 방법:
옵션 상품의 경우:
- WPML → 지원 → Fix WCML translations로 이동하세요. Fix WCML translations는 별도의 플러그인인 WPML Troubleshooting의 일부입니다.
- Synchronize product variations를 선택하고 Run the selected tools를 클릭하세요.
그러면 모든 언어에 원본의 변형 가격 및 재고와 상품의 가격 범위가 표시됩니다.
단순 상품의 경우 다음 방법 중 하나를 사용하세요. 각 방법은 원본의 가격과 재고를 모든 언어에 반영합니다.
- 한 번에 하나의 상품 처리: 변경된 각 원본을 열고 업데이트를 클릭하세요.
- 가져오기로 여러 상품 처리: 관리 화면 언어를 기본 언어로 설정한 상태에서 상품 → 가져오기를 통해 Update existing products를 선택하고 상품을 다시 가져오세요. 파일에는 원본에 이미 있는 값이 포함될 수 있습니다. 이 방법은 옵션 상품도 재정렬합니다.
- REST로 여러 상품 처리: 각 상품의 가격과 함께
PUT /wc/v3/products/<id>를 전송하세요(예:{"regular_price": "19.50"}). - 동일한 가격으로 여러 상품 처리: 상품 → 모든 상품에서 상품을 선택하고 일괄 작업 → 일괄 편집을 선택한 다음 적용을 클릭하세요. 가격 아래에서 변경:을 선택하고 가격을 입력한 다음 업데이트를 클릭하세요. 선택한 모든 상품에 해당 가격이 적용됩니다.
원본에 이미 있는 값으로 wp wc product update를 실행하면 번역에 반영되지 않습니다.
방지하는 방법: 커넥터가 WooCommerce(REST API 또는 상품 함수)를 통해 기록하도록 하고, 가져오기 중에는 WPML을 활성 상태로 유지하세요.
REST API를 통해 생성된 상품이 잘못된 언어 또는 그룹에 배치됨
나타나는 현상: 번역이 잘못된 언어로 표시되거나, SKU와 원본에 대한 링크가 없는 별도의 상품으로 표시됩니다.
발생 원인:
- 알 수 없는 언어 코드는 HTTP 422
Invalid language parameter: "ge"오류와 함께 거부되며 아무것도 생성되지 않습니다. "lang": "fr"과 함께 전송된 독일어 텍스트와 같이 유효하지만 잘못된 코드는 해당 언어로 번역을 생성합니다.- 누락된
translation_of은 SKU 및 복사된 가격이나 재고가 없는 자체 그룹에 상품을 생성합니다.
지금 해결하는 방법: 올바른 언어 및 링크와 함께 PUT /wc/v3/products/<id>을 사용하여 상품을 다시 전송하세요.
{
"lang": "de",
"translation_of": 38
}상품이 원본 그룹으로 이동하고 해당 SKU, 가격 및 재고를 가져옵니다. 옵션 상품의 경우 WPML은 링크 없이 생성된 변형을 연결된 새 변형으로 바꿉니다. 새 변형 ID를 다시 읽어오세요.
방지하는 방법: 모든 번역에 lang 및 translation_of을 전송하고, 용어를 먼저 생성한 다음, WPML이 번역의 변형을 생성하도록 하세요.
새로 가져온 상품이 자동으로 번역되지 않음
나타나는 현상: 가져온 상품이 원본 언어로만 유지됩니다.
발생 원인: 가져오기 중에 모든 항목 번역이 꺼져 있었거나, 상품이 비공개(모든 항목 번역에서 절대 번역하지 않음)이거나, 임시글(Translate drafts automatically가 켜져 있고 임시글이 다시 저장될 때만 번역됨)이기 때문입니다.
지금 해결하는 방법:
- 상품 전송: WPML → 번역으로 이동하여 Products 섹션을 열고 상품을 선택한 다음, 각 언어에 대해 자동으로 번역을 선택하고 “WPML이 콘텐츠 자동 번역을 완료하면 어떻게 하시겠습니까?” 아래에서 Publish without review를 선택한 다음 콘텐츠 번역을 클릭하세요. 이 방법은 임시글 및 비공개 상품에도 작동하며, 해당 번역은 원본의 상태를 가져옵니다.
- 또는 모든 항목 번역을 켜세요. 아직 번역되지 않은 발행된 모든 상품을 번역합니다. WPML은 WPML 관리 화면 페이지가 로드되는 동안 해당 상품을 전송합니다.
- WPML → 번역 → 모든 항목 번역 설정 → Continue → Enable Translate Everything Automatically로 이동하세요.
- “Finished translating your content”라고 표시될 때까지 WPML → 번역에 머무르세요.
방지하는 방법: 가져오기 전에 모든 항목 번역을 켜고(프로세스 A), 발행된 상태로 상품을 가져오세요.