주 콘텐츠로 건너뛰기
버전: 1.x

플러그인 충돌

플러그인 충돌은 WCPOS 문제의 가장 일반적인 원인 중 하나입니다. 다른 WordPress 플러그인이 WooCommerce나 WCPOS의 기능과 간섭할 경우, 충돌, 성능 문제 또는 예기치 않은 동작이 발생할 수 있습니다.

플러그인 충돌의 징후​

다음과 같은 경험이 있다면 플러그인 충돌이 발생했을 수 있습니다:

  • 치명적인 오류들 - "이 웹사이트에서 심각한 오류가 발생했습니다"
  • 성능 문제 - 느린 로딩, 시간 초과 또는 높은 서버 부하
  • 기능 문제 - 기능이 예상대로 작동하지 않음
  • 데이터 동기화 문제 - 제품, 주문 또는 고객이 제대로 동기화되지 않음
  • 결제 게이트웨이 문제 - 체크아웃 실패 또는 결제 처리 오류

시작하기 전에: 스테이징 사이트 사용​

중요

라이브 사이트에서 플러그인 충돌을 문제 해결하지 마세요. 비즈니스 운영에 지장을 주지 않도록 항상 스테이징 환경을 사용하세요.

스테이징 사이트란 무엇인가요?​

스테이징 사이트는 고객에게 영향을 주지 않고 안전하게 변경 사항을 테스트할 수 있는 라이브 웹사이트의 정확한 복사본입니다. 대부분의 현대 호스팅 제공업체는 스테이징 환경을 표준 기능으로 제공합니다.

호스트에서 스테이징을 제공하지 않는 경우​

호스팅 제공업체에서 스테이징 사이트를 제공하지 않는 경우, 제공하는 호스트로 변경하는 것을 고려하세요. 이는 현재 표준 기능이며 필수적입니다:

  • 안전한 플러그인/테마 테스트
  • WordPress 업데이트
  • 문제 해결
  • 개발 작업

스테이징을 제공하는 추천 호스트:

  • WP Engine
  • SiteGround
  • Kinsta
  • Cloudways
  • 기타 많은 호스트

1단계: 치명적인 오류 확인​

충돌이나 치명적인 오류들이 발생할 경우, 오류 로그를 확인하는 것부터 시작하세요:

  1. WCPOS 로그 확인 - WCPOS에서 로그 화면을 열어 오류 메시지를 확인하세요
  2. 치명적인 오류 로그 확인 - 치명적인 오류 문제 해결 가이드를 따라 자세한 오류 메시지를 찾아보세요
  3. 오류 세부 사항 기록 - 오류에 언급된 플러그인 이름이나 파일 경로를 찾아보세요

특정 플러그인을 언급하는 치명적인 오류를 발견했다면, 그 플러그인이 문제의 원인일 가능성이 높습니다. 해당 플러그인을 비활성화하고 문제가 해결되는지 테스트할 수 있습니다.

2단계: 플러그인 제거 방법​

로그에 치명적인 오류가 없거나 성능 관련 충돌을 확인하고 싶다면 이 시스템적인 접근 방식을 사용하세요:

2.1 기준선 만들기​

  1. 스테이징 사이트에 접속하세요
  2. 문제가 있는 기능 테스트 - 정확히 작동하지 않거나 느린 부분을 기록하세요
  3. 성능 메트릭 기록 - 성능 문제라면 로그에서 실행 시간을 기록하세요

2.2 모든 플러그인 비활성화 (필수 플러그인 제외)​

다음 플러그인은 활성 상태로 유지하세요:

  • WooCommerce
  • WooCommerce POS (WCPOS)
  • WooCommerce POS Pro (있다면)

다른 모든 플러그인은 비활성화하세요:

  1. WP Admin > 플러그인으로 이동
  2. 나머지 모든 플러그인 선택
  3. 대량 작업 드롭다운에서 "비활성화" 선택
  4. "적용" 클릭

2.3 문제 테스트​

  1. 모든 캐시 지우기 - 캐싱 플러그인을 사용하는 경우, 모든 캐시를 지우세요
  2. 문제가 있는 기능 테스트 - 이제 작동하나요?
  3. 성능 확인 - 실행 시간이 개선되었나요?

문제가 해결되면: 플러그인 충돌이 있습니다. 2.4단계로 진행하세요.

문제가 지속되면: 문제는 플러그인 충돌이 아닐 수 있습니다. 고려할 사항:

  • 서버 리소스 문제 (see 서버 성능)
  • 테마 충돌 (3단계 참조)
  • 핵심 WordPress/WooCommerce 문제

2.4 플러그인 하나씩 활성화​

이제 어떤 플러그인이 충돌을 일으키는지 확인해야 합니다:

  1. 하나의 플러그인 활성화 - 가장 필수적인 것부터 시작하세요
  2. 기능 테스트 - 문제가 다시 발생하는지 확인하세요
  3. 문제가 없으면 - 다음 플러그인을 활성화하고 다시 테스트하세요
  4. 문제가 다시 발생하면 - 충돌하는 플러그인을 찾았습니다!

플러그인 우선 순위 순서 (이 순서로 활성화):

  1. 보안 플러그인 - Wordfence, Sucuri 등
  2. SEO 플러그인 - Yoast, RankMath 등
  3. 성능 플러그인 - 캐싱, 최적화
  4. 결제 게이트웨이 - Stripe, PayPal 등
  5. 기타 WooCommerce 확장
  6. 일반 WordPress 플러그인

2.5 발견한 사항 문서화​

충돌하는 플러그인을 식별했을 때:

  1. 플러그인 이름과 버전 기록
  2. 유발하는 특정 문제 문서화
  3. 업데이트된 버전이 있는지 확인
  4. 유사한 기능을 제공하는 대체 플러그인 찾기

