> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 카트 번역

> Upcart 인터페이스 전반의 개별 텍스트 레이블을 편집하거나 번역하세요.

<div id="overview">
  # **개요**
</div>

Upcart의 Translations 기능을 사용하면 카트 인터페이스 요소의 문구와 언어를 변경할 수 있어요. 기본 문구를 조정하고 싶든 여러 언어로 고객을 응대하고 싶든, 모든 것을 Upcart 안에서 직접 관리할 수 있어요.

여러 언어를 지원해야 한다면 먼저 **Shopify 관리자 언어 설정**에서 언어를 추가해야 해요. 그 이후 모든 번역 편집은 Upcart 안에서 이루어져요.

***

<div id="how-the-customers-language-is-chosen">
  ## 고객의 언어가 선택되는 방식
</div>

Upcart는 현재 세션의 **활성 Shopify 스토어프론트 로케일**을 따라요. 이는 Shopify가 스토어프론트의 나머지 부분을 렌더링할 때 사용하는 것과 동일한 로케일로, Shopify가 쇼핑객에 대해 다음 중 하나로 결정해요:

* 스토어프론트의 언어 전환기에서 선택한 언어 (테마에 추가한 경우).
* 쇼핑객이 있는 로케일 접두사 URL (예: `/fr` 또는 `/de`).
* 쇼핑객의 마켓에 대한 Shopify Markets 언어 및 국가 라우팅 규칙.
* 폴백으로 사용되는 **Settings > Languages**의 스토어 **기본 언어**.

Upcart가 렌더링될 때 해당 언어에 대해 저장한 번역을 조회해 사용해요. 활성 언어에 대한 필드 번역이 없으면 Upcart는 기본 텍스트로 폴백해요.

언어 선택은 Shopify가 주도하기 때문에 Upcart 안에서 재정의할 수 없어요. Shopify 관리자에서 언어를 추가하거나 조정하고, 필요하다면 테마에 언어 전환기를 추가해 쇼핑객이 언어를 변경할 수 있도록 하세요.

***

<div id="step-1-add-languages-in-shopify-admin">
  ## 1단계 - Shopify Admin에서 언어 추가하기
</div>

언어를 Upcart에서 사용하려면 먼저 **Shopify 관리자 설정**에 추가되어 있어야 해요.

1. Shopify에서 **Settings > Languages**로 이동하세요
2. 스토어와 카트에서 지원할 각 언어를 추가하세요

중요:

* 카트를 여러 언어로 표시하려면 모든 언어를 먼저 여기에 추가해야 해요
* 추가되면 Upcart의 언어 드롭다운에 나타나요

참고: 기존 카트 텍스트를 편집하거나 문구만 수정하고 싶다면 이 단계를 건너뛰어도 돼요.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-translations-shopify-languages-settings.gif?s=4d0bfcd3e7c7b8d047372d76f2bdc4c4" alt="영어, 프랑스어, 독일어, 스페인어가 나열되고 Add language 버튼이 있는 Shopify 관리자 Languages 설정" width="1860" height="1080" data-path="images/upcart/cart-translations-shopify-languages-settings.gif" />

<div id="step-2-translate-your-cart-in-upcart">
  ## 2단계 - Upcart에서 카트 번역하기
</div>

1. **Upcart > Manage all carts**로 이동하세요
2. 번역할 카트를 선택하세요
3. **Translate** 버튼을 클릭하세요
4. 드롭다운에서 언어를 선택하세요
5. 번역을 추가하거나 업데이트하세요

완료되면 오른쪽 상단의 **Save**를 클릭하세요.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-translations-language-dropdown.gif?s=6a98ce7e062f2f6c3caeefd6f16801e3" alt="독일어, 스페인어, 프랑스어가 표시된 언어 드롭다운이 열려 있는 Upcart Translations 편집기" width="1860" height="1080" data-path="images/upcart/cart-translations-language-dropdown.gif" />

***

<div id="how-the-translations-editor-works">
  ## Translations 편집기 작동 방식
</div>

편집기에는 두 개의 열이 있어요:

* **Original**\
  현재 카트에서 사용 중인 기본 텍스트
* **Translation**\
  번역되거나 커스터마이징된 텍스트를 입력하는 곳

어떤 필드든 직접 편집할 수 있어요.

* **Save**를 클릭해 변경 사항을 적용하세요
* **× 아이콘**을 클릭하면 필드가 **지워져요**. 원본을 복원하는 것이 아니라 상자를 비우며, 빈 번역은 유효성 검사에 실패해("Translation cannot be empty") Save가 차단돼요 — 저장하기 전에 다시 입력하거나, 변경을 취소하려면 페이지를 새로고침하세요.

***

번역할 수 있는 항목

카트의 모든 고객 대상 텍스트를 커스터마이징할 수 있어요. 다음이 포함돼요:

* 카트 제목 및 헤더 텍스트 \*
* 체크아웃 버튼 및 푸터 레이블 \*
* 빈 카트 메시지
* 카트 아이템 레이블 — 번들 내용 표시/숨기기 링크
* 업셀 콘텐츠 및 버튼
* 업셀 리뷰 수 텍스트 \*
* 단계별 리워드 메시지 \*
* 단계별 리워드 단계 설명 (예: "Free Shipping", "20% Off")
* 상품 추천
* 노트 및 특별 요청 사항
* 할인 코드 필드 — 입력 플레이스홀더와 적용 버튼
* 구독 옵션 \*
* 공지 배너 \*

참고: \*가 붙은 필드는 `{{cart_quantity}}`, `{{total_price}}`, `{{amount}}`, `{{review_count}}` 같은 동적 변수를 지원해요.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-translations-dynamic-variables.gif?s=50e31b99ed62d03fdc378f2bcd85ae23" alt="cart_quantity와 total_price 같은 동적 변수를 보여주는 Upcart Translations 필드" width="2172" height="1080" data-path="images/upcart/cart-translations-dynamic-variables.gif" />

***

<div id="editing-cart-text-for-a-single-language">
  ## 단일 언어의 카트 텍스트 편집하기
</div>

여러 언어를 설정하지 않고 특정 카트 요소의 이름이나 문구만 바꾸고 싶다면 **Edit Copy** 패널을 통해 할 수 있어요.

1. **Manage Carts > Edit**으로 이동하세요
2. **Settings**를 여세요 — 탭들의 행으로 되어 있어요; 다 표시되지 않는 항목은 **More settings** 안에 있어요
3. **Edit copy** 탭을 선택하세요

**Body**

* **Automatic discount savings text** (예: "Save")
* **Empty cart message** (예: "Your cart is empty")
* **Continue shopping button text** (예: "Or continue shopping")

**Footer**

* **Total discount savings text** (예: "Discounts")
* **Subtotal text** (예: "Subtotal")
* **Checkout button text** (예: `Checkout • {{total_price}}`)

**Bundles**

* **Show bundle items text**, 단수 및 복수
* **Hide bundle items text**, 단수 및 복수

**예시:** 체크아웃 버튼 이름을 "Secure Checkout"으로 바꾸려면 **Checkout button text** 필드를 `Secure Checkout • {{total_price}}`로 업데이트하고 **Save**를 클릭하세요.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-translations-edit-copy-panel.gif?s=a00152f1a7aa5d12bac16818cb7eb40a" alt="라이브 카트 미리보기와 함께 본문 및 푸터 텍스트 레이블을 편집하는 Upcart Edit Copy 패널" width="1704" height="1080" data-path="images/upcart/cart-translations-edit-copy-panel.gif" />
