G7 학습 아카데미 템플릿 - Glitter Learning Academy

Glitter Learning LMS를 기반으로 학습과 커뮤니티를 하나의 공간에 구성하는 Gnuboard7 사용자 시드 템플릿

Gnuboard7 학습 관리 시스템 모듈인 Glitter Learning을 기반으로 개발한 사용자 템플릿, Glitter Learning Academy v1.0.1

Glitter Learning이 강좌 개설, 차시 관리, 수강 신청, 학습 진도 및 수료 이력 등 학습 관리의 핵심 기능을 담당한다면, Glitter Learning Academy는 이러한 기능을 학습자가 실제로 이용할 수 있도록 구성한 사용자 인터페이스입니다.

단순히 강좌 목록을 보여주는 데 그치지 않고, 강좌 탐색부터 수강 신청, 학습 진행, 수료 확인, 커뮤니티 활동까지 하나의 웹사이트에서 자연스럽게 이어지도록 설계했습니다.

1. Glitter Learning과 Glitter Learning Academy

두 확장은 서로 다른 역할을 담당합니다.

Glitter Learning — 학습 관리 시스템(LMS) 모듈

강좌와 차시, 수강 신청, 학습 진도, 수료 판정 및 이력 관리 등의 핵심 기능과 API를 제공합니다.

Glitter Learning Academy — 학습자 중심 사용자 템플릿

Glitter Learning이 제공하는 기능을 기반으로 학습자가 강좌를 탐색하고 학습 활동을 수행할 수 있는 화면을 제공합니다.

이러한 역할 분리를 통해 학습 데이터와 비즈니스 로직은 모듈에서 관리하고, 사용자 경험과 화면 구성은 템플릿에서 담당하도록 했습니다.

따라서 Glitter Learning Academy는 독립적인 LMS 엔진이 아니라 Glitter Learning을 기반으로 동작하는 학습 서비스용 사용자 템플릿입니다.

2. 주요 기능

강좌 탐색 및 학습 과정 안내

학습자는 아카데미 메인 화면과 강좌 목록에서 공개된 학습 과정을 탐색할 수 있습니다.

강좌 상세 화면에서는 강좌 소개, 학습 목표, 난이도, 예상 학습 시간, 차시 구성 등의 정보를 확인하고 수강 여부를 결정할 수 있습니다.

화면은 데스크톱과 모바일 환경을 고려한 반응형 레이아웃으로 구성했습니다.

수강 신청과 학습 진행

로그인한 회원은 강좌에 수강 신청하고 차시별 학습을 진행할 수 있습니다.

학습 화면에서는 콘텐츠를 확인하고 학습 완료 상태를 기록할 수 있으며, 강좌 상세 화면과 내 학습실에서 학습 진행 상황을 확인할 수 있습니다.

수강 신청과 진도 처리 등 실제 학습 데이터의 관리는 Glitter Learning 모듈의 API를 사용합니다.

내 학습실 및 수료 이력

학습자가 자신의 학습 상태를 확인할 수 있도록 내 학습실을 제공합니다.

수강 중인 강좌와 완료된 강좌 등을 구분해 확인할 수 있으며, 수료한 학습 과정의 이력도 조회할 수 있습니다.

이를 통해 강좌 탐색에서 학습 완료까지 이어지는 사용자 흐름을 구성했습니다.

커뮤니티 기능 통합

학습 서비스는 강좌 콘텐츠뿐 아니라 사용자 간 정보 공유와 소통도 중요합니다.

Glitter Learning Academy는 Gnuboard7의 공식 게시판 기능을 활용해 다음과 같은 커뮤니티 영역을 구성할 수 있습니다.

• 공지사항
• 자유게시판
• 질문과 답변
• 자료실

커뮤니티 게시판은 별도의 게시판 엔진을 구현하지 않고 Gnuboard7의 기존 기능을 재사용합니다.

Glitter HelpComm Installer 모듈과 연동하여 기본 게시판 구성을 지원합니다.

통합 검색

Glitter Search Hub와 연동하여 사이트의 콘텐츠를 검색할 수 있는 사용자 화면을 제공합니다.

검색어와 검색 유형에 따른 결과를 표시하고, 유형별 페이지 이동과 검색 오류 처리 기능을 지원합니다.

검색 조건을 변경하면 페이지 번호를 초기화하고, 검색 결과가 없거나 API 요청이 실패한 경우에도 상태를 구분하여 안내하도록 구성했습니다.

전체 검색은 유형별 결과를 미리 보여주는 방식으로 제공됩니다.

3. 반응형 UI와 콘텐츠 표시

Glitter Learning Academy는 학습자가 사용하는 다양한 화면 크기를 고려했습니다.

강좌 카드, 상세 정보, 학습 화면 및 커뮤니티 레이아웃을 모바일 환경에서도 사용할 수 있도록 구성했습니다.

특히 v1.0.1에서는 강좌 설명에 포함된 이미지와 표가 모바일 화면의 너비를 초과하는 문제를 개선했습니다.

• 이미지의 반응형 크기 조정
• 콘텐츠 영역의 너비 제약 개선
• 넓은 표의 내부 가로 스크롤 지원
• 문서 전체의 불필요한 가로 스크롤 방지
• 검색 화면의 상태 안내 및 접근성 개선

한국어와 영어를 지원하며, Gnuboard7의 기존 인증 및 사용자 기능과 연동합니다.

4. Gnuboard7 공식 확장 구조 활용

Glitter Learning Academy는 Gnuboard7의 사용자 템플릿 구조를 기반으로 개발했습니다.

