• 그누보드 — 그누보드 일반 사용 가이드 (바로가기)
• 스킨 만들기 — 스킨 제작 가이드 (바로가기)
• 테마 만들기 — 테마 제작 가이드 (바로가기)
• 개발자 가이드 — 개발자 가이드 (바로가기)
• 플러그인 만들기 — 플러그인 제작 가이드 (바로가기)

카테고리를 눌러 원하는 섹션의 글만 모아볼 수 있습니다.

원문: https://g5guide.github.io/gnuboard/ (g5guide, CC BY-SA 4.0)

설치 환경

그누보드5를 설치하기 위해서는 아래 조건을 만족해야한다

• PHP 7.2 이상 권장 (최소 PHP 5.2.17 이상)
• MySQL 5.0 이상 또는 MySQL 5.0 이상의 기능을 만족하는 MariaDB
• 리눅스 호환 OS
• 필수 PHP 확장
• GD Library 2.0 이상
• iconv
• 권장 PHP 확장
• cURL
• MBString (Multibyte String)

설치 방법

1. 그누보드 최신 버전 다운로드: https://sir.kr/g5_pds
2. (S)FTP, SSH 접속 등을 통해 서버에 업로드

git clone https://github.com/gnuboard/gnuboard5.git .

git clone https://github.com/gnuboard/gnuboard5.git public_html

3. 그누보드 파일들을 업로드한 폴더에 data 폴더 생성
4. 브라우저에서 설치 페이지 접속
5. 그누보드 약관 동의
6. DB 정보 및 관리자 정보, 설치 옵션 입력

7. 설치가 완료되면 이제 그누보드를 사용할 수 있다.
8. 초기 설정을 참고하여 그누보드의 기본 설정을 참고하여 주요 설정을 살펴보고 변경해주는 것이 좋다.

원문: https://g5guide.github.io/gnuboard/install.html (g5guide, CC BY-SA 4.0)

관리페이지 접근 주소 변경

그누보드 관리페이지 접근 주소는 https://.../adm이다. 취약점을 이용하는 공격자들은 이런 알려진 주소로 공격을 시도하므로 주소 자체를 변경해두면 위험을 사전에 방지할 수 있다.

adm 폴더의 이름을 변경하고 config.php 파일에서 G5_ADMIN_DIR 상수의 값을 변경해주면 된다.

관리페이지 폴더명을 adm에서 my_backoffice로 변경하는 예시이다.

# shell 에서 폴더명을 변경하거나 FTP 프로그램을 사용하여 폴더명을 변경한다
.
- ├── adm
+ ├── my_backoffice
├── config.php
└── index.php

config.php 파일에서 G5_ADMIN_DIR 상수의 값을 변경해준다.

- define('G5_ADMIN_DIR', 'adm');
+ define('G5_ADMIN_DIR', 'my_backoffice');

관리페이지는 변경한 폴더명으로 https://.../my_backoffice 주소로 접근할 수 있다.

미사용 영카트 제거

영카트(쇼핑몰) 기능을 사용하지 않는다면 영카트 관련 폴더와 파일들을 삭제할 것을 권장한다. 보안취약점이 발생하면 영향을 받을 수 있기 때문에 영카트 기능을 사용하지 않는다면 아예 제거해두는 것이 좋다.

.
├── adm
- │   └── shop_admin // 폴더 전체 삭제
├── extend
- │   └── shop.extend.php // 파일 삭제
├── lib
- │   ├── shop.uri.lib.php // 파일 삭제
- │   └── shop.lib.php // 파일 삭제
├── mobile
- │   └── shop // 폴더 전체 삭제
- ├── shop // 폴더 전체 삭제
- ├── orderupgrade.php // 파일 삭제
- ├── shop.config.php // 파일 삭제
- ├── yc4_import_run.php // 파일 삭제
- └── yc4_import.php // 파일 삭제

추가로 테마와 스킨에서도 영카트 관련 파일을 제거하는 것을 권장한다.

.
├── mobile
│   └── skin
- │       └── shop // 폴더 전체 삭제
├── skin
- │   └── shop // 폴더 전체 삭제
└── theme
    └── basic
-         ├── shop // 폴더 전체 삭제
        ├── mobile
