플러그인 충돌
플러그인 충돌은 WCPOS 문제의 가장 흔한 원인 중 하나입니다. 다른 WordPress 플러그인이 WooCommerce 또는 WCPOS 기능과 충돌할 경우, 충돌, 성능 문제 또는 예기치 않은 동작을 경험할 수 있습니다.
플러그인 충돌의 징후
다음과 같은 상황이 발생하면 플러그인 충돌이 있을 수 있습니다:
- 치명적인 오류 - "이 웹사이트에서 치명적인 오류가 발생했습니다."
- 성능 문제 - 느린 로딩, 시간 초과 또는 높은 서버 부하
- 기능 문제 - 기능이 예상대로 작동하지 않음
- 데이터 동기화 문제 - 제품, 주문 또는 고객이 제대로 동기화되지 않음
- 결제 게이트웨이 문제 - 결제 실패 또는 결제 처리 오류
시작하기 전: 스테이징 사이트 사용
실제 사이트에서 플러그인 충돌 문제를 해결하지 마십시오. 항상 스테이징 환경을 사용하여 비즈니스 운영을 방해하지 않도록 하십시오.
스테이징 사이트란 무엇인가요?
스테이징 사이트는 고객에게 영향을 주지 않고 안전하게 변경 사항을 테스트할 수 있는 실제 웹사이트의 정확한 복사본입니다. 대부분의 현대 호스팅 제공업체는 기본 기능으로 스테이징 환경을 제공합니다.
호스트가 스테이징을 제공하지 않는 경우
호스팅 제공업체가 스테이징 사이트를 제공하지 않는 경우, 제공하는 호스트로 전환하는 것을 고려하십시오. 이는 현재 표준 기능이며 다음과 같은 상황에 필수적입니다:
- 안전한 플러그인/테마 테스트
- WordPress 업데이트
- 문제 해결
- 개발 작업
스테이징을 제공하는 권장 호스트:
- WP Engine
- SiteGround
- Kinsta
- Cloudways
- 기타 여러 호스트
1단계: 치명적인 오류 확인
충돌이나 치명적인 오류가 발생하는 경우, 오류 로그를 확인하여 시작하십시오:
- WCPOS 로그 확인 - WCPOS의 로그 화면에서 오류 메시지를 확인합니다.
- 치명적인 오류 로그 확인 - 치명적인 오류 문제 해결 가이드를 따라 상세 오류 메시지를 찾습니다.
- 오류 세부정보 기록 - 오류에 언급된 플러그인 이름이나 파일 경로를 확인합니다.
특정 플러그인을 언급하는 치명적인 오류를 발견하면, 그 플러그인이 문제의 원인일 가능성이 높습니다. 해당 플러그인을 비활성화하고 문제가 해결되었는지 테스트할 수 있습니다.
2단계: 플러그인 제거 방법
로그에 치명적인 오류가 없거나 성능 관련 충돌을 식별하고 싶다면, 다음의 체계적인 접근 방식을 사용하십시오:
2.1 기준선 만들기
- 스테이징 사이트에 접속합니다.
- 문제가 있는 기능 테스트 - 정확히 무엇이 작동하지 않거나 느린지 기록합니다.
- 성능 지표 기록 - 성능 문제인 경우, 로그에서 실행 시간을 기록합니다.
2.2 모든 플러그인 비활성화 (필수 플러그인 제외)
다음 플러그인은 활성 상태로 유지하십시오:
- WooCommerce
- WCPOS
- WCPOS Pro (소지한 경우)
나머지는 비활성화합니다:
WP Admin > 플러그인으로 이동합니다.- 다른 모든 플러그인을 선택합니다.
- 대량 작업 드롭다운에서 "비활성화"를 선택합니다.
- "적용"을 클릭합니다.
2.3 문제 테스트
- 모든 캐시 지우기 - 캐싱 플러그인을 사용하는 경우 모든 캐시를 지웁니다.
- 문제가 있는 기능 테스트 - 이제 작동하나요?
- 성능 확인 - 실행 시간이 향상되었나요?
문제가 해결된 경우: 플러그인 충돌이 있습니다. 2.4 단계로 진행하십시오.
문제가 지속되는 경우: 문제가 플러그인 충돌이 아닐 가능성이 높습니다. 고려사항:
- 서버 자원 문제 (참조: 서버 성능)
- 테마 충돌 (3단계 참조)
- WordPress/WooCommerce 핵심 문제
2.4 플러그인을 하나씩 활성화
이제 충돌을 일으키는 플러그인이 무엇인지 파악해야 합니다:
- 하나의 플러그인 활성화 - 가장 필수적인 것부터 시작하십시오.
- 기능 테스트 - 문제가 다시 발생하는지 확인합니다.
- 문제가 없으면 - 다음 플러그인을 활성화하고 다시 테스트합니다.
- 문제가 다시 발생하면 - 충돌하는 플러그인을 찾았습니다!
플러그인 우선 순위 (이 순서로 활성화):
- 보안 플러그인 - Wordfence, Sucuri 등
- SEO 플러그인 - Yoast, RankMath 등
- 성능 플러그인 - 캐싱, 최적화
- 결제 게이트웨이 - Stripe, PayPal 등
- 기타 WooCommerce 확장
- 일반 WordPress 플러그인
2.5 발견사항 문서화
충돌하는 플러그인을 식별하면:
- 플러그인 이름과 버전을 기록합니다.
- 초래하는 특정 문제를 문서화합니다.
- 업데이트 버전이 있는지 확인합니다.
- 유사한 기능을 제공하는 대체 플러그인을 찾아봅니다.
3단계: 테마 충돌 확인
테마는 WCPOS에 거의 영향을 미치지 않지만(자체 인터페이스를 사용), 다음과 같은 경우에 문제를 일으킬 수 있습니다:
- 결제 프로세스 (웹 결제 게이트웨이를 사용하는 경우)
- 관리 영역 기능
- API 응답
기본 테마로 테스트
- 스테이징 사이트에서, 기본 WordPress 테마로 전환합니다:
- Twenty Twenty-Four
- Twenty Twenty-Three
- Twenty Twenty-Two
- 문제가 있는 기능 테스트
- 문제가 해결되면 - 테마에 충돌이 있습니다.
테마는 플러그인에 비해 WCPOS 문제를 일으킬 가능성이 훨씬 적습니다. POS 인터페이스는 테마와 독립적으로 실행됩니다. 그러나 테마는 다음에 영향을 줄 수 있습니다:
- WooCommerce 결제 페이지
- WordPress 관리 기능
- REST API 응답
4단계: 플러그인 충돌 해결
충돌하는 플러그인을 식별한 후 여러 가지 옵션이 있습니다:
옵션 1: 플러그인 업데이트
- 업데이트 확인 - 충돌이 최신 버전에서 수정되었을 수 있습니다.
- 스테이징 사이트에서 플러그인을 업데이트합니다.
- 라이브 사이트에서 업데이트하기 전에 철저히 테스트합니다.
옵션 2: 대체 플러그인 찾기
- 같은 기능을 제공하는 대체 플러그인 조사
- 스테이징 사이트에서 대체 플러그인 테스트
- 플러그인을 전환할 경우 설정을 마이그레이션
옵션 3: 플러그인 개발자에게 연락
- 플러그인 개발자에게 충돌 보고
- 상세 정보를 제공합니다:
- 관련된 플러그인 버전
- WordPress 및 WooCommerce 버전
- 정확한 오류 메시지 또는 동작
- 문제 재현 단계
옵션 4: 맞춤 솔루션
대체할 수 없는 필수 플러그인의 경우:
- WordPress 개발자에게 맞춤 수정 요청
- 충돌하는 기능을 비활성화하기 위해 플러그인 특정 후크 사용
- POS 관련 페이지에서 플러그인을 비활성화하기 위해 조건부 로직 사용
알려진 플러그인 충돌
아래 플러그인은 WCPOS와 충돌하는 것으로 알려져 있습니다. 많은 문제가 최근 WCPOS 버전에서 이미 자동으로 수정되었습니다 — 최신 버전으로 업데이트하면 별도의 구성 없이 이러한 문제가 해결됩니다.
공통점은 다음과 같습니다: WCPOS는 WooCommerce REST API에 의존하며 일부 흐름(로그인, 결제, 영수증)을 iframe으로 렌더링합니다. 일반적인 수정 방법은 다른 플러그인에서 POS 엔드포인트/URL(/wp-json/wcpos/, /wp-json/wc/v3/ 및 /pos/ 경로)을 제외하는 것이며, 플러그인을 완전히 비활성화하는 것이 아닙니다.
보안 및 로그인 플러그인
이들은 특히 데스크톱/모바일 앱 로그인에서 가장 흔한 충돌 원인입니다.
| 플러그인 | 증상 | 해결 방법 |
|---|---|---|
| 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 확장만 비활성화하세요 |
성능, 캐싱 및 최적화 플러그인
| 플러그인 | 증상 | 해결 방법 |
|---|---|---|
| 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"_를 표시함 | 플러그인을 비활성화하세요 |
페이지 빌더 및 프런트엔드 주입기
| 플러그인 | 증상 | 해결 방법 |
|---|---|---|
| Elementor | elementor-frontend.js가 POS iframe 내부의 결제 아코디언을 손상시킴 — 결제 방법이 확장되지 않음 | Elementor 스크립트 로딩에서 POS 페이지를 제외하세요 |
| Omnisend / 마케팅 플러그인 | 결제 iframe에 스크립트를 주입하여 레이아웃과 결제를 손상시킴 | POS Checkout Settings를 사용하여 필수가 아닌 스크립트를 비활성화하세요 |
| MyStickyElements / Complianz | 결제 iframe에 오버레이(고정 버튼, 쿠키 배너)를 주입함 | /pos/ URL을 제외하도록 구성하세요 |
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 게이트웨이는 POS 설정 내에서만 활성화해야 하며, WooCommerce > Settings > Payments에서는 절대 활성화하지 마세요. 전역적으로 활성화하면 공개 스토어 결제에 표시되어 온라인 결제 흐름이 충돌합니다.
서버 수준 충돌
| 원인 | 증상 | 해결 방법 |
|---|---|---|
사용자 정의 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 경로를 허용하세요 — 서버 성능을 참조하세요 |
일반적인 충돌 플러그인 유형
고위험 플러그인 카테고리
보안 플러그인:
- API 요청 차단 가능성
- 인증에 간섭할 수 있음
- 공격적인 방화벽 규칙이 있는 경우 많음
캐싱 플러그인:
- API 응답을 부적절하게 캐시할 수 있음
- 실시간 데이터에 간섭할 수 있음
- 오래된 데이터 문제를 일으킬 수 있음
SEO 플러그인:
- 무거운 플러그인은 관리 영역을 느리게 할 수 있음
- 불필요한 데이터베이스 쿼리를 추가할 수 있음
- REST API 응답에 간섭할 수 있음
페이지 빌더:
- 종종 관리 영역에서 무거운 스크립트 로드
- WooCommerce 관리 페이지와 충돌 가능성
- 결제 프로세스에 간섭할 수 있음
회원/제한 플러그인:
- API 접근을 차단할 수 있음
- 사용자 인증에 간섭할 수 있음
- 필요한 리소스에 대한 접근을 제한할 수 있음
저위험 플러그인 카테고리
연락처 양식: 일반적으로 WCPOS와 간섭하지 않음 소셜 미디어 플러그인: 드물게 충돌 일으킴 분석 플러그인: 일반적으로 안전하지만 매우 무거운 경우 제외 기본 콘텐츠 플러그인: 일반적으로 호환 가능
예방 팁
정기적인 유지 보수
- 플러그인 업데이트 유지 - 항상 최신 버전 사용
- 사용하지 않는 플러그인 제거 - 단순히 비활성화하지 말고 삭제
- 라이브 사이트에 적용하기 전에 스테이징에서 업데이트 테스트
- 정기적으로 서버 성능 지표를 사용하여 성능 모니터링
플러그인 선택 모범 사례
- 신뢰할 수 있는 개발자 선택 - 리뷰 및 업데이트 빈도 확인
- 중복 기능 피하기 - 같은 일을 하는 여러 플러그인 설치하지 않기
- 호환성 정보 읽기 - WooCommerce와 함께 테스트된 플러그인인지 확인
- 최소한의 플러그인으로 시작 - 필요한 기능을 점차 추가
도움 받기
플러그인 충돌을 해결할 수 없는 경우:
프로 사용자
프로 사용자는 플러그인 충돌 해결을 위한 우선 지원을 받습니다. 우리의 팀이 충돌을 식별하고 해결하는 데 도움을 드릴 수 있습니다.
커뮤니티 지원
지원에 연락할 때
다음 정보를 제공해 주십시오:
- 활성 플러그인 목록 및 버전
- WordPress 및 WooCommerce 버전
- 문제에 대한 상세 설명
- 이미 시도한 단계
- 로그의 오류 메시지
- 관련 시점의 서버 성능 지표