그누보드4 최신글 스킨을 활용한 원본 첨부파일 기반 배너 및 갤러리 구현

• 목록
• 스크랩

그누보드4 최신글 스킨을 활용한 원본 첨부파일 기반 배너 및 갤러리 구현

그누보드4에서 <code>latest</code> 함수와 첨부파일 스킨을 연동하여 원본 이미지를 배너나 갤러리 형태로 출력하는 방법과 옵션 인자 구조를 확인합니다.

그누보드4 latest 함수 기본 구조 및 옵션 인자

그누보드4에서 원본 첨부파일을 기반으로 배너나 갤러리를 구현할 때 사용하는 latest 함수의 기본 구조와 옵션 인자의 상세 순서는 다음과 같습니다.

기본 함수 구조

사용하려는 최신글 삽입 위치(예: index.php 또는 head.php)에 아래와 같은 형식의 코드를 추가하고 사이트 환경에 맞춰 옵션을 변경합니다.

<?php echo latest("hp_utf_gallery_original_file", "test", 6, 100, "80, 2, 200, 10, #000000, 1" ); ?>

• 기본 함수 구성: latest("스킨폴더명", "테이블명", 전체갯수, 가로폭, "옵션값");

옵션 인자 상세 순서

큰따옴표 내부의 옵션값은 콤마(,)로 구분되며 순서대로 아래의 항목을 설정합니다.

"세로폭, 줄수, 테이블폭, 빈TR높이, 제목글자색, 제목노출여부"

• height: 세로폭
• row_cnt: 줄수 (예: row를 2로 설정할 경우 6개의 글을 2줄로 나눠서 한 줄에 3개씩 표시)
• table_width: 테이블 폭
• td_height: 빈 TR 높이
• link_color: 제목 글자색
• title_view: 제목 노출 여부 (제목 안 보일 때 = 0, 보일 때 = 1)

실제 보여질 첨부파일 개수가 등록된 글 개수보다 적을 경우, 등록된 글 개수만큼 표시됩니다.

최신글 첨부파일 개수 차이에 따른 화면 표시 방식

그누보드4의 latest 함수는 기본적으로 등록된 글 개수를 기준으로 데이터를 추출합니다. 사용 중인 스킨의 로직에 따라 첨부파일이 없는 게시물이 포함될 경우, 해당 위치가 빈 공간으로 처리되거나 레이아웃이 어긋날 수 있습니다.

• 빈 공간 처리: 첨부파일이 없는 게시물이 포함되어 있다면 해당 위치는 빈 공간으로 처리되거나 스킨 로직에 따라 다르게 보일 수 있습니다.
• 등록 개수 기준 출력: 실제 보여질 첨부파일 개수가 등록된 글 개수보다 적을 경우, 시스템은 등록된 글 개수만큼 표시합니다.

레이아웃 설계 시 이러한 특성을 고려하여 스킨을 선택하거나 수정해야 하며, 실제 등록된 글 개수와 출력 개수를 비교하여 레이아웃이 깨지지 않는지 확인해야 합니다.

최신글 제목 노출 여부 및 줄 수 변경 방법

그누보드4에서 <code>latest</code> 함수의 옵션 인자 값을 수정하여 갤러리 줄 수와 제목 노출 여부를 직접 제어할 수 있습니다.

옵션 수정 방법

• 제목 숨기기(이미지 배너로만 출력): <code>latest</code> 함수의 마지막 옵션 인자인 <code>제목노출여부</code>(<code>title_view</code>) 값을 <code>0</code>으로 설정합니다. 제목을 보이고 싶을 때는 <code>1</code>로 설정합니다.
• 줄 수 변경: 옵션 인자 중 두 번째 값인 <code>줄수</code>(<code>row_cnt</code>)를 조정합니다. 예를 들어 전체 개수를 6개로 지정하고 줄 수를 2로 설정하면 한 줄에 3개씩 2줄로 배치됩니다.

참고 옵션 구조 예시

<code>&lt;?php echo latest("hputfgalleryoriginalfile", "test", 6, 100, "80, 2, 200, 10, #000000, 1" ); ?&gt;</code>

따옴표 내부의 옵션 상세 순서는 다음과 같습니다.

• <code>"세로폭, 줄수, 테이블폭, 빈TR높이, 제목글자색, 제목노출여부"</code>

상황별 선택 및 적용 가이드

그누보드4에서 원본 첨부파일 기반의 배너 및 갤러리를 구현할 때 거치는 핵심 판단 기준과 다음 행동입니다.

내 상황	우선할 판단	다음 행동
최신글 배너나 갤러리를 화면에 새로 노출해야 할 때	출력할 파일 위치(index.php 또는 head.php)와 사이트에 맞는 레이아웃 규격(가로·세로폭, 줄 수) 산정	최신글 삽입 위치에 latest 함수 코드 추가
이미지 배너로만 쓰거나 제목 노출 방식을 바꾸고 싶을 때	마지막 옵션 인자(title_view)를 0(숨김) 또는 1(노출) 중 선택	latest 함수 옵션 문자열의 마지막 값을 변경
등록된 글 개수와 첨부파일 개수가 차이가 날 때	첨부파일이 없는 게시물 포함 시 빈 공간 발생 여부 확인	등록된 글 개수와 출력 개수를 비교하여 레이아웃 깨짐 점검

실전 FAQ

Q. 지정한 출력 개수보다 등록된 글 개수가 적을 때는 어떻게 작동하나요?

• 시스템이 자동으로 등록된 글 개수만큼만 출력하므로 별도의 예외 처리가 필요하지 않습니다.

Q. 줄 수를 변경해 배너 배치를 바꾸려면 어디를 수정해야 하나요?

• 옵션 인자 중 두 번째 값인 줄수(row_cnt)를 조정합니다. 예를 들어 6개를 2줄로 설정하면 한 줄에 3개씩 배치됩니다.

함께 보면 좋은 글

• 그누보드4 랜덤 갤러리 스킨 적용 방법과 최신글 함수 사용법
• Stylebot을 활용한 그누스터디 대문 및 최신글 디자인 커스텀 방법과 적용 확인
• 그누보드 첨부파일 다운로드 시 매번 포인트 차감 설정 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드4 최신글 스킨을 활용한 원본 첨부파일 기반 배너 및 갤러리 구현