그누보드 g4path 변수 미선언 및 capslock.js 오류 해결 방법

• 목록
• 스크랩

그누보드 g4_path 변수 미선언 및 capslock.js 오류 해결 방법

그누보드 로그인 페이지나 팝업 화면에서 발생하는 'g4_path 변수가 선언되지 않았습니다. js/capslock.js' 경고창의 원인을 파악하고, 그누보드 4와 그누보드 5 환경별 조치 방법을 통해 문제를 해결하는 도움을 얻을 수 있습니다.

그누보드 로그인 폼 페이지에서 g4_path 변수 미선언 및 capslock.js 오류 원인

그누보드4 환경의 로그인 폼 페이지에서 "g4_path 변수가 선언되지 않았습니다. js/capslock.js" 경고창이 발생하는 주된 원인은 로그인 폼이 포함된 페이지에서 head.sub.php 파일을 include하지 않았기 때문입니다.

자바스크립트 변수인 g4_path의 선언은 일반적으로 head.sub.php 파일에서 이루어지는데, 로그인 폼 페이지가 이 파일을 불러오지 않으면 g4_path 전역 변수를 인식하지 못해 js/capslock.js 실행 과정에서 오류가 발생하게 됩니다.

그누보드 로그인 페이지에서 capslock.js g4_path 오류 해결 방법

그누보드4 로그인 폼이 포함된 페이지에서 g4_path 변수가 선언되지 않았습니다. js/capslock.js 경고창이 발생하는 원인은 로그인 폼이 들어가는 페이지에 head.sub.php 파일이 포함(include)되지 않았기 때문입니다.

해결 절차

1. 로그인 폼 페이지 확인 및 수정
   • 로그인 폼이 위치한 페이지 파일에서 상단에 head.sub.php가 포함되어 있는지 확인합니다.
   • 포함되어 있지 않다면 해당 페이지 상단에 아래의 코드를 추가합니다.

   include_once("{$g4['path']}/head.sub.php");

2. 그누보드5 업그레이드 환경에서의 조치
   • 그누보드4를 그누보드5로 업그레이드한 뒤 이와 같은 에러가 발생한다면 다음 두 가지 중 한 가지 방법으로 해결할 수 있습니다.
   • js/capslock.js 내용 업그레이드
   • head.sub.php 파일의 전역변수 선언부에 아래 코드를 추가

   var g4_path = "<?php echo G5_URL;?>";

결과 확인

• 코드를 수정 및 저장한 뒤, 로그인 페이지에 재접속하여 js/capslock.js 관련 자바스크립트 경고창이 사라졌는지 확인합니다.

그누보드5 업그레이드 후 g4_path 및 capslock.js 오류 해결

그누보드4를 그누보드5로 업그레이드한 후 g4_path 변수가 선언되지 않았습니다. js/capslock.js 경고창이 발생하는 원인은 업그레이드 과정에서 g4_path 전역 변수 설정이 누락되었거나 js/capslock.js 내용이 맞지 않기 때문입니다.

해결 방법

1. js/capslock.js 파일의 내용을 그누보드5 환경에 맞게 업그레이드합니다.
2. head.sub.php 파일의 전역변수 선언부에 아래 코드를 추가합니다.

var g4_path = "<?php echo G5_URL;?>";

확인 방법

수정 후 해당 페이지에 재접속하여 js/capslock.js 관련 자바스크립트 경고창이 사라졌는지 확인합니다. (상세 확인 절차는 Q5 참조)

그누보드5 업그레이드 환경의 capslock.js 오류 해결 방법

그누보드4에서 그누보드5로 업그레이드한 후 g4_path 변수가 선언되지 않았습니다. js/capslock.js 경고창이 발생하는 경우, head.sub.php 파일의 전역변수 선언부에 아래의 코드를 추가하여 해결할 수 있습니다.

코드 추가 방법

head.sub.php 파일 내 전역변수 선언 영역에 다음 코드를 추가합니다.

var g4_path = "<?php echo G5_URL;?>";

또한 상황에 따라 js/capslock.js 내용을 업그레이드하는 방법도 함께 적용할 수 있습니다. (상세 해결 절차는 Q3 참조)

상황별 판단 및 대응 가이드

내 상황	우선할 판단	다음 행동
그누보드4 로그인 폼 페이지에서 g4_path 오류 발생	head.sub.php 파일 누락 여부 확인	해당 페이지 상단에 include_once("{$g4['path']}/head.sub.php"); 코드 추가
그누보드5로 업그레이드 후 g4_path 및 capslock.js 에러 발생	전역 변수 설정 누락 또는 자바스크립트 버전 불일치 확인	js/capslock.js 내용을 업그레이드하거나 head.sub.php 전역변수 선언부에 var g4_path = "<?php echo G5_URL;?>"; 추가

실전 FAQ

Q. 로그인 페이지에 head.sub.php를 추가했는데도 g4_path 에러가 계속 발생합니다.

• 예외 및 대안: head.sub.php 경로가 잘못 지정되었거나, 파일 내부에서 $g4['path'] 변수가 정의되기 전에 호출되었을 수 있습니다. 포함하려는 파일의 상대 경로가 올바른지 다시 확인하고, _common.php 등의 초기화 파일이 먼저 로드되었는지 점검하세요.

Q. 그누보드5 업그레이드 후 스크립트 파일을 어디서 수정해야 하나요?

• 실행 지점: js/capslock.js 파일 자체의 코드를 그누보드5 호환 버전으로 교체하거나, 공통 상단 파일인 head.sub.php의 전역 변수 선언 영역에 var g4_path = "<?php echo G5_URL;?>";를 직접 명시하여 전역 변수 누락 문제를 해결할 수 있습니다.

참고자료

기타 참고자료

• happyjung.com — G4/G5 g4_path 변수가 선언되지 않았습니다. js/capslock.js > 기술자료 | 해피정닷컴