# 테마 연동

테마 연동은 Tipo Appointment Booking 앱을 Shopify 테마에 연결하여 고객이 스토어에서 서비스를 확인하고 예약할 수 있도록 합니다.

이 단계를 완료하지 않으면 서비스와 이용 가능 시간을 올바르게 설정했더라도 예약 위젯이 표시되지 않습니다.

앱 임베드에 대해 자세히 알아보려면 [여기](https://help.shopify.com/en/manual/online-store/themes/theme-structure/extend/apps)를 참고하세요.&#x20;

참고: 앱을 **게시되지 않은(unpublished)** 테마에 적용하면 라이브 사이트에 영향을 주지 않고 앱을 테스트할 수 있습니다.

### 🧩 테마 연동의 기능

활성화하면 Tipo Appointment Booking은 다음과 같이 작동합니다.

* 테마에 예약 기능을 삽입합니다.
* 위젯, 팝업, 앱 블록이 작동하도록 합니다.
* 스토어 예약과 관리자 캘린더를 동기화합니다.

### 🛠️ 단계별 안내: 테마 연동 활성화

&#x20;1\. 앱 **Dashboard** > **App status** 섹션을 열고 **Turn** **on** 버튼을 클릭합니다.&#x20;

테마 편집기로 이동합니다.

<figure><img src="/media/b1bb6904128e8fb65f94.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

2. 테마 편집기에서 **Tipo Appointment Booking** 앱의 **app block**을 찾아 켭니다.

<figure><img src="/media/ad0cfc9fd37d238e2584.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

3. **Save**를 클릭하여 테마 편집기의 변경 사항을 저장합니다.&#x20;

***

### ✅ 정상 작동 여부 확인 방법

다음과 같은 경우 테마 연동이 성공한 것입니다.

* Tipo 대시보드의 **App status**가 **ON**으로 표시됩니다.
* 예약 위젯 또는 버튼이 스토어에 표시됩니다.
* 고객이 예약 양식을 열고 시간대를 선택할 수 있습니다.

<figure><img src="/media/262dd34871de7430391e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**참고:**&#x20;

* 올바른 테마(앱이 연동된 테마)를 확인하고 있는지 확인하세요.
* 앱이 게시되지 않은 테마에 연동된 경우 테마를 미리 보기하여 예약 양식을 확인하세요.

***

### 🛠️ 테마에서 앱 제거

1\. 앱 **Dashboard > App satus**를 열고 **Turn off** 버튼을 클릭하면 테마 편집기로 이동합니다.

2\. 테마 편집기에서 **Tipo Booking Booking**의 **app block**을 비활성화합니다.

3\. **Save**를 클릭하여 테마 편집기의 변경 사항을 저장합니다.&#x20;

***

### ❌ 흔한 실수 및 팁

#### &#x20;“예약 위젯이 보이지 않아요”

다음을 확인하세요.

* 테마 연동이 활성화되어 있는지 확인하세요.
* 위젯, 버튼 또는 임베드 단축 코드를 추가했는지 확인하세요.
* 서비스가 Draft가 아닌 **Active** 상태인지 확인하세요.

#### &#x20;“관리자에서는 예약이 되는데 사이트에서는 안 돼요”

이는 보통 다음을 의미합니다.

* 앱 임베드가 OFF 상태입니다.
* 테마 변경 사항이 저장되지 않았습니다.

***

#### 💡  팁

Shopify 테마를 변경하면 새 테마에서 앱 임베드를 다시 활성화해야 합니다.

***

### ▶️ 튜토리얼 동영상

<iframe class="video-embed" src="https://www.youtube-nocookie.com/embed/0an8uUe-JT0" title="Video tutorial: Theme integration" loading="lazy" allowfullscreen></iframe>

***

**🙋 아직 도움이 필요하신가요?**

여전히 도움이 필요하시면 언제든지 <hi@tipo.io>로 문의해 주세요. 기꺼이 도와드리겠습니다.
