주 콘텐츠로 건너뛰기
버전: 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 서버 성능)
  • 테마 충돌 (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. 최소한의 플러그인으로 시작 - 필요한 기능을 단계적으로 추가하세요.

도움 요청하기​

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

프로 사용자​

프로 지원

프로 사용자는 플러그인 충돌 해결을 위한 우선 지원을 받습니다. 우리 팀이 귀하를 위해 충돌을 식별하고 해결하는 데 도움을 드릴 수 있습니다.

커뮤니티 지원​

지원 요청 시​

다음 정보를 제공하십시오:

  1. 활성 플러그인 목록 및 버전
  2. WordPress 및 WooCommerce 버전
  3. 문제에 대한 상세한 설명
  4. 이미 시도한 단계
  5. 로그의 오류 메시지
  6. 관련 시점의 서버 성능 메트릭

관련 문서​