-         │   ├── shop // 폴더 전체 삭제
        │   └── skin
-         │       └── shop // 폴더 전체 삭제
        └── skin
-             └── shop // 폴더 전체 삭제

기본 사이트 설정

그누보드 관리페이지 '환경설정 -> 기본환경설정'(adm/config_form.php)에서 사이트의 이름과 회원가입, 게시판 공통 설정 등을 변경해주는 것이 좋다.

홈페이지 기본환경 설정

• 홈페이지 제목
• 브라우저에 표시되는 제목, 검색엔진 결과에 나오는 사이트 제목이다
• 관리자 메일 주소 & 관리자 메일 발송이름
• 이메일 발송 시 사용되는 발신자 이메일 주소와 이름
• 포인트 사용
• 포인트 기능을 사용하지 않는다면 이 기능을 비활성화하면 성능 향상에 도움이 된다
• 에디터 선택
• 기본으로 사용할 DHTML 에디터를 지정해준다
• 방문자분석 스크립트
• 구글, 네이버, 빙 등에서 서비스하는 방문자 추적 스크립트 및 구글 서치 콘솔, 웹마스터 도구 등에서 사이트 인증 코드를 여기에 설정할 수 있다

회원가입 설정

• 아이디,닉네임 금지단어
• 일부 기본 값이 설정되어 있으나 사이트 이름이나 도메인 및 사이트 유형에 따라 필요한 단어를 아이디, 닉네임에 사용하지 못하도록 추가 설정해두는 것이 좋다

이 설정은 비회원의 글쓴이 이름에는 적용되지 않는다.

• 회원가입약관 & 개인정보처리방침
• 당장 설정하지 못하더라도 회원가입 등 개인정보를 수집하는 하려면 반드시 게시해야하는 내용을 잊지 말고 설정해야 한다

짧은 주소 설정

짧은 주소 설정은 처음 선택 후 변경하지 않는 것이 좋다. 사이트 운영 중 변경하면 기존 주소 체계에 영향을 주므로 주의해야 한다. "숫자" 형식을 권장한다.

게시판 설정

설치 직후에 이미 생성된 4개의 게시판이 있고, 이 게시판들을 계속 사용할 수 있으며 필요에 따라 게시판 설정을 변경해주는 것이 좋다.

각 게시판의 상단에 '톱니바퀴' 아이콘을 눌러 게시판 설정 페이지에 들어갈 수 있으며, 관리자페이지 '게시판관리'(/adm/board_list.php) 메뉴에서도 설정할 수 있다.

게시판 제목과 포인트, 에디터 그리고 권한 설정을 변경해주는 것이 좋다.

원문: https://g5guide.github.io/gnuboard/config.html (g5guide, CC BY-SA 4.0)

• 가장 낮은 레벨은 1, 가장 높은 레벨은 10
• 최고관리자는 한 명만 지정할 수 있다
• 최고관리자로 지정할 회원은 레벨이 10이어야 한다
• "아이디,닉네임 금지단어"는 비회원 작성자 이름에는 제한이 적용되지 않는다

게시판

• 글은 카테고리를 하나만 선택할 수 있다
• 글은 작성일시만 기록되며, 수정일시는 기록되지 않는다
• 태그(꼬리표) 기능을 지원하지 않는다
• 답글과 댓글의 답변댓글은 26개까지만 가능하다
• 글, 댓글 내용이 64KB보다 길어지면 내용이 잘린채로 저장된다

짧은 주소

• "숫자" 형식 사용을 권장. "글 이름" 형식은 절대 사용하지 않는 것을 권장한다
• 짧은 주소 설정은 사용 중에 변경해도 다른 형식의 주소는 계속 사용할 수 있다

기타 (정리 중)

• 글을 가리키는 변수명, 테이블명 등에는 article, document 또는 post가 아니라 write가 사용되었다
• Hook을 이용해 그누보드를 확장할 수 있다
• 메뉴는 최대 2단계 깊이까지만 지원한다
• 도메인을 변경하면 메뉴 및 글, 댓글의 내용에서 주소를 모두 변경해주어야 한다
• 영카트 기능을 사용하지 않는다면 제거하자
• 검색엔진 최적화(SEO)를 위한 최소한의 지원도 하지 않는다
• 포인트 기능을 비활성화하면 약간의 성능향상을 기대할 수 있다. 포인트 기능을 사용하지 않는다면 "환경설정 -> 기본환경설정"에서 "포인트 사용" 해제
• 이모지(emoji)를 사용하려면 DB에서 utf8mb4로 설정해야 한다
• 그누보드는 대부분 Accept HTTP 헤더를 인식하고 처리하지 않는다

