그누보드5 주요 라이브러리 함수 호출 코드 모음

• 목록
• 스크랩

그누보드5 주요 라이브러리 함수 호출 코드 모음

그누보드에서 최근게시물, 외부로그인, 설문조사, 방문자수, 현재접속자수 등을 출력하는 기본 함수 호출 스니펫과 라이브러리 연동 방법을 정리하여 기능을 빠르게 적용하고 문제를 해결할 수 있도록 돕습니다.

메인 페이지 최신글 및 외부로그인 출력 방법

그누보드 메인 페이지나 외부 페이지에서 최신게시물과 외부로그인(로그인 박스)을 출력하려면, 먼저 각 기능을 담당하는 라이브러리 파일을 include_once로 불러온 뒤 관련 함수를 원하는 위치에 호출해야 합니다.

1. 최근게시물 출력 (latest)

최신글을 출력하려면 latest.lib.php 라이브러리를 포함한 후 latest 함수를 사용합니다.

<?php 
include_once(G5_LIB_PATH."/latest.lib.php"); 
// echo latest("스킨폴더", "게시판아이디", 출력라인수, 제목글자수);
echo latest("hp5_date01", "notice", 4, 45); 
?>

• 스킨 지정 예외: 테마 전용 폴더에 있는 스킨을 지정할 때는 theme/스킨명 형태로 접두사를 붙여 지정할 수 있습니다.

2. 외부 로그인 출력 (outlogin)

로그인 박스를 출력하려면 outlogin.lib.php 라이브러리를 포함한 후 outlogin 함수를 사용합니다.

<?php 
include_once(G5_LIB_PATH."/outlogin.lib.php"); 
echo outlogin("basic"); // 외부 로그인
?>

3. 기타 기본 위젯 함수 참고

설문조사, 방문자수, 현재 접속자수 등 추가 위젯도 동일한 방식으로 라이브러리를 포함하여 출력할 수 있습니다.

• 설문조사: poll.lib.php 포함 후 echo poll("basic"); 호출 (※ 그누보드/skin/poll 폴더에 스킨 업로드 및 관리자 페이지에서 설문조사 등록 필요)
• 방문자수: visit.lib.php 포함 후 echo visit("basic"); 호출
• 현재 접속자수: connect.lib.php 포함 후 echo connect(); 호출

그누보드 함수 호출 시 페이지 로드 실패 원인과 확인 방법

그누보드에서 최신글(latest)이나 접속자 함수 등을 호출할 때 페이지가 하얗게 뜨거나 로드되지 않는 현상은 주로 공통 파일(_common.php)이 누락되었거나 라이브러리 경로 설정이 잘못되어 발생합니다.

1. 확인 위치 및 점검 사항

• 공통 파일 포함 여부 확인: 그누보드 함수를 호출하는 외부 페이지나 커스텀 파일 상단에 그누보드 기본 환경을 불러오는 _common.php가 정상적으로 포함되어 있는지 확인합니다.
  • 예시 코드:

  <?php
  $g5_path = "./board"; // 그누보드가 설치된 폴더 경로
  include_once("$g5_path/_common.php");
  ?>

• 라이브러리 경로 상수 확인: latest.lib.php 등 개별 라이브러리를 직접 불러올 때 G5_LIB_PATH 경로가 올바르게 지정되었는지 확인합니다. 경로가 정확한지 확인하기 위해 아래와 같이 출력해 볼 수 있습니다.
  • 예시 코드:

  <?php
  echo '==> '.G5_LIB_PATH.'/latest.lib.php';
  ?>

2. 다음 행동

• 위 경로 확인 코드나 _common.php 호출부에서 오류가 발생한다면, $g5_path 변수의 경로가 실제 서버의 폴더 구조와 일치하는지 FTP 또는 파일 관리자에서 다시 점검합니다.

최신글 썸네일 및 옵션 설정 방법

그누보드5에서 latest() 함수를 호출할 때 이미지 썸네일이나 추가 옵션을 적용하려면, latest.lib.php 내 함수 구조와 전달인자($options) 설정을 활용할 수 있습니다.

latest 함수 구조와 옵션 인자

