워드프레스 사이트에 GeneratePress 테마를 사용하는 경우 위젯 페이지를 방문할 때 "generatepress-content-width" 플러그인이 오류가 발생했으며 실행할 수 없습니다 경고가 표시되는 문제가 발생할 수 있습니다.
이 오류는 GeneratePress 테마를 사용할 때 일부 사이트에서 발생하는 것으로 보입니다. 저는 대부분의 워드프레스 사이트에 GP 테마를 설치하여 사용하고 있는데, 이 블로그에서만 이 오류가 최근 발생하는 것을 발견했습니다.
이 문제가 발생하는 경우 이 글에서 제시하는 코드를 테마 함수 파일에 추가하여 일시적으로 해결할 수 있습니다.
워드프레스 "generatepress-content-width" 플러그인 오류 문제 해결 방법
워드프레스 위젯 섹션을 방문할 때 "generatepress-content-width" 플러그인이 오류가 발생했으며 실행할 수 없습니다(The "generatepress-content-width" plugin has encountered an error and cannot be rendered) 에러 메시지가 표시되는 문제가 GeneratePress 테마를 사용하는 일부 사이트에서 발생하고 있습니다.
GeneratePress 테마를 사용할 때, 블록 에디터에서 위젯 편집 화면에 표시되는 content-width 설정 패널이 불필요하거나 충돌을 일으켜 이 문제가 발생하는 것으로 추정됩니다.
GP 테마 개발자가 문제를 인식했기 때문에 추후 업데이트에서 이 버그가 수정될 것으로 예상됩니다.
위젯 영역에서 임시로 "generatepress-content-width" 기능을 비활성화하는 다음과 같은 코드를 테마의 함수 파일에 추가하여 이 문제를 해결할 수 있습니다. 아래 코드는 GeneratePress 테마 개발자가 제시한 코드입니다.
add_action( 'admin_footer', function() {
$screen = get_current_screen();
if ( 'widgets' === $screen->base ) {
?>
<script>
wp.domReady( function() {
var unregisterPlugin = wp.plugins.unregisterPlugin;
unregisterPlugin( 'generatepress-content-width' );
} );
</script>
<?php
}
} );이 버그가 수정된 업데이트가 나오면 위의 코드는 삭제할 수 있을 것입니다.
상기 코드는 워드프레스 관리자 화면 중 위젯 편집 페이지에서만 실행되며, 특정 블록 에디터 플러그인을 비활성화하는 간단한 스크립트를 삽입할 뿐이기 때문에 사이트 방문자 페이지나 전체 성능에는 영향을 미치지 않으며, 관리자 UI(사용자 인터페이스) 속도에도 거의 무시할 수 있을 정도로 미미한 수준입니다.
상기 코드는 FTP/SFTP에 접속하여 차일드 테마 내의 함수 파일(functions.php)에 추가할 수 있습니다.
보통 함수 파일을 열고 맨 끝에 상기 코드 스니펫을 추가하면 됩니다. 만약 에러가 발생한다면, 맨 끝에 ?> 코드 라인이 있는지 확인하시고, 있다면 ?> 라인 위에 추가하세요.
FTP 접속에 어려움을 겪는 경우 File Manager 플러그인을 사용하여 차일드 테마 폴더에 접근해서 코드를 추가할 수 있지만, 그리 권장하지는 않습니다.
마치며
이상으로 제너레이트프레스 테마가 설치된 워드프레스 사이트에서 "generatepress-content-width" 플러그인 관련 오류가 발생하는 문제를 해결하는 방법에 대하여 살펴보았습니다.
동일한 방식으로 만든 여러 개 사이트에서 특정 사이트에서만 이 문제가 발생할 수 있고, 워드프레스를 새로 설치한 상태에서 이 문제가 발생한다고 하는 분도 계시네요.
이 글에서 다루는 에러가 발생한다면 본문의 코드를 사용하여 임시로 해결할 수 있으며, 추후 GeneratePress 테마 업데이트에서 이 오류가 해결되면 코드를 제거하시기 바랍니다.
댓글 남기기