원문: https://g5guide.github.io/gnuboard/tip.html (g5guide, CC BY-SA 4.0)

회원은 '회원 레벨'로 권한을 제한할 수 있다. 글/댓글 쓰기 및 읽기, 파일 다운로드, 쪽지 기능 사용 등의 권한을 제한하는데 사용된다. 특별한 권한을 가진 그룹 관리자, 게시판 관리자를 설정할 수도 있다.

회원 레벨

회원의 레벨은 가장 낮은 1 레벨부터 가장 높은 10 레벨까지 설정할 수 있으며, 일반적으로 다음과 같이 활용한다.

• 1 레벨 (가장 낮음) : 비회원 및 비회원 수준으로 취급되는 권한이 제한된 회원
• 2~9 레벨 : 일반적인 회원
• 10 레벨 (가장 높음) : 관리자 유형의 회원

그누보드에서 보편적으로 통용되는 수준의 해석이며, 스킨이나 플러그인 등의 설정에 따라 이 유형의 구분은 다르게 취급될 수 있다.

관리 권한

관리자 권한은 최고관리자(super), 그룹관리자(group), 게시판관리자(board)로 구분된다.

각 관리자 유형별로 최고관리자는 한 명, 그룹과 게시판 관리자는 각 개별 그룹과 게시판별로 한 명씩만 지정할 수 있다.

• 최고관리자
• 그누보드의 모든 기능 및 설정 등의 모든 권한을 가진 유일한 권한이다
• 그룹관리자
• 그룹에 속한 모든 게시판의 관리 권한을 가진다
• 게시판관리자
• 특정 게시판의 관리 권한을 가진다

원문: https://g5guide.github.io/gnuboard/member.html (g5guide, CC BY-SA 4.0)

• 홈페이지 제목
• 브라우저 타이틀 및 사이트 이름을 표시할 때 사용되는 사이트 이름
• 최고관리자
• 사이트의 모든 권한을 가지는 회원 계정을 지정할 수 있다
• 그누보드 설치 시 입력한 계정이 최고관리자로 지정된다

데이터 보관 설정

• 최근게시물 삭제
• 새글(/bbs/new.php) 페이지에 보여지는 게시물 목록의 유지 기간
• 게시판에서 "전체 검색 사용"이 허용된 게시판의 글 목록이 따로 보관되는 목록이다
• 쪽지 삭제
• 회원이 주고받은 쪽지의 유지 기간
• 기간이 만료된 쪽지는 자동으로 삭제된다
• 접속자로그 삭제
• /adm/visit_list.php 페이지에 보여지는 접속자 목록의 유지 기간
• 인기검색어 삭제
• 전체검색 기능에서 검색한 키워드와 통계를 저장하는 유지 기간
• 현재 접속자
• /bbs/current_connect.php 페이지에 보여지는 접속자 목록의 유지 기간

스킨

• 최근게시물 스킨
• 검색 스킨
• 접속자 스킨
• FAQ 스킨

포인트

• 포인트 사용
• 포인트 기능 활성화 여부
• 포인트 기능을 사용하지 않는다면 체크를 해제하여 기능을 비활성화하여 불필요한 동작을 줄여 약간의 성능향상을 기대할 수 있다

회원가입 설정

게시판 기본 설정

짧은 주소 설정

원문: https://g5guide.github.io/gnuboard/basic-config.html (g5guide, CC BY-SA 4.0)

테마

그누보드에는 "basic" 테마를 포함하고 있으며 기본으로 적용된 상태로 그누보드가 설치된다.

테마는 /theme 폴더에 설치되어있으며, 테마를 내려받아 이 폴더에 설치하여 사용할 수 있다. 관리페이지 "환경설정 -> 테마설정"에서 테마를 선택하여 사용할 수 있다.

