워드프레스 사이트에 GeneratePress 테마를 사용하는 경우 위젯 페이지를 방문할 때 "generatepress-content-width" 플러그인이 오류가 발생했으며 실행할 수 없습니다 경고가 표시되는 문제가 발생할 수 있습니다.
이 오류는 GeneratePress 테마를 사용할 때 일부 사이트에서 발생하는 것으로 보입니다. 저는 대부분의 워드프레스 사이트에 GP 테마를 설치하여 사용하고 있는데, 이 블로그에서만 이 오류가 최근 발생하는 것을 발견했습니다.
이 문제가 발생하는 경우 이 글에서 제시하는 코드를 테마 함수 파일에 추가하여 일시적으로 해결할 수 있습니다.
👉 2026년 1월 추가: 아직도 이 문제가 발생한다고 하는 사용자들이 계시네요. 이 글에서 소개하는 코드를 차일드 테마의 함수 파일에 추가하면 문제가 해결됩니다만, FTP에 접속하는 것에 어려움을 겪는 경우 다음 네이버 카페 게시글에서 심플한 플러그인을 다운로드하여 설치하는 것도 가능합니다. 가능하면 이 글의 본문의 내용을 참고하여 심플한 코드를 차일드 테마의 함수 파일에 추가하는 방법을 이용하시기 바랍니다.
워드프레스 "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 테마 업데이트에서 이 오류가 해결되면 코드를 제거하시기 바랍니다.
추후 업데이트될 때까지 꼭 코드를 추가해서 기능을 비활성화해 둬야 하나요?
모양 » 위젯에서 이 오류가 현재 발생하고 있네요. 코드를 넣지 않고 오류가 나더라도 무시하셔도 될 것입니다. 저는 이 코드를 추가한 상태입니다. (아직 이 버그가 해결이 안 된 것 같습니다.)