학습 기능을 템플릿 내부에 중복 구현하지 않고, 필요한 기능을 각 모듈과 플러그인에서 제공받도록 구성했습니다.

주요 구성은 다음과 같습니다.

이러한 구조는 각 확장의 역할을 분리하고, 기존 Gnuboard7 기능을 최대한 활용하기 위한 설계입니다.

5. v1.0.1 주요 개선 사항

이번 v1.0.1은 Glitter Learning Academy의 최초 공개 릴리스입니다.

주요 개선 내용은 다음과 같습니다.

• 모바일 강좌 상세 화면의 콘텐츠 너비 처리 개선
• CKEditor 기반 이미지와 표의 반응형 표시 개선
• 검색 결과 페이지네이션 구현 및 보완
• 검색어와 검색 유형을 유지하는 페이지 이동
• 로딩·빈 결과·API 오류 상태 구분
• 검색 실패 시 재시도 기능
• 한국어·영어 검색 안내 문구 및 접근성 보완

Gnuboard7 공식 템플릿 빌드 및 업데이트 절차를 통해 배포했으며, 전체 27개 레이아웃 검사도 통과했습니다.

다만 모든 브라우저와 검색 오류 시나리오에 대한 검증이 완료되었다는 의미는 아닙니다.

6. 설치 환경 및 의존성

Glitter Learning Academy는 Gnuboard7의 공식 확장 구조를 활용하는 사용자 시드 템플릿입니다.

학습 관리 기능은 Glitter Learning 모듈에서 제공하며, 커뮤니티와 검색 기능은 각각의 독립적인 모듈 및 플러그인과 연동하여 구성합니다.

기본 정보

의존성 및 확장 구성

설치 및 호환성

Glitter Learning Academy를 설치하기 전에 필요한 모듈과 플러그인을 먼저 설치하고 활성화해야 합니다.

각 확장의 정확한 버전 제약과 직접 의존성 여부는 관련 매니페스트를 기준으로 확인해야 합니다.

권장 설치 순서는 다음과 같습니다.

1. Gnuboard7 설치 및 기본 환경 구성
2. 공식 게시판·페이지 모듈 및 CKEditor 5 플러그인 설치
3. Glitter Learning LMS 설치 및 활성화
4. HelpComm 게시판 초기화 도우미와 Glitter Search Hub 설치 및 활성화
5. Glitter Learning Academy 템플릿 설치 및 활성화

기존 사이트에 설치하거나 업데이트하는 경우 데이터베이스 및 관련 파일을 미리 백업하는 것을 권장합니다.

템플릿의 설치와 업데이트는 Gnuboard7의 공식 템플릿 생명주기를 이용해야 합니다.

7. 관리자 페이지에서 설치

먼저 필요한 모듈과 플러그인을 설치하고 활성화합니다.

sirsoft-board

GnuBoard7에서 제공되는 sirsoft-board >=1.2.1이 설치 및 활성화되어 있어야 합니다.

sirsoft-page

GnuBoard7에서 제공되는 sirsoft-page >=1.2.1이 설치 및 활성화되어 있어야 합니다.

CKEditor 5 WYSIWYG 에디터

GnuBoard7에서 제공되는 sirsoft-ckeditor5 >=1.1.1이 설치 및 활성화되어 있어야 합니다.

Glitter Learning

관리자 → 모듈 관리 → 수동 설치 → GitHub

https://github.com/glitter-node/glitter-learning

최소 요구 버전은 >=1.2.13입니다.

HelpComm 게시판 초기화 도우미

관리자 → 모듈 관리 → 수동 설치 → GitHub

https://github.com/glitter-node/glitter-help_comm_installer

최소 요구 버전은 >=0.1.1입니다.

Glitter Search Hub

관리자 → 모듈 관리 → 수동 설치 → GitHub

https://github.com/glitter-node/glitter-search_hub

최소 요구 버전은 >=0.1.7입니다.

Glitter Learning Academy

관리자 → 템플릿 관리 → 수동 설치 → GitHub

아래 저장소 URL을 입력합니다.

https://github.com/glitter-node/glitter-learning_academy

설치 완료 후 Glitter Learning Academy 템플릿을 활성화합니다.

ZIP 패키지 설치

각각의 모듈과 플러그인, 템플릿 Release ZIP 패키지를 다운로드한 후,

관리자 → 모듈/플러그인/템플릿 관리 → 수동 설치 → 파일 업로드

아래 경로를 통해 다운로드/설치할 수도 있습니다.

Glitter Learning
HelpComm 게시판 초기화 도우미
Glitter Search Hub
Glitter Learning Academy

설치 후 캐시 관련 문제가 발생하는 경우

템플릿 업데이트 후 public template config가 이전 버전을 반환하는 cache stale 현상이 일부 G7 환경에서 관찰된 바 있습니다.

이 경우 관리자 캐시 삭제 또는 해당 G7 환경의 template cache 상태를 확인하십시오.

8. 마치며

Glitter Learning Academy는 Gnuboard7에 새로운 학습 관리 기능을 중복해서 구현하는 대신, Glitter Learning 모듈이 제공하는 학습 기능을 실제 서비스 화면으로 연결하는 데 중점을 두었습니다.

강좌를 관리하는 시스템과 학습자가 이용하는 화면을 분리함으로써 각각의 확장을 독립적으로 유지하면서도 하나의 학습 서비스를 구성할 수 있도록 했습니다.

Glitter Learning과 Glitter Learning Academy가 Gnuboard7을 기반으로 교육 콘텐츠를 운영하려는 사용자에게 실용적인 출발점이 되기를 바랍니다.

소스 코드는 MIT 라이선스로 공개합니다.