스킨

스킨은 게시판과 회원, 최근게시물 위젯, 검색 결과, FAQ 페이지 등에서 적용할 수 있다.

스킨은 /skin 폴더 또는 사용하는 테마의 skin 폴더(예: /theme/basic/skin)에 설치하여 사용할 수 있다.

원문: https://g5guide.github.io/gnuboard/theme-and-skin.html (g5guide, CC BY-SA 4.0)

그누보드가 설치된 후 네 개의 게시판이 기본 생성되어있고, 각 게시판은 기본으로 설정된 "커뮤니티" 그룹에 속해있다.

게시판

권한 설정

게시판 관리자를 1명 지정할 수 있으며, 여러 권한을 지정하여 회원 레벨에 따른 게시판 기능의 사용 권한을 제한할 수 있다.

기능 설정

게시판 그룹

그룹은 게시판을 그룹지어 활용 및 관리에 사용하는 기능이며, 다음과 같은 기능을 이용할 수 있다.

• 접근제한 기능으로 허용된 회원들만 접근을 허용할 수 있다
• 그룹 설정에서 "접근회원사용"을 활성화
• 그룹의 관리자를 지정할 수 있다
• 그룹에 속한 게시판의 관리 권한이 주어진다
• 게시판 설정 시 "그룹적용" 기능으로 같은 그룹의 게시판에 같은 설정을 일괄 적용할 수 있다
• 그룹별 페이지가 제공된다
• /group.php?gr_id=그룹아이디
• 게시판에 글 작성 시 그룹관리자에게 알림 메일 발송
• "회원메일발송" 기능에서 특정 그룹의 회원에게만 메일 발송 가능

원문: https://g5guide.github.io/gnuboard/board.html (g5guide, CC BY-SA 4.0)

포인트 설정

포인트 설정은 관리페이지 "환경설정 -> 기본환경설정"에서 대부분의 포인트 설정할 수 있다.

• 포인트 사용
• 포인트 적립, 사용 및 제한 기능의 사용 여부
• 포인트 유효 기간
• 적립된 포인트의 사용 유효 기간

이 외 회원가입, 로그인 시 적립 포인트, 글/댓글 작성 시 적립 및 다운로드 시 차감 포인트 등을 설정할 수 있다. 포인트 설정은 분산되어 있으므로 설정 페이지에서 "포인트"로 검색하여 찾으면 좋다.

게시판의 포인트 설정

게시판마다 글, 댓글 작성 시 적립 및 글 읽기 시 차감, 파일 다운로드 시 차감 포인트를 설정할 수 있다. "환경설정 -> 기본환경설정"에서 설정한 값은 공통설정 값이며, "게시판관리" 메뉴에서 게시판별로 개별 설정할 수 있다.

"게시판관리"메뉴에서 전체 게시판 목록에서 "읽기P", "쓰기P" 등의 항목이 포인트 설정이다.

• 읽기P: 글 읽기 시 차감 포인트
• 쓰기P: 글 작성 시 적립 포인트
• 댓글P: 댓글 작성 시 적립 포인트
• 다운P: 파일 다운로드 시 차감 포인트

값을 변경했으면 가장 왼쪽의 체크박스를 선택 후 "선택수정" 버튼을 눌러야 저장된다. 각 게시판 설정(수정) 페이지에서도 포인트 설정을 변경할 수 있으며, "기본값으로 설정"에 체크하면 "기본환경설정"에서 설정한 기본 값을 가져와 적용할 수 있다.

원문: https://g5guide.github.io/gnuboard/point.html (g5guide, CC BY-SA 4.0)

순서

표시 할 기기 설정

PC와 모바일 기기를 구분하여 메뉴를 표시하거나 표시하지 않을 수 있다. 표시하려는 기기에 "사용함"으로 선택하면 된다.

원문: https://g5guide.github.io/gnuboard/menu.html (g5guide, CC BY-SA 4.0)

회원의 개인정보

회원의 정보는 그누보드 환경설정에 따라 일부 항목은 선택 사항이거나 필수 입력이 필요한 항목일 수 있습니다.

소셜로그인 이용 시 수집되는 정보

본인인증 시 수집되는 정보

