그누보드4 주요 기능 외부 페이지 연동 가이드

• 목록
• 스크랩

그누보드4 주요 기능 외부 페이지 연동 가이드

그누보드4 환경에서 최신글, 외부 로그인, 설문조사 등 주요 기능을 원하는 외부 웹 페이지나 커스텀 파일에 삽입하는 방법과 라이브러리 연동 절차를 확인합니다.

그누보드4 외부 페이지 라이브러리 포함 방법

그누보드4의 외부 페이지에서 최신글, 외부 로그인, 설문조사 등의 주요 기능을 호출하려면, 사용하려는 함수에 맞는 라이브러리 파일을 페이지 상단에서 include_once로 포함해야 합니다.

1. 필수 라이브러리 파일 및 경로 설정

외부 페이지 코드 상단에 그누보드 기본 경로($g4[path])를 기준으로 각 라이브러리 파일을 불러옵니다.

• 최신글 출력 함수(latest) 호출 시

  include_once("$g4[path]/lib/latest.lib.php");

• 외부 로그인 함수(outlogin) 호출 시

  include_once("$g4[path]/lib/outlogin.lib.php");

• 설문조사·투표 함수(poll) 호출 시

  include_once("$g4[path]/lib/poll.lib.php");

2. 함수 호출 예시

라이브러리를 포함한 뒤 필요한 위치에 각 기능을 출력하는 코드를 삽입합니다.

<?php
include_once("$g4[path]/lib/latest.lib.php");
echo latest("happyjung_notice", "notice", 4, 45); // 최근게시물 출력

include_once("$g4[path]/lib/outlogin.lib.php");
echo outlogin("basic"); // 외부 로그인 출력

include_once("$g4[path]/lib/poll.lib.php");
echo poll("basic"); // 설문조사 출력
?>

3. 사전 조건 및 주의사항

• 설문조사 기능을 적용할 때는 그누보드/skin/poll 폴더에 스킨을 업로드한 후, 관리자 계정으로 로그인하여 설문조사를 등록해야 정상적으로 출력됩니다.
• 그누보드5 환경에서는 라이브러리 경로(예: G5_LIB_PATH)와 함수 호출 방식이 다를 수 있으므로 운영 중인 버전을 확인해야 합니다.

그누보드4 외부 디렉토리 경로 설정 방법

그누보드4 설치 경로가 다른 외부 디렉토리에서 공통 파일과 라이브러리를 불러올 때는 작업 중인 페이지 파일 상단에서 $g4_path 변수와 common.php 파일의 상대 경로를 올바르게 지정해야 합니다.

디렉토리 구조별 경로 설정 예시

• 그누보드 폴더 내부에 바로 파일을 생성하는 경우

  <?
  $g4_path = "."; // common.php 의 상대 경로
  include_once("$g4_path/common.php");
  ?>

• 외부 디렉토리(home 등) 내부에 그누보드 폴더(gnuboard4)가 따로 있는 경우

  <?
  $g4_path = "../gnuboard4"; // common.php 의 상대 경로
  include_once("$g4_path/common.php");
  ?>

• 하위 폴더(menu 등) 안에 페이지를 만들어 한 단계 상위 디렉토리로 이동해야 하는 경우

  <?
  $g4_path = "../../"; // common.php 의 상대 경로
  include_once("$g4_path/common.php");
  ?>

위와 같이 외부 페이지 위치에 맞춰 그누보드 설치 경로를 인식할 수 있도록 $_path 값을 설정한 뒤 common.php를 포함하면 경로 오류 없이 연동 기능을 사용할 수 있습니다.

그누보드4 설문조사 기능 외부 페이지 적용 사전 설정

그누보드4 설문조사 기능을 외부 페이지에 적용하기 앞서 관리자 페이지에서 거쳐야 하는 사전 설정 단계는 다음과 같습니다.

1. 스킨 업로드: 그누보드/skin/poll 폴더에 설문조사 스킨을 업로드합니다.
2. 관리자 투표 등록: 관리자로 로그인한 후 설문조사를 등록하여 사용 환경을 설정합니다.

함수 호출 및 연동

관리자 설정 완료 후 외부 페이지 코드 내에서 아래 라이브러리 파일을 포함하고 함수를 호출합니다.

