그누보드 환경 설정 여분 필드 사용 방법

• 목록
• 스크랩

그누보드 관리자의 환경 설정에 있는 기본 여분 필드(1~10)를 게시판뿐만 아니라 일반 커스텀 페이지에서도 불러와 활용하는 방법을 안내합니다.

그누보드 환경 설정 여분 필드 사용 방법

그누보드 관리자 페이지의 환경 설정에서 기본 제공하는 10개의 여분 필드(cf_1 ~ cf_10)를 입력하고, PHP 코드를 통해 사이트 전역의 원하는 페이지에서 불러와 사용할 수 있습니다.

1. 관리자 페이지에서 여분 필드 입력하기

• 관리자 페이지에 접속한 뒤 환경 설정 > 기본 환경설정 메뉴로 이동합니다.
• 화면 하단의 여분 필드 영역에서 좌측에는 필드의 용도를 구분하기 위한 제목(예: 회사명)을 입력하고, 우측에는 실제 저장할 값을 입력합니다.
• 입력된 정보는 기본 환경설정 테이블(g5_config)에 저장됩니다.

2. 페이지에서 여분 필드 값 불러오기

• 그누보드 내부 페이지: 추가 설정 없이 단독으로 사용할 수 있습니다.
• 그누보드 루트 외의 독립된 페이지: 그누보드 기능과 연동하려면 해당 페이지 상단에 그누보드 루트 경로에 있는 common.php 파일을 반드시 include 해야 합니다.
• 출력하고자 하는 위치에 아래와 같이 PHP 코드를 삽입하여 값을 출력합니다.

<?php echo $config['cf_1'];?>
<?php echo $config['cf_2'];?>

3. 여분 필드 제목 출력 및 용도 구분

• 관리자가 어떤 용도의 필드인지 쉽게 파악할 수 있도록 입력한 제목 필드도 동일한 방식으로 출력할 수 있습니다.

<?php echo $config['cf_1_subj'];?>
<?php echo $config['cf_2_subj'];?>

• 제목 필드는 주로 관리자 편의를 위한 구분 문구 용도로 쓰이지만, 필드가 부족할 경우 실제 화면 출력용으로 함께 활용해도 무방합니다.

커스텀 페이지에서 그누보드 환경 설정 여분 필드가 출력되지 않을 때 조치 방법

그누보드 루트 폴더 외에 임의로 만든 커스텀 페이지에서 <?php echo $config['cf_1']?>와 같은 코드가 작동하지 않는다면, 그누보드 루트에 있는 common.php 파일이 해당 페이지 상단에 include 되어 있는지 확인해야 합니다.

1. common.php 인클루드 확인

그누보드의 환경 설정 및 데이터베이스 정보를 불러오려면 해당 페이지 최상단에 common.php를 반드시 포함해야 합니다. 페이지 위치에 따라 그누보드 루트 디렉토리까지의 정확한 상대 경로를 지정하십시오.

<?php
include_once('./common.php'); // 페이지 위치에 맞춰 경로 수정
?>

2. 여분 필드 출력 코드 확인

common.php가 정상적으로 로드된 후에는 관리자 페이지에서 설정한 여분 필드 번호에 맞춰 코드가 작성되었는지 확인합니다.

• 값 출력: <?php echo $config['cf_1']?> ~ <?php echo $config['cf_10']?>
• 제목 출력: <?php echo $config['cf_1_subj']?> ~ <?php echo $config['cf_10_subj']?>

경로 설정 시 보안과 성능을 고려하여 가급적 정적 경로를 사용하는 것이 권장됩니다.

환경 설정 여분 필드 활용 단계

• 내 상황: 그누보드 관리자 페이지에서 설정한 여분 필드 값을 원하는 페이지나 커스텀 파일에서 출력하고자 함
• 선택 기준: 그누보드 기본 페이지 내부인지, 혹은 루트 외의 독립된 커스텀 페이지인지 여부에 따라 common.php 인클루드 필요성 결정
• 다음 행동: 관리자 페이지(기본 환경설정)에서 여분 필드 값과 제목을 입력한 뒤, 출력할 페이지 상단에 common.php 파일을 포함하고 <?php echo $config['cf_1'];?> 형태의 코드로 호출

실전 FAQ

Q. 커스텀 페이지에서 여분 필드 코드를 넣었으나 값이 비어있거나 출력되지 않습니다.

• 예외 및 대안: 그누보드 루트 폴더 외부에 임의로 파일을 생성한 경우, 그누보드 설정 데이터베이스($config)가 로드되지 않아 값이 출력되지 않습니다. 해당 파일의 상단에 그누보드 루트의 common.php 파일이 정확한 상대/절대 경로로 include_once 되어 있는지 반드시 확인해야 합니다.

함께 보면 좋은 글

• 그누보드5 게시판 리스트 스킨에서 여분 필드 값에 따른 조건부 UI 출력 방법
• 아미나빌드 위젯에서 게시판 여분 필드(wr6) 출력 및 커스터마이징 방법
• 그누보드 게시판 및 전체 검색 결과에 여분 필드 포함하는 방법

참고자료

기타 참고자료

• sir.kr — 그누보드5 매뉴얼
• gnustudy.com — 환경 설정에 있는 그누보드 설정 여분 필드 사용 방법 - 그누보드팁
• denisoh.tistory.com — 최고의 개발 인프라 닷넷 - 그누보드4 - 기본환경설정 여분필드 활용하기
• sir.kr — 일반페이지에서 cf_1 불러오기 - SIR - 개발자 커뮤니티
• sir.kr — SIR - 개발자 커뮤니티
• sir.kr — common.php 를 졸라 쉽게 인클루드 하기 - SIR - 개발자 커뮤니티
• sir.kr — 새페이지 (일반페이지) .php 파일을 만들고 거기에 mysql 연결하는법... - SIR - 개발자 커뮤니티