본인인증(성인인증 포함) 서비스 사용 시 수집하고 저장하는 개인정보는 다음과 같습니다.

게시판 등에서 수집되는 정보

게시판 및 1:1 문의 등에서 글, 댓글 등을 작성하거나 이용하는 과정에서 수집 및 저장되는 정보입니다.

사이트 이용 중 자동수집되는 정보

영카트(쇼핑기능)에서 수집되는 정보

(작성 중)

쿠키

(작성 중)

원문: https://g5guide.github.io/gnuboard/privacy.html (g5guide, CC BY-SA 4.0)

이미 설치된 영카트를 제거하려면 /data/dbconfig.php 파일에서 영카트 관련 설정을 제거해야 한다.

dbconfig.php 파일에서 G5_USE_SHOP 상수의 값을 true에서 false로 변경한다.

- define('G5_USE_SHOP', true);
+ define('G5_USE_SHOP', false);

또는, 아래와 같은 코드 전체를 삭제해도 된다.

define('G5_USE_SHOP', true);

define('G5_SHOP_TABLE_PREFIX', 'g5_shop_');

$g5['g5_shop_default_table'] = G5_SHOP_TABLE_PREFIX.'default'; // 쇼핑몰설정 테이블
$g5['g5_shop_banner_table'] = G5_SHOP_TABLE_PREFIX.'banner'; // 배너 테이블
$g5['g5_shop_cart_table'] = G5_SHOP_TABLE_PREFIX.'cart'; // 장바구니 테이블
$g5['g5_shop_category_table'] = G5_SHOP_TABLE_PREFIX.'category'; // 상품분류 테이블
$g5['g5_shop_event_table'] = G5_SHOP_TABLE_PREFIX.'event'; // 이벤트 테이블
$g5['g5_shop_event_item_table'] = G5_SHOP_TABLE_PREFIX.'event_item'; // 상품, 이벤트 연결 테이블
$g5['g5_shop_item_table'] = G5_SHOP_TABLE_PREFIX.'item'; // 상품 테이블
$g5['g5_shop_item_option_table'] = G5_SHOP_TABLE_PREFIX.'item_option'; // 상품옵션 테이블
$g5['g5_shop_item_use_table'] = G5_SHOP_TABLE_PREFIX.'item_use'; // 상품 사용후기 테이블
$g5['g5_shop_item_qa_table'] = G5_SHOP_TABLE_PREFIX.'item_qa'; // 상품 질문답변 테이블
$g5['g5_shop_item_relation_table'] = G5_SHOP_TABLE_PREFIX.'item_relation'; // 관련 상품 테이블
$g5['g5_shop_order_table'] = G5_SHOP_TABLE_PREFIX.'order'; // 주문서 테이블
$g5['g5_shop_order_delete_table'] = G5_SHOP_TABLE_PREFIX.'order_delete'; // 주문서 삭제 테이블
$g5['g5_shop_wish_table'] = G5_SHOP_TABLE_PREFIX.'wish'; // 보관함(위시리스트) 테이블
$g5['g5_shop_coupon_table'] = G5_SHOP_TABLE_PREFIX.'coupon'; // 쿠폰정보 테이블
$g5['g5_shop_coupon_zone_table'] = G5_SHOP_TABLE_PREFIX.'coupon_zone'; // 쿠폰존 테이블
$g5['g5_shop_coupon_log_table'] = G5_SHOP_TABLE_PREFIX.'coupon_log'; // 쿠폰사용정보 테이블
$g5['g5_shop_sendcost_table'] = G5_SHOP_TABLE_PREFIX.'sendcost'; // 추가배송비 테이블
$g5['g5_shop_personalpay_table'] = G5_SHOP_TABLE_PREFIX.'personalpay'; // 개인결제 정보 테이블
$g5['g5_shop_order_address_table'] = G5_SHOP_TABLE_PREFIX.'order_address'; // 배송지이력 정보 테이블
$g5['g5_shop_item_stocksms_table'] = G5_SHOP_TABLE_PREFIX.'item_stocksms'; // 재입고SMS 알림 정보 테이블
$g5['g5_shop_post_log_table'] = G5_SHOP_TABLE_PREFIX.'order_post_log'; // 주문요청 로그 테이블
$g5['g5_shop_order_data_table'] = G5_SHOP_TABLE_PREFIX.'order_data'; // 모바일 결제정보 임시저장 테이블
$g5['g5_shop_inicis_log_table'] = G5_SHOP_TABLE_PREFIX.'inicis_log'; // 이니시스 모바일 계좌이체 로그 테이블

