그누보드7을 응원하는 마음으로 작은 데모 하나 올려봅니다.

ChatGPT와 함께 이것저것 만들어본 것이라 아직 부족한 부분이 많습니다. 공개해도 될까 망설였지만, 처음 시작하는 그누보드7에 조금이나마 보탬이 되었으면 하는 마음으로 공유합니다.

자유롭게 사용하셔도 좋습니다. 다만 실사이트에 적용하시기 전에는 충분히 확인해주시고, 이런 구성도 가능하구나 하는 참고 자료로 편하게 봐주시면 감사하겠습니다.

오랫동안 좋은 도구와 나눔의 공간을 만들어주신 SIR에 늘 감사한 마음입니다. 그누보드7의 새로운 시작을 응원합니다. 감사합니다.

ALLI 데모 설치 패키지 1.0.0

그누보드 7.1.2에 설치하는 독립 사용자 테마입니다. 현재 데모의 메뉴, 소개·사업 페이지 16개, 게시판 보기 10종, 쇼핑 화면과 데모 사진이 포함됩니다. Basic 템플릿을 기반으로 제작했으며 원저작자의 MIT 라이선스는 테마의 LICENSE에 보존했습니다.

준비

• 기본 설치와 관리자 생성이 완료된 그누보드 7.1.2 / PHP 8.2 이상.
• 게시판 >=1.2.1, 이커머스 >=1.3.0, 페이지 >=1.2.0 모듈과 주소검색 >=1.0.0 플러그인을 설치·활성화합니다.
• 테마 폴더와 storage에 실행 계정의 쓰기 권한이 필요합니다. 서비스 실행 계정으로 설치하세요.
• ZIP을 웹 공개 경로(public) 밖에 풉니다. 예: /home/user/alli-demo-1.0.0.
• 대상 사이트의 파일과 DB를 백업합니다. 이 ZIP에는 계정, 비밀번호, .env, DB 덤프, 서버 설정이 없습니다.

1. 미리 확인 (변경 없음)

압축을 푼 폴더에서 실행합니다. /var/www/gnuboard7은 실제 그누보드 루트(artisan 파일이 있는 폴더)로 바꾸세요.

php install.php --root=/var/www/gnuboard7 --check

전체 데모 설치를 원하면 --check --demo로 자료 충돌도 확인합니다. 기존 게시판 slug에 일반 게시글이 있거나 DEMO 상품 코드가 다른 용도로 사용 중이면 중단합니다.

2-A. 디자인만 설치하고 적용

php install.php --root=/var/www/gnuboard7 --activate

기본 테마는 보존하며 별도 alli-demo를 설치한 뒤 사용자 테마를 전환합니다. 게시판·상품은 생성하지 않습니다. 비어 있는 메뉴 링크는 게시판을 직접 만들거나 테마의 메뉴 정의를 수정하여 연결하세요.

2-B. 데모 전체 설치하고 적용

php install.php --root=/var/www/gnuboard7 --demo --activate

기본 서비스로 게시판 27개에 최대 30개씩(새 사이트 기준 총810개), 쇼핑 분류3개·상품9개를 등록합니다. 이미지·제목·상품 설명까지 반영하므로 서버에 따라 수십 분 걸릴 수 있습니다. 완료될 때까지 터미널을 유지하세요. 자동 결제·주문은 실행하지 않습니다. 기존 사이트에 샘플이 섞이지 않게 새 사이트에서 전체 데모 설치를 권장합니다.

--activate를 빼면 설치만 하고 현재 화면은 유지합니다. 설치가 끝난 후 관리자의 템플릿 관리에서 ALLI 데모를 선택할 수도 있습니다.

실제 적용 과정

1. 패키지 해시와 버전·필수 확장·자료 충돌 확인.
2. 별도 templates/_bundled/alli-demo에 파일 복사. 다른 테마를 덮어쓰지 않습니다.
3. 공식 template:install alli-demo로 설치. 빌드 결과가 포함되어 Node 설치 불필요.
4. --demo를 선택했으면 기존 모듈 서비스로 샘플 등록.
5. --activate를 선택했으면 공식 template:activate alli-demo로 화면 전환.

코어 수정과 DB 테이블·필드 추가는 없습니다. 테마 등록·활성화 및 데모 자료는 그누보드의 기존 DB 테이블에 정상 저장됩니다. 파일만 풀어서는 이 등록 과정이 이루어지지 않습니다.

충돌·중단·복구

• 실패한 명령에서 중단하며 이후 단계는 실행하지 않습니다. 완료된 자료 일부는 남을 수 있습니다. 원인을 해결한 뒤 같은 명령을 재실행하면 기존 샘플 제목·상품 코드를 확인하여 중복 생성을 피합니다.
• 이미 있는 alli-demo 파일이 패키지와 다르면 덮어쓰지 않고 중단합니다. 수정본을 백업하고 별도로 관리하세요.
• 현재 테마와 복구 명령을 설치 전에 출력합니다. 화면을 되돌리려면 그누보드 루트에서 php artisan template:activate 기존테마식별자를 실행하세요. 기본 테마를 썼다면 php artisan template:activate sirsoft-basic입니다.
• 이전 테마 정보는 storage/app/alli-demo-install-state.json에도 기록됩니다. 테마 전환만 되돌려도 게시글·상품은 남습니다. 샘플 전체 제거가 필요하면 설치 전 DB·업로드 파일 백업으로 복원하세요.
• 다운로드 무결성용 ZIP SHA256 파일과 내부 checksums.json이 포함됩니다. 내부 해시는 우발적 손상 확인용이며 전자서명은 아닙니다.

수정해서 재사용

• 메뉴: templates/_bundled/alli-demo/src/handlers/referenceSite.ts
• 소개 페이지: layouts/reference/
• 디자인: src/styles/reference-*.css
• 사진: dist/vendor/alli-demo/1.0.0/
• 변경 후 공식 빌드·업데이트:

php artisan template:build alli-demo --production
php artisan template:update alli-demo --source=bundled --force

소스를 수정해서 빌드할 때만 그누보드 개발 가이드의 Node·의존성 환경이 필요합니다. manifest·package 버전과 CHANGELOG를 함께 갱신하세요.

데모 기능 범위

달력은 게시글 작성일을 표현합니다. 교육·문의·연혁 화면은 기본 게시판을 활용한 표시 예시입니다. 유튜브형은 썸네일 목록 표현이며 실제 영상은 게시글 에디터로 입력합니다. 상품은 출시예정·재고0의 전시용으로, 실제 판매 전 사업자·결제·배송·상품 설정이 필요합니다. 인증서·협력사·인물은 가상 데모 자료입니다. 실사이트에 맞게 회사명·주소·문구·메뉴·사진을 교체하세요. 기존 데모의 회원·문의·주문 데이터는 포함되지 않습니다.

적용 방법

alli-demo-1.0.0.zip 파일 하나만 다른 서버에 올리면 됩니다. 설치 도구·테마·이미지·샘플 자료·안내서가 모두 들어 있어요.

다만 그누보드 7.1.2가 먼저 설치되어 있어야 합니다.

1. ZIP을 서버의 public 폴더 밖에 업로드하고 압축을 풉니다.
2. 압축을 푼 폴더에서 아래 명령을 실행합니다.

그누보드 7.1.2 설치 후, 압축을 풀고 실행하면 됩니다.

디자인만 적용

php install.php --root=/그누보드/설치경로 --activate

게시판·샘플 글·상품까지 적용

php install.php --root=/그누보드/설치경로 --demo --activate