문제 해결

결론

ZenBlocks 관련 문제의 대부분은 Clear CSS Cache, 플러그인 재활성화, 브라우저 캐시 삭제로 해결됩니다. 아래에서 문제별 확인 절차를 안내합니다.

블록이 삽입 패널에 표시되지 않음

확인 절차

  1. 플러그인이 활성화되어 있는지 확인
  • WordPress 관리자 화면에서 플러그인을 엽니다
  • ZenBlocks가 목록에 있고 활성 상태인지 확인합니다
  • 비활성 상태라면 활성화를 클릭합니다
  1. WordPress 버전 확인
  • 대시보드 > 업데이트에서 버전을 확인합니다
  • ZenBlocks는 WordPress 6.0 이상이 필요합니다
  1. Classic Editor가 활성화되어 있는지 확인
  • Classic Editor 플러그인이 활성화되어 있으면 블록 에디터가 비활성화될 수 있습니다
  • 설정 > 쓰기에서 기본 편집기가 블록 에디터인지 확인합니다
  1. 다른 플러그인과의 충돌 확인
  • 다른 플러그인을 모두 일시적으로 비활성화하고 ZenBlocks만 활성화한 상태로 확인합니다
  • 블록이 표시되면 다른 플러그인을 하나씩 다시 활성화하여 충돌 원인을 찾습니다

설정 패널이 열리지 않거나 표시되지 않음

확인 절차

  1. 블록이 선택되어 있는지 확인
  • 블록을 클릭하여 선택합니다
  • 블록 주위에 파란 테두리가 표시되는지 확인합니다
  1. 사이드바가 보이는지 확인
  • 편집기 오른쪽 상단의 Settings 아이콘(톱니바퀴)을 클릭합니다
  • 사이드바 상단의 Block 탭이 선택되어 있는지 확인합니다
  1. 브라우저 개발자 도구에서 오류 확인
  • 브라우저 개발자 도구(F12)를 엽니다
  • Console 탭에 JavaScript 오류가 있는지 확인합니다
  • 오류가 있다면 스크린샷과 함께 지원 포럼에 제보합니다

프런트엔드에 스타일이 적용되지 않음

확인 절차

  1. CSS 캐시 삭제
  • WordPress 관리자 화면에서 Settings > ZenBlocks를 엽니다
  • Clear CSS Cache를 클릭합니다
  • 문제가 있는 페이지를 다시 저장합니다
  1. 브라우저 캐시 삭제
  • 브라우저 캐시를 삭제합니다
  • 또는 Ctrl+Shift+R / Cmd+Shift+R로 강제 새로고침합니다
  1. 페이지 다시 저장
  • 편집기에서 대상 페이지를 엽니다
  • 업데이트를 클릭합니다
  • CSS 파일이 다시 생성됩니다
  1. 서버 측 캐시 확인
  • WP Super Cache, W3 Total Cache, LiteSpeed Cache 같은 캐시 플러그인을 사용 중이라면 그 캐시도 비웁니다
  • Cloudflare 같은 CDN을 사용 중이라면 CDN 캐시도 함께 비웁니다

참고: ZenBlocks의 CSS 캐시는 /wp-content/uploads/zenblocks/에 저장됩니다. 이 디렉터리에 쓰기 권한이 있는지 확인하세요.

반응형 설정이 반영되지 않음

확인 절차

  1. 디바이스별 값이 설정되어 있는지 확인
  • 사이드바 각 설정 패널에서 디바이스 아이콘(PC / MD / TB / SP)을 클릭하여 확인합니다
  • 특정 디바이스 값이 비어 있으면 PC 값이 fallback으로 사용됩니다
  1. 브레이크포인트 확인
  • Settings > ZenBlocks에서 브레이크포인트 값을 확인합니다
  • 커스텀한 값이 의도한 값과 일치하는지 확인합니다
  1. CSS 캐시 삭제
  • 반응형 CSS는 캐시되므로 설정을 바꾼 뒤에는 캐시 삭제가 필요합니다
  • Settings > ZenBlocks > Clear CSS Cache를 클릭합니다
  1. 브라우저 반응형 모드에서 확인
  • 브라우저 개발자 도구(F12)를 엽니다
  • 디바이스 툴바에서 폭을 브레이크포인트에 맞게 변경합니다
  • 각 브레이크포인트에서 표시를 확인합니다

애니메이션이 동작하지 않음

확인 절차

  1. Pro 기능이 활성화되어 있는지 확인 (애니메이션은 Pro 기능입니다)
  • Settings > ZenBlocks에서 라이선스 상태가 Active인지 확인합니다
  • ZenBlocks Pro 플러그인이 활성화되어 있는지 확인합니다
  1. 애니메이션 설정 확인
  • 사이드바의 Animation Settings 패널을 엽니다
  • 애니메이션 타입이 None이 아닌지 확인합니다
  • Duration이 0이 아닌지 확인합니다
  1. 프런트엔드에서 확인
  • 에디터에서도 미리보기는 가능하지만 최종 확인은 프런트엔드에서 해야 합니다
  • 페이지를 새로고침해 애니메이션이 재생되는지 확인합니다
  1. 트랜지션과 충돌하는지 확인
  • 애니메이션과 트랜지션이 동시에 활성화되면 의도치 않은 동작이 발생할 수 있습니다
  • transition 패널에 경고가 표시되는지 확인합니다

Hover 효과가 동작하지 않음

확인 절차

  1. Hover 탭에 값이 있는지 확인
  • 사이드바 설정 패널에서 Hover 탭을 선택합니다
  • 변경하려는 속성에 값이 들어 있는지 확인합니다
  1. 트랜지션 설정 확인
  • transition 패널의 Duration이 0ms가 아닌지 확인합니다
  • 권장 값: 200ms ~ 400ms
  1. CSS 캐시를 삭제하고 다시 확인

자세한 내용은 buttonBasic FAQ: hover 스타일이 반영되지 않음을 참고하세요.

블록 유효성 검사 오류가 표시됨

확인 절차

  1. 플러그인을 최신 버전으로 업데이트
  • WordPress 관리자 화면의 플러그인 > 업데이트에서 ZenBlocks를 최신 버전으로 업데이트합니다
  1. 블록 복구
  • 오류 메시지에서 Attempt to recover block을 클릭합니다
  • 복구 후 설정이 의도대로인지 확인하고 페이지를 다시 저장합니다
  1. 그래도 해결되지 않으면
  • 블록을 삭제하고 새로 만듭니다
  • 커스텀 디자인으로 저장해 두었다면 새 블록에 preset을 적용해 복원합니다

참고: 플러그인 업데이트로 HTML 출력 형식이 바뀌면 유효성 검사 오류가 발생할 수 있습니다. 블록 복구 기능으로 새 형식에 맞게 자동 갱신됩니다.

문제가 계속되는 경우

위 단계를 따라도 해결되지 않으면 WordPress.org 지원 포럼에 글을 남겨 주세요.

다음 정보를 함께 적어 주세요.

  • WordPress 버전
  • PHP 버전
  • 사용 중인 테마 이름
  • ZenBlocks / ZenBlocks Pro 버전
  • 문제 재현 단계
  • 스크린샷 또는 화면 녹화
  • 브라우저 개발자 도구 Console에 표시되는 오류 메시지