영카트 파일 제거

영카트(쇼핑몰) 기능을 사용하지 않는다면 영카트 관련 폴더와 파일들을 삭제할 것을 권장한다. 보안취약점이 발생하면 영향을 받을 수 있기 때문에 영카트 기능을 사용하지 않는다면 아예 제거해두는 것이 좋다.

.
├── adm
- │   └── shop_admin // 폴더 전체 삭제
├── extend
- │   └── shop.extend.php // 파일 삭제
├── lib
- │   ├── shop.uri.lib.php // 파일 삭제
- │   └── shop.lib.php // 파일 삭제
├── mobile
- │   └── shop // 폴더 전체 삭제
- ├── shop // 폴더 전체 삭제
- ├── orderupgrade.php // 파일 삭제
- ├── shop.config.php // 파일 삭제
- ├── yc4_import_run.php // 파일 삭제
- └── yc4_import.php // 파일 삭제

추가로 테마와 스킨에서도 영카트 관련 파일을 제거하는 것을 권장한다.

.
├── mobile
│   └── skin
- │       └── shop // 폴더 전체 삭제
├── skin
- │   └── shop // 폴더 전체 삭제
└── theme
    └── basic
-         ├── shop // 폴더 전체 삭제
        ├── mobile
-         │   ├── shop // 폴더 전체 삭제
        │   └── skin
-         │       └── shop // 폴더 전체 삭제
        └── skin
-             └── shop // 폴더 전체 삭제

원문: https://g5guide.github.io/gnuboard/remove-youngcart.html (g5guide, CC BY-SA 4.0)

일반적인 업그레이드 과정

주의사항

• 업그레이드 전에는 반드시 백업을 해야 한다
• DB 백업

업그레이드 과정

DB 백업

winmerge

git

패치 파일

PHP 버전

원문: https://g5guide.github.io/gnuboard/upgrade.html (g5guide, CC BY-SA 4.0)

그누보드 스킨은 skin 폴더와 mobile/skin에 PC와 모바일 스킨으로 나뉜다. skin 폴더 밑에 board(게시판), latest(최신글) 등 분류별로 나뉘어져있고 분류 밑에 개별 스킨을 넣는다.

.
├── skin # 스킨이 설치된 폴더
│   ├── board # 게시판 스킨들의 폴더
│   │   └── basic # `basic` 이름을 가진 게시판 스킨
│   ├── connect # 현재 접속자 페이지 스킨
│   ├── content # 페이지 컨텐츠 스킨
│   ├── faq # FAQ 스킨
│   ├── latest # 최신글 스킨
│   ├── member # 회원페이지 스킨
│   ├── new # 새글 페이지 스킨
│   ├── outlogin # 로그인 폼 스킨
│   ├── poll # 설문조사 스킨
│   ├── popular # 인기검색어 스킨
│   ├── qa # 1:1문의 스킨
│   ├── search # 검색 결과 스킨
│   └── visit # 접속통계 페이지 스킨
└── mobile # 모바일 기기용 스킨
    └── skin # 모바일 기기용 스킨. 위 skin 폴더 구조와 같음
        ├── board
        │   └── basic # `basic` 이름을 가진 모바일용 게시판 스킨
        ├── ...
        └── visit

테마, 스킨 만들기는 HTML, PHP 그리고 JS와 CSS를 이용하여 만들 수 있다. 이 가이드에서는 HTML, PHP를 일정 수준 이상 이해하고 있다고 가정하고 설명한다.

원문: https://g5guide.github.io/make/skin/about.html (g5guide, CC BY-SA 4.0)

skin
└── board
    └── basic # 'basic'이라는 이름을 가진 스킨 폴더
        ├── list.skin.php # 글 목록
        ├── view.skin.php # 글 내용 보기
        ├── view_comment.skin.php # 댓글 및 댓글 쓰기 폼
        └── write.skin.php # 글 쓰기

