그누보드4에서 그누보드5로 마이그레이션 시 팝업 함수(winopen) 변경 및 오류 해결 방법

• 목록
• 스크랩

그누보드4에서 그누보드5로 마이그레이션 시 팝업 함수(win_open) 변경 및 오류 해결 방법

그누보드4 소스를 그누보드5로 이전할 때 자바스크립트 공통 함수 변경으로 발생하는 팝업 오류의 원인을 확인하고, 'winopen'을 'popupwindow'로 수정하여 해결하는 방법을 알아봅니다.

그누보드5에서 win_open 함수 오류 발생 원인

그누보드4의 js/common.js 파일에서는 win_open과 popup_windows 함수를 모두 사용할 수 있었습니다. 그러나 그누보드5의 js/common.js 환경에서는 win_open 함수가 제거되었고 새 창을 띄우는 용도로 popup_window 함수만 지원하도록 변경되었습니다.

따라서 그누보드4 기반의 소스나 스킨을 그누보드5로 마이그레이션할 때 기존 코드가 호출하던 win_open 함수를 더 이상 찾을 수 없기 때문에 팝업 관련 자바스크립트 오류가 발생하게 됩니다.

그누보드4에서 그누보드5로 마이그레이션 시 팝업 함수 변경 방법

그누보드4와 그누보드5 환경 사이에서 자바스크립트 공통 파일인 common.js 내 새창 띄우기 관련 함수 명칭과 지원 여부가 변경되었습니다.

1. 버전별 함수 지원 차이

• 그누보드4 (/js/common.js): win_open 함수와 popup_window 함수를 모두 사용할 수 있었습니다.
• 그누보드5 (/js/common.js): win_open 함수가 제거되어 사용이 불가능하며, 오직 popup_window 함수만 지원됩니다.

2. 코드 수정 및 대처 방법

그누보드4 소스나 커스텀 스킨을 그누보드5 환경으로 마이그레이션할 때, 자바스크립트나 템플릿 파일 내에서 호출 중인 win_open 함수를 모두 popup_window로 변경해야 정상적으로 팝업이 동작합니다.

• 수정 전 (그누보드4):win_open(url, name, option);
• 수정 후 (그누보드5):popup_window(url, winname, opt);

그누보드 마이그레이션 시 팝업 함수 변경 가이드

• 내 상황: 그누보드4에서 작성된 소스나 커스텀 스킨을 그누보드5 환경으로 마이그레이션하는 중 팝업 관련 오류가 발생함
• 선택 기준: 그누보드5의 js/common.js에서는 win_open 함수가 제거되었고 새 창을 띄우는 용도로 popup_window 함수만 지원함
• 다음 행동: 소스 코드 내에서 호출 중인 win_open 함수를 모두 찾아 popup_window 함수로 일괄 변경합니다. 수정 시 popup_window(url, winname, opt) 형식으로 호출하십시오.

실전 FAQ

Q. 그누보드5에서 기존 win_open 함수를 그대로 호출하면 어떻게 되나요?

• 답변: 그누보드5의 common.js 파일에는 win_open 정의가 존재하지 않으므로 자바스크립트 오류(함수를 찾을 수 없음)가 발생하며 팝업 창이 정상적으로 열리지 않습니다.

Q. winopen을 popupwindow로 바꿀 때 인자값 순서나 형태도 수정해야 하나요?

• 답변: 두 함수 모두 window.open을 내부적으로 호출하는 구조이므로 전달하는 URL, 창 이름, 옵션 값의 형태를 유지한 채 함수명만 popup_window(url, winname, opt) 형태로 변경하여 적용하면 됩니다.

함께 보면 좋은 글

• 그누보드4에서 그누보드5로 데이터베이스 테이블 접두사 변경 및 마이그레이션
• 그누보드4에서 그누보드5로 이전 시 데이터베이스 설정(dbconfig.php) 가이드
• PHP mysql 함수에서 mysqli로의 마이그레이션 및 CRUD 구현 가이드

참고자료

기타 참고자료

• happyjung.com — G5 winopen 함수가 popupwindow 으로 변경 > 기술자료 | 해피정닷컴