그누보드 테마 폴더에 커스텀 페이지 추가하고 링크 연결하는 방법

• 목록
• 스크랩

그누보드 테마 폴더에 커스텀 페이지 추가하고 링크 연결하는 방법

그누보드 테마 폴더 안에 PC와 모바일용 커스텀 페이지를 직접 생성하고, 아미나 테마 등에서 404 에러 없이 메뉴 링크를 연결하는 방법을 안내합니다.

그누보드 테마 폴더 PC 커스텀 페이지 파일 생성 및 모바일 분기 처리 방법

그누보드 루트 경로에 별도의 파일을 두지 않고 테마 폴더 내부에서 직접 일반 페이지를 생성하여 사용할 수 있습니다. PC 페이지와 모바일 페이지를 각각 구성하여 레이아웃을 유지하는 방식이며, 파일을 생성하기 전에 기존 파일 백업을 권장합니다.

PC 페이지 파일 구성 예시

테마 폴더 내에 page1.php 파일을 생성하고 상단에 _common.php와 헤더 파일을 포함합니다. 모바일 기기 접속 시 모바일 경로로 분기 처리하는 코드를 넣습니다.

<?php
include_once('./_common.php');
if (!defined('_GNUBOARD_')) exit; // 개별 페이지 접근 불가
if (G5_IS_MOBILE) {
    include_once(G5_THEME_MOBILE_PATH.'/page1.php');
    return;
}
include_once(G5_THEME_PATH.'/head.php');
?>
<p>테마를 사용할 때 페이지1 내용</p>
<p><a href="<?php echo G5_THEME_URL ?>/page1.php">페이지1링크</a></p>
<?php
include_once(G5_THEME_PATH.'/tail.php');
?>

모바일 전용 커스텀 페이지 작성 방법

그누보드 테마 내 모바일 전용 커스텀 페이지는 모바일 전용 폴더에 page1.php 파일을 생성하여 작성합니다. 파일을 생성하기 전에 기존 파일 백업을 권장합니다.

모바일 페이지 파일 구성 코드 예시

모바일용 헤더와 푸터를 포함하기 위해 다음과 같이 코드를 구성합니다.

<?php
if (!defined('_GNUBOARD_')) exit; // 개별 페이지 접근 불가
include_once(G5_THEME_MOBILE_PATH.'/head.php');
?>
<p>테마를 사용할 때 모바일 페이지1 내용</p>
<?php
include_once(G5_THEME_MOBILE_PATH.'/tail.php');
?>

아미나 테마 404 에러 해결 방법

아미나 테마 등 일부 테마 환경에서 페이지 템플릿 구조를 사용할 때, 단순 파일 경로를 직접 입력하면 경로 충돌로 인해 404 에러가 발생할 수 있습니다. 이 경우 그누보드 관리자 페이지의 일반 문서 페이지 기능을 활용하여 해결할 수 있습니다.

해결 절차

1. 관리자 페이지의 테마관리 및 일반 문서 페이지 메뉴에서 문서를 생성합니다.
2. 생성된 문서의 HTML ID 값을 확인합니다.
3. 메뉴 설정 페이지에서 링크 주소를 일반 파일 경로가 아니라 /bbs/page.php?hid=아이디 형식으로 입력합니다.

적용 결과 확인

메뉴 설정 및 페이지 생성이 완료된 후 웹사이트 메인 메뉴에서 해당 페이지 링크를 클릭하여 404 에러 없이 정상적으로 내용과 레이아웃이 출력되는지 확인합니다.

커스텀 페이지 및 메뉴 링크 설정 결과 확인 방법

메뉴 설정 및 페이지 생성이 완료된 후에는 웹사이트 메인 메뉴에서 해당 페이지 링크를 클릭하여 404 에러 없이 내용과 레이아웃이 정상적으로 출력되는지 확인할 수 있습니다.

상황별 판단 가이드

내 상황	선택 기준	다음 행동
테마 내에 독립적인 PC/모바일 커스텀 PHP 파일을 직접 생성하려는 경우	테마 폴더 내 파일 생성 및 모바일 분기 처리 필요	기존 파일 백업 후 page1.php 작성 및 G5_IS_MOBILE 분기 코드 적용
아미나 테마 등에서 메뉴 링크 연결 시 404 에러 발생	단순 파일 경로 직접 입력 불가	관리자 페이지에서 일반 문서 생성 후 /bbs/page.php?hid=아이디 형식으로 링크 수정

실전 FAQ

Q. 메뉴에 일반 파일 경로를 넣었을 때 404 에러가 발생하는 이유는 무엇인가요?

• 예외: 아미나 테마 등 일부 테마 환경에서는 파일 경로를 직접 입력하면 페이지 템플릿 구조와 충돌하여 404 에러가 발생할 수 있습니다.
• 대안: 관리자 페이지의 일반 문서 페이지 기능을 통해 문서를 먼저 생성하고, 해당 문서의 HTML ID를 확인하여 /bbs/page.php?hid=아이디 형식의 주소를 메뉴 링크에 입력하십시오.

참고자료

기타 참고자료

• mercury-seed.com — 그누보드 테마 폴더에 커스텀 페이지 추가하고 링크 연결하는 방법