skin
└── board
    └── basic
+         ├── delete_all.head.skin.php
+         ├── delete_all.skin.php
+         ├── delete_all.tail.skin.php
+         ├── delete_comment.head.skin.php
+         ├── delete_comment.skin.php
+         ├── delete_comment.tail.skin.php
+         ├── delete.head.skin.php
+         ├── delete.skin.php
+         ├── delete.tail.skin.php
+         ├── download.head.skin.php
+         ├── download.skin.php
+         ├── download.tail.skin.php
+         ├── good.head.skin.php
+         ├── good.tail.skin.php
        ├── list.skin.php
+         ├── view_comment.head.skin.php
        ├── view_comment.skin.php
+         ├── view_comment.tail.skin.php
+         ├── view.head.skin.php
        ├── view.skin.php
+         ├── view.tail.skin.php
+         ├── write_comment_update.head.skin.php
+         ├── write_comment_update.skin.php
+         ├── write_comment_update.tail.skin.php
+         ├── write_update.head.skin.php
+         ├── write_update.skin.php
+         ├── write_update.tail.skin.php
+         ├── write.head.skin.php
        ├── write.skin.php
+         └── write.tail.skin.php

$list;
$board;

$total_count;
$admin_href;
$rss_href;
$write_href;

$is_checkbox;
$is_good;
$is_nogood;
$width;
$is_category;
$category_option;

$sfl;
$stx;
$spt;
$sca;
$sst;
$sod;
$page;

$is_admin;
$is_auth;
$qstr2;

원문: https://g5guide.github.io/make/skin/board.html (g5guide, CC BY-SA 4.0)

글 목록을 출력하는 주요 기능을 예시한 코드는 다음과 같다.

<table>
    <thead>
        <tr>
            <th>번호</th>
            <th>제목</th>
            <th>작성자</th>
        </tr>
    </thead>

    <tbody>
    <?php foreach($list as $idx => $article) { ?>
        <tr>
            <td><?= $article['num'] ?></dt>
            <td>
                <!-- 카테고리 -->
                <?php if ($is_category) { ?>
                    <a href="<?= $article['ca_name_href'] ?>"><?= $article['ca_name'] ?></a>
                <?php } ?>

                <!-- 제목 -->
                <a href="<?= $article['href'] ?>"><?= $article['subject'] ?></a>

                <!-- 댓글 수 -->
                <?php if (!!$article['wr_comment']) { ?>
                    댓글(<?= number_format((int) $article['wr_comment']) ?>)
                <?php } ?>

                <!-- 추천 수 -->
                <?php if ($is_good && !!$article['wr_good']) { ?>
                    추천(<?= $article['wr_good'] ?>)
                <?php } ?>
            </dt>
            <td><?= $article['name'] ?></dt>
        </tr>
    <?php } ?>
    </tbody>
</table>

<?php for ($i = 0; $i < count($list); $i++) { ?>
    제목: <?= $list[$i]['subject'] ?>
<?php } ?>

글 목록

제목과 링크

subject에는 글 제목, href에는 글 주소가 담겨있다.

<!-- 예시: 글 제목에 링크 걸기 -->
<a href="<?= $article['href'] ?>">
    <?= $article['subject'] ?>
</a>

<!-- 원본 제목: $article['wr_subject'] -->
강조 표시된 제목

<!-- 검색한 '표시'가 강조된 제목: $article['subject'] -->
강조 <b class="sch_word">표시</b>된 제목

카테고리

카테고리 이름: <?= $article['ca_name'] ?>

$is_category(bool) 전역변수로 카테고리 사용 여부를 확인하여 출력

<?php if ($is_category) { ?>
    카테고리 이름: <?= $article['ca_name'] ?>
<?php } ?>

ca_name_href 키로 카테고리로 검색하는 링크를 걸 수 있다. 게시판 검색 기능으로 카테고리 명칭으로 검색한 글 목록을 표시한다.

<a href="<?= $article['ca_name_href'] ?>">
    <?= $article['ca_name'] ?>
</a>

작성자

name에는 글쓴이의 정보를 보거나 부가 기능을 위한 메뉴를 표시하는 "사이드뷰" 기능을 위해 <span> 태그로 감싼 메뉴가 포함되어 있다. 사이드뷰 태그가 포함되지 않은 원본 이름은 wr_name에 담겨있다.

