주 콘텐츠로 건너뛰기
버전: 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
  • WCPOS
  • WCPOS Pro (소지한 경우)

나머지는 비활성화합니다:

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

2.3 문제 테스트​

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

문제가 해결된 경우: 플러그인 충돌이 있습니다. 2.4 단계로 진행하십시오.

문제가 지속되는 경우: 문제가 플러그인 충돌이 아닐 가능성이 높습니다. 고려사항:

  • 서버 자원 문제 (참조: 서버 성능)
  • 테마 충돌 (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 로그 및 메트릭 이해하기
서버 성능성능 문제 진단하기
결제 성능결제 속도 최적화하기