• 기본 함수 구조: latest(스킨명, 게시판아이디, 출력라인, 글자수);
• 그누보드5 기본 latest() 함수는 공식적으로 표준 옵션 인자를 제공하지 않습니다. 썸네일 크기 조절이나 추가 기능을 구현하려면 사용 중인 최신글 스킨(latest.skin.php)과 latest.lib.php 내부 로직을 직접 수정하거나, 특정 스킨에서 $options 인자를 처리하도록 구현된 커스텀 코드를 활용해야 합니다.
• 예를 들어, 일부 스킨은 $options 인자에 콤마(,)로 구분된 문자열을 전달받아 썸네일 너비 등을 제어하도록 구현되어 있으므로, 반드시 사용 중인 스킨의 소스 코드를 먼저 확인해야 합니다.

확인 및 적용 시 주의사항

• 사용하려는 최신글 스킨과 latest.lib.php 파일 내부에서 $options 인자를 처리하는 로직이 구현되어 있는지 먼저 확인해야 합니다.
• 파일 첨부로 들어간 이미지를 표출하거나 썸네일 확장 기능을 구현할 때는 기본 latest() 함수 외에 사용 중인 스킨과 라이브러리 소스 코드를 확인한 후 인자값을 조정해야 합니다.

방문자수와 현재 접속자수 함수 라이브러리 파일

그누보드에서 방문자수와 현재 접속자수 기능을 출력하려면 각각의 라이브러리 파일을 포함해야 합니다.

1. 방문자수 함수 (visit)

• 포함해야 할 라이브러리 파일: visit.lib.php
• 호출 코드 예시:

  include_once(G5_LIB_PATH.'/visit.lib.php');
  echo visit('basic'); // 방문자수

2. 현재 접속자수 함수 (connect)

• 포함해야 할 라이브러리 파일: connect.lib.php
• 호출 코드 예시:

  include_once(G5_LIB_PATH.'/connect.lib.php');
  echo connect(); // 현재 접속자수

주의사항 및 확인 위치

• 독립된 페이지나 커스텀 위치에서 해당 함수를 단독으로 호출할 때는 라이브러리 파일이 올바른 경로(G5_LIB_PATH)로 로드되어 있는지 확인해야 합니다.

상황별 최신글 및 위젯 함수 적용 기준

내 상황	우선할 판단	다음 행동
메인 페이지에 특정 게시판 최신글을 각각 다르게 출력하고 싶음	원본 index 파일의 자동 반복 루프 코드를 개별 호출 코드로 교체	복잡한 반복문을 삭제하고 <?php echo latest("스킨명", "게시판아이디", 출력라인, 글자수);?> 코드를 원하는 위치에 각각 직접 삽입
테마 전용 폴더에 있는 최신글 스킨을 지정해서 출력하고 싶음	루트 경로 대신 테마 전용 스킨 경로 접두사 사용 여부 확인	스킨명 인자에 theme/ 접두사를 붙여 "theme/스킨명" 형태로 지정

실전 FAQ

Q. 최신글 스킨을 지정했는데 함수 실행 시 파일이나 경로를 찾지 못한다는 경고(Warning)가 발생합니다.

• 원인 및 대처: latest.lib.php 등의 라이브러리 파일이 정상적으로 include되지 않았거나 G5_LIB_PATH 경로 설정이 잘못된 경우에 발생합니다. 외부 페이지나 커스텀 파일에서 함수를 호출할 때는 상단에 그누보드 환경을 불러오는 _common.php와 라이브러리 파일이 올바른 경로로 포함되어 있는지 확인해야 합니다.

함께 보면 좋은 글

• 그누보드 적용 가능한 반응형 jQuery 슬라이드 및 갤러리 라이브러리 모음
• 제이쿼리 기반 모달 팝업 라이브러리 목록 및 그누보드 적용 가이드
• 그누보드 외부 스팸 차단 라이브러리(zmSpamFree) 연동 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드5 최신글 스킨 적용 및 함수 사용법 | 데빈포 : 그누보드 포럼
• sir.kr — 내가 쓴 특정 게시판 최신글(latest) 불러오기 - SIR - 개발자 커뮤니티
• sir.kr — 그누보드5 latest 문법문의 - SIR - 개발자 커뮤니티
• sir.kr — 웹페이지에서 그누보드5 최신글 적용하려 합니다. - SIR - 개발자 커뮤니티
• sir.kr — 현재접속자 외부에 띄우는 방법 아시는분 도와주세요~ - SIR - 개발자 커뮤니티
• m.blog.naver.com — 7. 그누보드5 라이브러리 파일 : 네이버 블로그