작성자: <?= $article['name'] ?>
작성자: <?= $article['wr_name'] ?>

<!-- 출력 -->
작성자: <span ...>작성자이름</span>
작성자: 작성자이름

작성일시

작성일시는 wr_datetime과 datetime, datetime2로 구분되어 날짜 표시 형식을 다르게 표시할 수 있다. datetime2는 작성 당일에는 시:분으로 표시되며, 작성 당일이 지난 글은 월-일로 표시된다.

작성일(년-월-일 시-분-초): <?= $article['wr_datetime'] ?>
작성일(년-월-일): <?= $article['datetime'] ?>
작성일(가변): <?= $article['datetime2'] ?>

<!-- 출력 -->
작성일(년-월-일 시-분-초): 2023-12-31 23:59:59
작성일(년-월-일): 2023-12-31
작성일(가변): 12-31 또는 23:59

조회 수

조회 수는 1천 단위 이상일 때 읽기 쉽게 표시하기 위해 number_format() 함수를 사용하면 좋다.

조회수: <?= $article['wr_hit'] ?>
조회수: <?= number_format((float) $article['wr_hit']) ?>

<!-- 출력 -->
조회수: 100010
조회수: 100,010

추천, 비추천

$is_good(bool), $is_nogood(bool)으로 추천, 비추천 기능의 활성화 여부를 확인하고 표시하는 것이 좋다.

<?php if ($is_good) { ?>
    추천 수: <?= $article['wr_good'] ?>
<?php } ?>

<?php if ($is_nogood) { ?>
    비추천 수: <?= $article['wr_nogood'] ?>
<?php } ?>

기능이 활성화 되어있고 추천/비추천 수가 있을 때(1 이상)만 표시하려면...

<?php if ($is_good && !!$article['wr_good']) { ?>
    추천 수: <?= $article['wr_good'] ?>
<?php } ?>

<?php if ($is_nogood && !!$article['wr_nogood']) { ?>
    비추천 수: <?= $article['wr_nogood'] ?>
<?php } ?>

댓글

댓글 수 : <?= $article['wr_comment'] ?>

댓글이 있는지 구분하려면 wr_comment 값을 확인하면 된다.

<?php if (!!$article['wr_comment']) { ?>
    댓글 수: <?= $article['wr_comment'] ?>
<?php } ?>

기타

위 예시에서 foreach() 반복문으로 $list를 순회하면서 $article에 담긴 변수를 이용해 글 목록을 출력할 수 있다.

목록 정렬

카테고리 목록

검색

페이징

게시물 수: <?= number_format((int) $total_count) ?>
공지사항 수: <?= number_format((int) $notice_count) ?>
전체 페이지 수: <?= number_format($total_page) ?>
현재 페이지: <?= number_format((int) $page) ?>
시작 열: <?= number_format((int) $from_record) ?>

echo $total_count; // 전체 또는 검색 결과의 게시물 수
echo $board['bo_count_write']; // 전체 게시물 수

echo $total_page; // 1234.0
echo (int) $total_page; // 1234
echo number_format((float) $total_page); // 1,234

링크

글 쓰기 페이지 링크는 $write_href 전역변수

<?php if ($write_href) { ?>
    <a href="<?= $write_href ?>">글 쓰기</a>
<?php } ?>

게시판 설정 링크는 $admin_href 전역변수

<?php if ($admin_href) { ?>
    <a href="<?= $admin_href ?>">게시판 설정</a>
<?php } ?>

RSS 링크는 $rss_href 전역변수

<?php if ($rss_href) { ?>
    <a href="<?= $rss_href ?>">RSS</a>
<?php } ?>

기타

원문: https://g5guide.github.io/make/skin/board/list.html (g5guide, CC BY-SA 4.0)

원문: https://g5guide.github.io/make/skin/board/view.html (g5guide, CC BY-SA 4.0)

원문: https://g5guide.github.io/make/skin/board/comment.html (g5guide, CC BY-SA 4.0)

원문: https://g5guide.github.io/make/skin/board/write.html (g5guide, CC BY-SA 4.0)