3단계: 테마 충돌 확인​

테마가 WCPOS에 영향을 주는 경우는 드물지만, 다음과 같은 문제를 일으킬 수 있습니다:

  • 체크아웃 프로세스 (웹 체크아웃 게이트웨이를 사용할 경우)
  • 관리자 영역 기능
  • API 응답

기본 테마로 테스트​

  1. 스테이징 사이트에서, 기본 WordPress 테마로 전환하세요:
    • Twenty Twenty-Four
    • Twenty Twenty-Three
    • Twenty Twenty-Two
  2. 문제가 있는 기능 테스트
  3. 문제가 해결되면 - 테마에 충돌이 있습니다
테마 영향

테마가 플러그인보다 WCPOS 문제를 일으킬 가능성은 훨씬 낮습니다. POS 인터페이스는 테마와 독립적으로 작동합니다. 그러나 테마는 다음에 영향을 줄 수 있습니다:

  • WooCommerce 체크아웃 페이지
  • WordPress 관리자 기능
  • REST API 응답

4단계: 플러그인 충돌 해결​

충돌하는 플러그인을 확인한 후, 여러 가지 옵션이 있습니다:

옵션 1: 플러그인 업데이트​

  1. 업데이트 확인 - 충돌이 새 버전에서 수정되었을 수 있습니다
  2. 먼저 스테이징 사이트에서 플러그인 업데이트
  3. 라이브 사이트에서 업데이트하기 전에 철저히 테스트

옵션 2: 대체 플러그인 찾기​

  1. 동일한 기능을 제공하는 대체 플러그인 조사
  2. 스테이징 사이트에서 대체 플러그인 테스트
  3. 플러그인 변경 시 설정 마이그레이션

옵션 3: 플러그인 개발자에 문의​

  1. 충돌을 플러그인 개발자에게 보고
  2. 자세한 정보 제공:
    • 관련된 플러그인 버전
    • WordPress 및 WooCommerce 버전
    • 정확한 오류 메시지 또는 동작
    • 문제를 재현하는 방법

옵션 4: 맞춤 솔루션​

교체할 수 없는 필수 플러그인에 대해서는:

  1. WordPress 개발자에게 연락하여 맞춤 수리 요청
  2. 충돌하는 기능 비활성화를 위한 플러그인 전용 후크 고려
  3. POS 관련 페이지에서 플러그인 비활성화용 조건부 논리 사용

일반적인 충돌하는 플러그인 유형​

고위험 플러그인 카테고리​

보안 플러그인:

  • API 요청을 차단할 수 있음
  • 인증에 간섭할 수 있음
  • 종종 공격적인 방화벽 규칙을 가짐

캐싱 플러그인:

  • API 응답을 부적절하게 캐시할 수 있음
  • 실시간 데이터에 간섭할 수 있음
  • 오래된 데이터 문제를 유발할 수 있음

SEO 플러그인:

  • 무거운 플러그인은 관리 영역을 느리게 할 수 있음
  • 불필요한 데이터베이스 쿼리 추가 가능
  • REST API 응답에 간섭할 수 있음

페이지 빌더:

  • 종종 관리자 영역에서 무거운 스크립트를 로드함
  • WooCommerce 관리자 페이지와 충돌할 수 있음
  • 체크아웃 프로세스에 간섭할 수 있음

회원제/제한 플러그인:

  • API 접근을 차단할 수 있음
  • 사용자 인증에 간섭할 수 있음
  • 필요한 리소스에 대한 접근을 제한할 수 있음

저위험 플러그인 카테고리​

연락처 양식: 일반적으로 WCPOS에 간섭하지 않음
소셜 미디어 플러그인: 드물게 충돌을 유발함
분석 플러그인: 일반적으로 안전하나 매우 무거운 경우 제외
기본 콘텐츠 플러그인: 대체로 호환 가능

예방 팁​

정기적인 유지 관리​

  1. 플러그인 업데이트 유지 - 항상 최신 버전 사용
  2. 사용하지 않는 플러그인 제거 - 단순히 비활성화하지 말고 삭제하세요
  3. 라이브 사이트에 적용하기 전에 스테이징에서 업데이트 테스트
  4. 정기적으로 서버 성능 메트릭을 사용하여 성능 모니터링

플러그인 선택 모범 사례​

  1. 신뢰할 수 있는 개발자 선택 - 리뷰 및 업데이트 빈도 확인
  2. 중복 기능 피하기 - 동일한 일을 하는 여러 플러그인 설치하지 말 것
  3. 호환성 정보 확인 - 플러그인이 WooCommerce와 테스트되었는지 확인
  4. 최소한의 플러그인으로 시작 - 필요한 기능을 점진적으로 추가

도움 요청하기​

플러그인 충돌을 해결할 수 없는 경우:

프로 사용자​

프로 지원

프로 사용자는 플러그인 충돌 해결을 위한 우선 지원을 받습니다. 저희 팀이 충돌을 식별하고 해결할 수 있도록 도와드립니다.

커뮤니티 지원​

Discord Communitysupport@wcpos.com

지원에 문의할 때​

다음 정보를 제공하세요:

  1. 버전을 포함한 활성 플러그인 목록
  2. WordPress 및 WooCommerce 버전
  3. 문제에 대한 자세한 설명
  4. 이미 시도한 단계
  5. 로그의 오류 메시지
  6. 관련된 경우 서버 성능 메트릭
치명적인 오류치명적인 오류 로그 찾는 방법
로그WCPOS 로그 및 메트릭 이해하기
서버 성능성능 문제 진단
체크아웃 성능체크아웃 속도 최적화