# 플러그인 충돌 플러그인 충돌은 WCPOS 문제의 가장 흔한 원인 중 하나입니다. 다른 WordPress 플러그인이 WooCommerce 또는 WCPOS 기능과 충돌할 경우, 충돌, 성능 문제 또는 예기치 않은 동작을 경험할 수 있습니다. ## 플러그인 충돌의 징후[​](#signs-of-plugin-conflicts "플러그인 충돌의 징후으로 직접 링크") 다음과 같은 상황이 발생하면 플러그인 충돌이 있을 수 있습니다: * **치명적인 오류** - "이 웹사이트에서 치명적인 오류가 발생했습니다." * **성능 문제** - 느린 로딩, 시간 초과 또는 높은 서버 부하 * **기능 문제** - 기능이 예상대로 작동하지 않음 * **데이터 동기화 문제** - 제품, 주문 또는 고객이 제대로 동기화되지 않음 * **결제 게이트웨이 문제** - 결제 실패 또는 결제 처리 오류 ## 시작하기 전: 스테이징 사이트 사용[​](#before-you-start-use-a-staging-site "시작하기 전: 스테이징 사이트 사용으로 직접 링크") 중요 **실제 사이트에서 플러그인 충돌 문제를 해결하지 마십시오.** 항상 스테이징 환경을 사용하여 비즈니스 운영을 방해하지 않도록 하십시오. ### 스테이징 사이트란 무엇인가요?[​](#what-is-a-staging-site "스테이징 사이트란 무엇인가요?으로 직접 링크") 스테이징 사이트는 고객에게 영향을 주지 않고 안전하게 변경 사항을 테스트할 수 있는 실제 웹사이트의 정확한 복사본입니다. 대부분의 현대 호스팅 제공업체는 기본 기능으로 스테이징 환경을 제공합니다. ### 호스트가 스테이징을 제공하지 않는 경우[​](#if-your-host-doesnt-offer-staging "호스트가 스테이징을 제공하지 않는 경우으로 직접 링크") 호스팅 제공업체가 스테이징 사이트를 제공하지 않는 경우, **제공하는 호스트로 전환하는 것을 고려하십시오**. 이는 현재 표준 기능이며 다음과 같은 상황에 필수적입니다: * 안전한 플러그인/테마 테스트 * WordPress 업데이트 * 문제 해결 * 개발 작업 **스테이징을 제공하는 권장 호스트:** * WP Engine * SiteGround * Kinsta * Cloudways * 기타 여러 호스트 ## 1단계: 치명적인 오류 확인[​](#step-1-check-for-fatal-errors "1단계: 치명적인 오류 확인으로 직접 링크") 충돌이나 치명적인 오류가 발생하는 경우, 오류 로그를 확인하여 시작하십시오: 1. **WCPOS 로그 확인** - WCPOS의 [로그](/ko/support/logs.md) 화면에서 오류 메시지를 확인합니다. 2. **치명적인 오류 로그 확인** - [치명적인 오류 문제 해결 가이드](/ko/support/troubleshooting/critical-error.md)를 따라 상세 오류 메시지를 찾습니다. 3. **오류 세부정보 기록** - 오류에 언급된 플러그인 이름이나 파일 경로를 확인합니다. 특정 플러그인을 언급하는 치명적인 오류를 발견하면, 그 플러그인이 문제의 원인일 가능성이 높습니다. 해당 플러그인을 비활성화하고 문제가 해결되었는지 테스트할 수 있습니다. ## 2단계: 플러그인 제거 방법[​](#step-2-the-plugin-elimination-method "2단계: 플러그인 제거 방법으로 직접 링크") 로그에 치명적인 오류가 없거나 성능 관련 충돌을 식별하고 싶다면, 다음의 체계적인 접근 방식을 사용하십시오: ### 2.1 기준선 만들기[​](#21-create-a-baseline "2.1 기준선 만들기으로 직접 링크") 1. **스테이징 사이트에 접속합니다.** 2. **문제가 있는 기능 테스트** - 정확히 무엇이 작동하지 않거나 느린지 기록합니다. 3. **성능 지표 기록** - 성능 문제인 경우, [로그](/ko/support/logs.md)에서 실행 시간을 기록합니다. ### 2.2 모든 플러그인 비활성화 (필수 플러그인 제외)[​](#22-disable-all-plugins-except-essential-ones "2.2 모든 플러그인 비활성화 (필수 플러그인 제외)으로 직접 링크") **다음 플러그인은 활성 상태로 유지하십시오:** * WooCommerce * WCPOS * WCPOS Pro (소지한 경우) **나머지는 비활성화합니다:** 1. `WP Admin > 플러그인`으로 이동합니다. 2. 다른 모든 플러그인을 선택합니다. 3. 대량 작업 드롭다운에서 "비활성화"를 선택합니다. 4. "적용"을 클릭합니다. ### 2.3 문제 테스트[​](#23-test-the-issue "2.3 문제 테스트으로 직접 링크") 1. **모든 캐시 지우기** - 캐싱 플러그인을 사용하는 경우 모든 캐시를 지웁니다. 2. **문제가 있는 기능 테스트** - 이제 작동하나요? 3. **성능 확인** - 실행 시간이 향상되었나요? **문제가 해결된 경우:** 플러그인 충돌이 있습니다. 2.4 단계로 진행하십시오. **문제가 지속되는 경우:** 문제가 플러그인 충돌이 아닐 가능성이 높습니다. 고려사항: * 서버 자원 문제 (참조: [서버 성능](/ko/support/performance/server.md)) * 테마 충돌 (3단계 참조) * WordPress/WooCommerce 핵심 문제 ### 2.4 플러그인을 하나씩 활성화[​](#24-enable-plugins-one-by-one "2.4 플러그인을 하나씩 활성화으로 직접 링크") 이제 충돌을 일으키는 플러그인이 무엇인지 파악해야 합니다: 1. **하나의 플러그인 활성화** - 가장 필수적인 것부터 시작하십시오. 2. **기능 테스트** - 문제가 다시 발생하는지 확인합니다. 3. **문제가 없으면** - 다음 플러그인을 활성화하고 다시 테스트합니다. 4. **문제가 다시 발생하면** - 충돌하는 플러그인을 찾았습니다! **플러그인 우선 순위 (이 순서로 활성화):** 1. **보안 플러그인** - Wordfence, Sucuri 등 2. **SEO 플러그인** - Yoast, RankMath 등 3. **성능 플러그인** - 캐싱, 최적화 4. **결제 게이트웨이** - Stripe, PayPal 등 5. **기타 WooCommerce 확장** 6. **일반 WordPress 플러그인** ### 2.5 발견사항 문서화[​](#25-document-your-findings "2.5 발견사항 문서화으로 직접 링크") 충돌하는 플러그인을 식별하면: 1. **플러그인 이름과 버전을 기록합니다.** 2. **초래하는 특정 문제를 문서화합니다.** 3. **업데이트 버전이 있는지 확인합니다.** 4. **유사한 기능을 제공하는 대체 플러그인을 찾아봅니다.** ## 3단계: 테마 충돌 확인[​](#step-3-check-for-theme-conflicts "3단계: 테마 충돌 확인으로 직접 링크") 테마는 WCPOS에 거의 영향을 미치지 않지만(자체 인터페이스를 사용), 다음과 같은 경우에 문제를 일으킬 수 있습니다: * 결제 프로세스 (웹 결제 게이트웨이를 사용하는 경우) * 관리 영역 기능 * API 응답 ### 기본 테마로 테스트[​](#test-with-a-default-theme "기본 테마로 테스트으로 직접 링크") 1. **스테이징 사이트에서**, 기본 WordPress 테마로 전환합니다: * Twenty Twenty-Four * Twenty Twenty-Three * Twenty Twenty-Two 2. **문제가 있는 기능 테스트** 3. **문제가 해결되면** - 테마에 충돌이 있습니다. 테마 영향 테마는 플러그인에 비해 WCPOS 문제를 일으킬 가능성이 훨씬 적습니다. POS 인터페이스는 테마와 독립적으로 실행됩니다. 그러나 테마는 다음에 영향을 줄 수 있습니다: * WooCommerce 결제 페이지 * WordPress 관리 기능 * REST API 응답 ## 4단계: 플러그인 충돌 해결[​](#step-4-resolving-plugin-conflicts "4단계: 플러그인 충돌 해결으로 직접 링크") 충돌하는 플러그인을 식별한 후 여러 가지 옵션이 있습니다: ### 옵션 1: 플러그인 업데이트[​](#option-1-update-the-plugin "옵션 1: 플러그인 업데이트으로 직접 링크") 1. **업데이트 확인** - 충돌이 최신 버전에서 수정되었을 수 있습니다. 2. **스테이징 사이트에서 플러그인을 업데이트합니다.** 3. **라이브 사이트에서 업데이트하기 전에 철저히 테스트합니다.** ### 옵션 2: 대체 플러그인 찾기[​](#option-2-find-an-alternative "옵션 2: 대체 플러그인 찾기으로 직접 링크") 1. **같은 기능을 제공하는 대체 플러그인 조사** 2. **스테이징 사이트에서 대체 플러그인 테스트** 3. **플러그인을 전환할 경우 설정을 마이그레이션** ### 옵션 3: 플러그인 개발자에게 연락[​](#option-3-contact-plugin-developer "옵션 3: 플러그인 개발자에게 연락으로 직접 링크") 1. **플러그인 개발자에게 충돌 보고** 2. **상세 정보를 제공합니다:** * 관련된 플러그인 버전 * WordPress 및 WooCommerce 버전 * 정확한 오류 메시지 또는 동작 * 문제 재현 단계 ### 옵션 4: 맞춤 솔루션[​](#option-4-custom-solution "옵션 4: 맞춤 솔루션으로 직접 링크") 대체할 수 없는 필수 플러그인의 경우: 1. **WordPress 개발자에게 맞춤 수정 요청** 2. **충돌하는 기능을 비활성화하기 위해 플러그인 특정 후크 사용** 3. **POS 관련 페이지에서 플러그인을 비활성화하기 위해 조건부 로직 사용** ## 알려진 플러그인 충돌[​](#known-plugin-conflicts "알려진 플러그인 충돌으로 직접 링크") 아래 플러그인은 WCPOS와 충돌하는 것으로 알려져 있습니다. 많은 문제가 최근 WCPOS 버전에서 이미 자동으로 수정되었습니다 — **최신 버전으로 업데이트**하면 별도의 구성 없이 이러한 문제가 해결됩니다. 대부분의 수정은 "POS를 제외"하는 것 공통점은 다음과 같습니다: WCPOS는 WooCommerce REST API에 의존하며 일부 흐름(로그인, 결제, 영수증)을 iframe으로 렌더링합니다. 일반적인 수정 방법은 다른 플러그인에서 **POS 엔드포인트/URL**(`/wp-json/wcpos/`, `/wp-json/wc/v3/` 및 `/pos/` 경로)을 **제외**하는 것이며, 플러그인을 완전히 비활성화하는 것이 아닙니다. ### 보안 및 로그인 플러그인[​](#security-and-login-plugins "보안 및 로그인 플러그인으로 직접 링크") 이들은 특히 데스크톱/모바일 앱 로그인에서 **가장 흔한** 충돌 원인입니다. | 플러그인 | 증상 | 해결 방법 | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Wordfence** | 방화벽이 REST API를 차단함; 로그인 iframe에서 2FA 코드 필드가 렌더링되지 않음; 제한적인 CSP가 POS 자산을 차단할 수 있음 | 방화벽에서 `/wp-json/wcpos/`와 `/wp-json/wc/v3/`를 허용 목록에 추가하세요. 2FA의 경우: POS 사용자에 대해 일시적으로 비활성화하세요. CSP는 v1.9.0+에서 자동으로 제거됩니다 | | **Really Simple Security** | API 접근 차단 / 강제 리디렉션 | 플러그인의 **Advanced** 설정에서 REST API 제한을 비활성화하세요 | | **WPS Hide Login** | 사용자 정의 로그인 URL이 앱 로그인 iframe을 손상시킴 | POS 접근에는 표준 `/wp-admin/` 로그인 URL을 사용하세요 | | **iThemes / Solid Security** | REST API를 차단하거나 POS 호출로 인해 무차별 대입 잠금이 발생함 | POS 엔드포인트와 서버 자체 IP만 허용 목록에 추가하세요 — 전체 IP 규칙은 피하세요 | | **Sucuri** | WAF가 API 요청을 차단함 | Sucuri 대시보드에서 REST API 엔드포인트를 허용 목록에 추가하세요 | | **Security Optimizer** | 관리자 POS 로그인을 차단함 (*"use customize login URL"*) | 먼저 사용자 정의 URL을 통해 WP Admin에 로그인한 다음 `/pos`로 이동하세요 | | **Force Login** (및 유사한 REST 인증 플러그인) | `/wp-json/`이 401/403을 반환함; 이전 앱은 \_"Site does not seem to be a WordPress site"\_를 보고함 | POS 엔드포인트에 대한 인증되지 않은 접근을 허용하거나 초기 연결 중에 비활성화하세요. v1.x 앱은 이제 실제 오류 메시지를 표시합니다 | | **LoginPress** | 이메일 기반 로그인을 강제함; 다중 사용자 POS 로그인을 손상시킴 | 사용자 이름 로그인을 허용하거나 POS 접근에 대해 비활성화하세요 | | **JWT Authentication 플러그인** | 활성화 후 모든 POS API 요청에서 403 발생 (로그인은 성공할 수 있으나 나머지는 모두 실패) | v1.8.x+에서 자동 수정됨. 이전 버전에서는 JWT 플러그인을 비활성화하거나 POS 엔드포인트를 제외하세요 | | **Captcha / reCAPTCHA** | 데스크톱 앱에서 로그인 루프 발생 (captcha가 iframe에서 렌더링되지 않음) | POS 로그인 URL에 대해 captcha를 비활성화하세요 | | **Defender Pro** | `X-Frame-Options` 헤더가 모든 POS iframe(로그인, 결제, 영수증)을 차단함 | 사이트 전체에서 `X-Frame-Options`를 비활성화하는 대신 `/pos/`에 대한 POS 전용 예외를 추가하세요 | | **Jetpack CRM Client Portal** | POS 로그인을 완전히 손상시킴 | Client Portal 확장만 비활성화하세요 | ### 성능, 캐싱 및 최적화 플러그인[​](#performance-caching-optimisation-plugins "성능, 캐싱 및 최적화 플러그인으로 직접 링크") | 플러그인 | 증상 | 해결 방법 | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | | **WP Rocket, Autoptimize, Hummingbird, Smush** | JS 지연/축소가 결제 및 Stripe Terminal을 손상시킴 | JS 최적화에서 `/pos/` URL을 제외하세요 | | **LiteSpeed Cache** | 데스크톱 앱의 결제에서 지속적인 새로 고침 루프; 제한적인 CSP | WCPOS를 업데이트하고 캐시를 비운 후 POS 페이지를 캐싱에서 제외하세요. CSP는 v1.9.0+에서 자동 제거됩니다 | | **Image Prioritizer** | HTTP `Link` 헤더를 과도하게 채워 REST API 검색을 손상시킴; 데스크톱 앱이 \_"does not appear to be a WordPress site"\_를 표시함 | 플러그인을 비활성화하세요 | ### 페이지 빌더 및 프런트엔드 주입기[​](#page-builders-front-end-injectors "페이지 빌더 및 프런트엔드 주입기으로 직접 링크") | 플러그인 | 증상 | 해결 방법 | | -------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | | **Elementor** | `elementor-frontend.js`가 POS iframe 내부의 결제 아코디언을 손상시킴 — 결제 방법이 확장되지 않음 | Elementor 스크립트 로딩에서 POS 페이지를 제외하세요 | | **Omnisend / 마케팅 플러그인** | 결제 iframe에 스크립트를 주입하여 레이아웃과 결제를 손상시킴 | POS **Checkout Settings**를 사용하여 필수가 아닌 스크립트를 비활성화하세요 | | **MyStickyElements / Complianz** | 결제 iframe에 오버레이(고정 버튼, 쿠키 배너)를 주입함 | `/pos/` URL을 제외하도록 구성하세요 | ### WooCommerce 확장 및 기타 플러그인[​](#woocommerce-extensions-other-plugins "WooCommerce 확장 및 기타 플러그인으로 직접 링크") | 플러그인 | 증상 | 해결 방법 | | ----------------------------------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | **WooCommerce Subscriptions** | v1.7→v1.8 업그레이드 중 마이그레이션 스크립트 충돌 | Subscriptions를 비활성화하고 POS Pro를 활성화한 다음(마이그레이션 실행) 다시 활성화하세요 | | **WP Activity Log** | 모든 POS 작업을 기록 → postmeta 비대화 → *"only 10 products"* | 비활성화하거나 POS 게시물 유형을 로깅에서 제외하세요 | | **Jetpack / Astra / Xero** (`save_post`에 후킹하는 모든 것) | 모든 POS API 호출에서 중복 메타 행 발생 (한 매장은 한 제품에서 36,867행에 도달) | v1.8.12+(무료) / v1.8.14+(Pro)에서 정리 마이그레이션으로 자동 수정됨 — 업데이트만 하면 됩니다 | | **Stripe Tax** | REST API로 생성된 주문(POS가 주문을 생성하는 방식)과 호환되지 않음 | 해결 방법 없음 — 호환되지 않음 | | **Mollie** | POS 결제에서 BACS(은행 송금) 방법을 숨길 수 있음 | Mollie를 최신 버전으로 업데이트하세요 | | **CTX Feed** | POS 설정 페이지에서 간헐적인 403 오류 | 비활성화하여 확인하세요; 알려진 해결 방법 없음 | | **서드파티 바코드 스캐너 플러그인** | 주문 API JSON을 손상시켜 주문 생성/표시를 손상시킴 | 비활성화하세요; POS의 기본 바코드 스캐닝을 사용하세요 | | **MailerLite** (Signup Forms + WooCommerce) | POS 주문 생성 시 500 오류 (메모리 고갈) | 비활성화하여 확인한 다음 MailerLite에 문의하세요 | | **The Courier Guy Shipping** | POS 주문 생성이 서버 오류로 실패함 | 이전 버전으로 롤백하거나 개발자에게 문의하세요 | | **PixelYourSite / PixelMySite** | 치명적 오류: *call to member function `is_type()` on bool* | 일시적으로 비활성화하세요 | | **Google Listings & Ads** | 오토로더 충돌 → *"Class WCPOS\…\Stores not found"* 치명적 오류 | 모든 POS 플러그인을 삭제하고 최신 Pro 독립형만 다시 설치하세요 | Stripe Terminal: 전역적으로 활성화하지 마세요 **Stripe Terminal** 게이트웨이는 POS 설정 내에서**만** 활성화해야 하며, `WooCommerce > Settings > Payments`에서는 절대 활성화하지 마세요. 전역적으로 활성화하면 공개 스토어 결제에 표시되어 온라인 결제 흐름이 충돌합니다. ### 서버 수준 충돌[​](#server-level-conflicts "서버 수준 충돌으로 직접 링크") | 원인 | 증상 | 해결 방법 | | ---------------------------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **사용자 정의 CSP 헤더** (`.htaccess`, Nginx 또는 보안 플러그인) | POS가 로고에서 멈춤; JS/CSS 차단됨 | v1.9.0+에서 POS 페이지에서 자동 제거됨. 서버 수준 CSP의 경우 `script-src`/`style-src`에서 `cdn.jsdelivr.net`을 허용하거나 `/pos/` 예외를 추가하세요 | | **GoDaddy Website Firewall** | `/wp-json/`을 차단함 (*"Received 'undefined'"*) | 방화벽에서 `/wp-json/` URL 경로를 허용하세요 — [서버 성능](/ko/support/performance/server.md#hosting-specific-notes)을 참조하세요 | ## 일반적인 충돌 플러그인 유형[​](#common-conflicting-plugin-types "일반적인 충돌 플러그인 유형으로 직접 링크") ### 고위험 플러그인 카테고리[​](#high-risk-plugin-categories "고위험 플러그인 카테고리으로 직접 링크") **보안 플러그인:** * API 요청 차단 가능성 * 인증에 간섭할 수 있음 * 공격적인 방화벽 규칙이 있는 경우 많음 **캐싱 플러그인:** * API 응답을 부적절하게 캐시할 수 있음 * 실시간 데이터에 간섭할 수 있음 * 오래된 데이터 문제를 일으킬 수 있음 **SEO 플러그인:** * 무거운 플러그인은 관리 영역을 느리게 할 수 있음 * 불필요한 데이터베이스 쿼리를 추가할 수 있음 * REST API 응답에 간섭할 수 있음 **페이지 빌더:** * 종종 관리 영역에서 무거운 스크립트 로드 * WooCommerce 관리 페이지와 충돌 가능성 * 결제 프로세스에 간섭할 수 있음 **회원/제한 플러그인:** * API 접근을 차단할 수 있음 * 사용자 인증에 간섭할 수 있음 * 필요한 리소스에 대한 접근을 제한할 수 있음 ### 저위험 플러그인 카테고리[​](#lower-risk-plugin-categories "저위험 플러그인 카테고리으로 직접 링크") **연락처 양식:** 일반적으로 WCPOS와 간섭하지 않음 **소셜 미디어 플러그인:** 드물게 충돌 일으킴 **분석 플러그인:** 일반적으로 안전하지만 매우 무거운 경우 제외 **기본 콘텐츠 플러그인:** 일반적으로 호환 가능 ## 예방 팁[​](#prevention-tips "예방 팁으로 직접 링크") ### 정기적인 유지 보수[​](#regular-maintenance "정기적인 유지 보수으로 직접 링크") 1. **플러그인 업데이트 유지** - 항상 최신 버전 사용 2. **사용하지 않는 플러그인 제거** - 단순히 비활성화하지 말고 삭제 3. **라이브 사이트에 적용하기 전에 스테이징에서 업데이트 테스트** 4. **정기적으로 [서버 성능](/ko/support/performance/server.md) 지표를 사용하여 성능 모니터링** ### 플러그인 선택 모범 사례[​](#plugin-selection-best-practices "플러그인 선택 모범 사례으로 직접 링크") 1. **신뢰할 수 있는 개발자 선택** - 리뷰 및 업데이트 빈도 확인 2. **중복 기능 피하기** - 같은 일을 하는 여러 플러그인 설치하지 않기 3. **호환성 정보 읽기** - WooCommerce와 함께 테스트된 플러그인인지 확인 4. **최소한의 플러그인으로 시작** - 필요한 기능을 점차 추가 ## 도움 받기[​](#getting-help "도움 받기으로 직접 링크") 플러그인 충돌을 해결할 수 없는 경우: ### 프로 사용자[​](#for-pro-users "프로 사용자으로 직접 링크") 프로 지원 프로 사용자는 플러그인 충돌 해결을 위한 우선 지원을 받습니다. 우리의 팀이 충돌을 식별하고 해결하는 데 도움을 드릴 수 있습니다. ### 커뮤니티 지원[​](#community-support "커뮤니티 지원으로 직접 링크") [Discord Community](https://wcpos.com/discord) ### 지원에 연락할 때[​](#when-contacting-support "지원에 연락할 때으로 직접 링크") 다음 정보를 제공해 주십시오: 1. **활성 플러그인 목록** 및 버전 2. **WordPress 및 WooCommerce 버전** 3. **문제에 대한 상세 설명** 4. **이미 시도한 단계** 5. **로그의 오류 메시지** 6. **관련 시점의 서버 성능 지표** ## 관련 문서[​](#related-documentation "관련 문서으로 직접 링크") [치명적인 오류치명적인 오류 로그를 찾는 방법](/ko/support/troubleshooting/critical-error.md) [로그WCPOS 로그 및 메트릭 이해하기](/ko/support/logs.md) [서버 성능성능 문제 진단하기](/ko/support/performance/server.md) [결제 성능결제 속도 최적화하기](/ko/support/performance/checkout.md)