HeuJung
d263f74cae
출시가 다시 미뤄져 코어 7.0.10 과 함께 나가는 패키지의 CHANGELOG 출시일을 오늘로 맞췄다. origin/release(7.0.9, 2026-08-24) 페이로드 대비 버전이 오른 패키지 31종 + 코어 = 32건이 대상이며, 최상단 절 헤더 날짜 한 줄씩만 바뀐다. 버전이 오르지 않은 언어팩 10종은 7.0.9 이전 릴리즈분이라 건드리지 않았다. 활성 디렉토리 사본은 gitignore 대상이라 릴리즈 페이로드에 포함되지 않으므로 update 커맨드를 돌리지 않았다. 결제 3종(kginicis·nhnkcp·nicepayments)은 버전 검사 하네스가 차단으로 띄우지만 저장소 릴리즈 미발행 확장이라 origin/release 페이로드가 기준이며, 재실측 결과 셋 다 페이로드 +1 로 정합이다.
그누보드7 Hello 사용자 템플릿
그누보드7 템플릿 · gnuboard7-hello_user_template 학습용 최소 샘플 사용자 템플릿 (Basic 8개 컴포넌트)
소개 · 주요 기능 · 동작 방식 · 요구 사항 · 설치 · 제공 컴포넌트 · 사용 방법 · 다른 확장과의 연동 · 문서 · 트러블슈팅 · 변경 이력 · 라이선스
소개
그누보드7 사용자 템플릿이 어떻게 생겼는지 보여주는 학습용 샘플입니다. 실제 운영에 쓰기 위한 것이 아니라, "방문자 화면 템플릿은 최소한 무엇을 갖춰야 하는가" 와 "모듈의 데이터를 화면에 어떻게 연결하는가" 를 보이는 것이 목적입니다.
담긴 것은 화면 부품 8개, 공통 뼈대 하나, 홈 화면 한 장, 그리고 오류 화면 6종입니다. 홈 화면은 학습용 모듈의 메모 목록을 불러와 보여줍니다 — 모듈은 데이터를, 템플릿은 화면을 담당하는 그누보드7 의 기본 구조를 가장 짧게 보여주는 예시입니다.
관리자 화면의 템플릿 목록에는 나타나지 않습니다(학습용이 운영 목록에 섞이지 않도록). 명령줄로 설치·활성화할 수 있으며, 학습용 모듈이 함께 설치되어 있어야 홈 화면에 목록이 나옵니다.
주요 기능
| 영역 | 설명 |
|---|---|
| 화면 부품 | 가장 기본적인 8개 (영역·버튼·제목 3종·링크·글자·이미지) |
| 공통 뼈대 | 모든 화면이 물려받는 방문자 기본 골격 (헤더 + 콘텐츠 + 푸터) |
| 홈 화면 | 학습용 모듈의 메모 목록을 불러와 표시 |
| 오류 화면 | 401·403·404·500·503·점검 중 6종 |
| 다국어 | 한국어·영어 공통 문구 |
| 테스트 | 데이터를 모의로 넣고 화면이 그려지는지 확인하는 예시 |
동작 방식
flowchart TD
B[_user_base<br/>헤더 + 콘텐츠 + 푸터] --> H[home<br/>메모 목록]
B --> E401[401 권한 없음]
B --> E403[403 접근 거부]
B --> E404[404 없는 페이지]
B --> E500[500 서버 오류]
B --> E503[503 이용 불가]
B --> EM[maintenance 점검 중]
모든 화면이 하나의 공통 뼈대를 물려받습니다. 오류 화면에서도 사이트 골격이 유지되고, 뼈대를 한 번 고치면 전 화면에 반영됩니다.
flowchart LR
V[방문자] --> H[홈 화면]
H -->|목록 요청| M[학습용 모듈]
M --> DB[(메모 데이터)]
홈 화면은 자기 데이터를 갖지 않고 모듈에 요청해서 받아옵니다. 그래서 템플릿을 바꿔도 데이터는 그대로 남고, 같은 데이터를 다른 디자인으로 보여줄 수 있습니다.
요구 사항
| 항목 | 값 |
|---|---|
| 그누보드7 코어 | >=7.0.10 |
| PHP | ^8.2 |
| 의존 모듈 | gnuboard7-hello_module >=0.1.0 |
설치
# 번들 설치 (코어에 동봉된 소스에서 설치)
php artisan template:install gnuboard7-hello_user_template
# 활성화
php artisan template:activate gnuboard7-hello_user_template
# 업데이트 (번들 소스 기준 강제 반영)
php artisan template:update gnuboard7-hello_user_template --force
제공 컴포넌트
컴포넌트 8개 (루트: src/components).
| 분류 | 개수 |
|---|---|
basic |
8개 |
방문자 화면을 그리는 데 쓰는 부품 8개입니다. 기본 사용자 템플릿이 79개를 갖는 것과 비교하면 이 샘플이 얼마나 최소한만 담고 있는지 알 수 있습니다.
부품 목록은 다른 확장과의 계약이기도 합니다. 모듈이나 플러그인이 이 템플릿의 화면에 조각을 끼워 넣을 때 여기 없는 부품을 쓰면 그 조각은 그려지지 않습니다.
전체 목록과 사용법은 docs/components.md 에 있습니다.
사용 방법
설치해 보기: 학습용 모듈을 먼저 설치한 뒤 이 템플릿을 설치합니다.
php artisan module:install gnuboard7-hello_module
php artisan module:activate gnuboard7-hello_module
php artisan template:install gnuboard7-hello_user_template
php artisan template:activate gnuboard7-hello_user_template
활성화하면 사이트 첫 화면이 이 최소 템플릿으로 바뀌고, 관리자에서 등록한 메모가 홈 화면에 목록으로 나옵니다. 원래 템플릿으로 되돌리려면 그 템플릿을 다시 활성화하면 됩니다.
모듈 데이터를 화면에 연결하는 법 배우기: 홈 화면 파일(layouts/home.json)의 데이터 요청
선언을 보면, 어떤 주소에서 무엇을 받아 화면 어디에 넣는지가 한눈에 들어옵니다. 새 템플릿을
만들 때 이 선언 형태를 그대로 따라 쓰면 됩니다.
새 사용자 템플릿의 출발점으로 쓰기: 이 디렉토리를 복제한 뒤 식별자를 바꾸고 학습용 표시를 지우면 새 템플릿이 됩니다. 부품과 화면을 필요한 만큼 더해 나가면 됩니다.
다른 확장과의 연동
이 확장이 의존하는 확장
| 확장 | 유형 | 버전 제약 | 번들 |
|---|---|---|---|
gnuboard7-hello_module |
모듈 | >=0.1.0 |
✅ |
이 확장에 의존하는 확장 (이 확장을 비활성화하면 함께 영향을 받습니다)
없음.
문서
| 문서 | 내용 | 상태 |
|---|---|---|
| docs/README.md | 문서 통합 목차와 실측 집계 | ✅ |
| docs/architecture.md | 설계 의도·계층 지도·디렉토리 맵 | ✅ |
| docs/components.md | 템플릿이 제공하는 컴포넌트 | ✅ |
| docs/layouts.md | 레이아웃 목록과 라우트 매핑 | ✅ |
| docs/handlers.md | 템플릿 전용 핸들러와 부트스트랩 | ✅ |
| docs/editor-spec.md | 레이아웃 편집기에 선언한 팔레트·컨트롤·샘플 데이터 | ✅ |
| CHANGELOG.md | 변경 이력 | ✅ |
트러블슈팅
| 증상 | 원인 | 조치 |
|---|---|---|
| 관리자 템플릿 목록에 이 템플릿이 없음 | 학습용이라 목록에서 제외됨 | 정상입니다. 명령줄로 설치·활성화합니다 |
| 홈 화면에 메모 목록이 비어 있음 | 학습용 모듈이 설치·활성화되지 않았거나 메모가 없음 | 모듈을 활성화하고 관리자에서 메모를 몇 건 등록합니다 |
| 화면이 아무것도 안 그려짐 | 빌드 결과물이 없거나 오래됨 | 템플릿을 다시 빌드하고 반영합니다 |
| 오류가 났는데 아무 화면도 안 보임 | 해당 오류 화면이 없음 | 오류 화면 6종이 모두 있는지 확인합니다 |
| 복제해서 만든 템플릿이 목록에 안 보임 | 복제본에 학습용 표시가 남아 있음 | 복제본의 hidden 표시를 지웁니다 |
| 새로 고칠 때마다 화면이 나오다 안 나오다 함 | 화면 부품 등록이 로드 순서를 탐 | 부품 등록에 재시도를 두는 형태(관리자 샘플 참고)로 고칩니다 |
변경 이력
라이선스
MIT