그누보드 테마 미사용 시 페이지 헤더와 푸터가 출력되지 않는 문제 해결

• 목록
• 스크랩

그누보드 테마 미사용 시 페이지 헤더와 푸터가 출력되지 않는 문제 해결

그누보드에서 테마를 사용하지 않고 독립적인 PHP 파일을 루트에 생성했을 때 헤더와 푸터가 누락되는 원인을 파악하고, G5_PATH 상수를 활용해 정상적으로 출력되도록 수정하는 방법을 알아봅니다.

테마 미사용 시 헤더와 푸터 출력 오류 원인

그누보드5 환경에서 테마를 사용하지 않고 루트 디렉토리에 별도의 PHP 파일(예: pointrank.php)을 생성하여 페이지를 출력할 때 상단 헤더(head.php)와 하단 푸터(tail.php)가 나타나지 않는 근본적인 원인은 해당 페이지 파일 내에서 헤더와 푸터를 불러올 때 G5_THEME_PATH 상수를 사용하고 있기 때문입니다.

테마를 사용하지 않는 환경에서는 이 경로에 파일이 존재하지 않거나 올바르게 참조되지 않아 인클루드(include)에 실패하게 됩니다.

그누보드 커스텀 PHP 파일 헤더·푸터 경로 수정 방법

그누보드5 환경에서 테마를 사용하지 않고 루트 디렉토리에 별도의 PHP 파일(예: pointrank.php)을 생성했을 때 헤더와 푸터가 출력되지 않는다면, 호출 경로를 G5_THEME_PATH에서 그누보드 루트 경로인 G5_PATH로 변경해야 합니다.

코드 수정 절차

1. 수정 전 반드시 해당 커스텀 PHP 파일을 백업합니다.
2. 문제가 발생하는 PHP 파일을 엽니다.
3. 상단과 하단에 포함된 기존 코드를 찾습니다.

include_once(G5_THEME_PATH.'/head.php');
include_once(G5_THEME_PATH.'/tail.php');

1. 위 코드를 아래와 같이 G5_PATH를 사용하도록 변경합니다.

include_once(G5_PATH.'/head.php');
include_once(G5_PATH.'/tail.php');

1. 수정된 파일을 서버에 업로드한 후, 해당 페이지에 다시 접속하여 상단 헤더와 하단 푸터가 정상적으로 출력되는지 확인합니다.

그누보드 테마 미사용 시 헤더·푸터 출력 오류 복구 방법

그누보드5 환경에서 테마를 사용하지 않고 루트 디렉토리에 별도의 PHP 파일을 생성해 페이지를 출력할 때 코드를 수정한 후 정상적으로 동작하지 않는 상황이 발생할 수 있습니다.

복구 상황 및 조치 방법

• 발생 상황: 코드를 수정한 후 페이지가 정상적으로 동작하지 않을 때 발생합니다.
• 조치 방법: 백업해둔 원본 파일의 G5_THEME_PATH 경로를 다시 적용하여 이전 상태로 되돌립니다.

상황별 판단 및 행동 가이드

내 상황	선택 기준	다음 행동
커스텀 PHP 파일에서 헤더·푸터가 출력되지 않음	파일 내 호출 상수가 G5_THEME_PATH인지 확인	G5_PATH로 수정하여 경로 재지정
수정 후 페이지가 정상적으로 동작하지 않음	수정 전 백업 파일 존재 여부 확인	백업본의 원본 경로 코드로 즉시 복구

실전 FAQ

Q. 경로를 수정했는데도 페이지가 출력되지 않습니다.

• 예외: 파일 경로 수정 외에도 PHP 구문 오류나 파일 인코딩(UTF-8 BOM 등) 문제가 원인일 수 있습니다. 수정 전 백업해둔 파일로 즉시 복구한 뒤, 코드 내 오타나 문법 오류가 없는지 다시 확인하십시오.

참고자료

기타 참고자료

• mercury-seed.com — 그누보드 테마 미사용 시 페이지 헤더와 푸터가 출력되지 않는 문제 해결