<?php
include_once("$g4[path]/lib/poll.lib.php");
echo poll("basic"); // 설문조사, 투표
?>

그누보드4 주요 기능 외부 페이지 연동 가이드

그누보드4 환경에서 최신글, 외부 로그인, 설문조사 등 주요 기능을 외부 페이지에 삽입하려면 각 기능에 해당하는 라이브러리 파일을 먼저 include한 뒤 함수를 호출해야 한다.

1. 기본 경로 및 라이브러리 포함 설정

외부 페이지 상단에 그누보드4가 설치된 경로($g4[path])를 기준으로 라이브러리 파일을 불러온다.

<?php
// 최근게시물 라이브러리
include_once("$g4[path]/lib/latest.lib.php");

// 외부 로그인 라이브러리
include_once("$g4[path]/lib/outlogin.lib.php");

// 설문조사 라이브러리
include_once("$g4[path]/lib/poll.lib.php");

// 방문자수 및 현재 접속자수 라이브러리 (선택)
include_once("$g4[path]/lib/visit.lib.php");
include_once("$g4[path]/lib/connect.lib.php");
?>

2. 주요 기능 함수 호출 예시

• 최신글 출력

  <?php 
  // echo latest("최근게시물폴더", "게시판이름", 게시물수, 제목글자수);
  echo latest("happyjung_notice", "notice", 4, 45); 
  ?>

  최신글 내용과 링크를 직접 출력하려면 아래 예시를 응용할 수 있다.

  <?php 
  echo "<a href='{$list[$i]['href']}'>"; 
  $view_content = $list[$i]['wr_content']; 
  $view_content = cut_str(strip_tags($view_content), 345, ""); 
  echo "{$view_content}..."; 
  echo "</a>"; 
  ?>

• 외부 로그인 출력

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

• 설문조사(투표) 출력설문조사 기능을 사용하려면 먼저 그누보드/skin/poll 폴더에 스킨을 업로드한 후, 관리자 페이지에 로그인하여 설문조사를 등록해야 한다.

  <?php 
  echo poll("basic"); // 설문조사, 투표 
  ?>

• 방문자 및 접속자 출력

  <?php 
  echo visit("basic"); // 방문자수 
  echo connect(); // 현재 접속자수 
  ?>

주의사항: 그누보드5 환경에서는 라이브러리 경로와 함수 호출 방식이 다를 수 있다.

그누보드4 외부 페이지 연동 가이드

• 상황: 그누보드4 설치 경로와 다른 외부 디렉토리에서 최신글, 로그인, 설문조사 기능을 삽입하려는 경우
• 선택 기준: 페이지의 디렉토리 위치에 따라 $g4_path 상대 경로를 설정하여 common.php를 먼저 연동해야 합니다.
• 다음 행동:
  1. 페이지 상단에 $g4_path를 정의하고 common.php를 포함합니다. (Q2 참조)
  2. 필요한 기능별 라이브러리를 include_once로 불러옵니다. (Q1 참조)
  3. 각 함수(latest(), outlogin(), poll())를 호출하여 기능을 출력합니다. (Q1 참조)

실전 FAQ

Q. 외부 페이지에서 함수를 호출했는데 출력이 되지 않고 공백이 발생합니다.

• 원인 및 확인: 페이지 상단에 지정한 $g4_path 또는 $g4[path] 경로가 실제 그누보드4 설치 디렉토리와 일치하지 않아 common.php나 라이브러리 파일을 불러오지 못했을 가능성이 높습니다. 페이지 위치(하위 폴더 깊이)에 맞춰 상대 경로(../ 등)를 올바르게 수정해야 합니다.

Q. 설문조사 함수(poll)를 넣었으나 투표 내용이 나타나지 않습니다.

• 예외 및 대안: 라이브러리 호출 외에도 그누보드/skin/poll 폴더에 스킨이 정상적으로 업로드되어 있어야 하며, 관리자 계정으로 로그인해 설문조사를 직접 등록해야 화면에 출력됩니다.

참고자료

기타 참고자료

• sir.kr — 그누보드로 홈페이지 2개 운영하기 - SIR - 개발자 커뮤니티