Skip to content

Glitter Media Manager v1.10.3

Latest
Latest

Choose a tag to compare

View all tags
@glitter-gim glitter-gim released this 17 Oct 05:05
v1.10.3
482379c

그누보드7 미디어 관리 모듈 — 레이아웃 검증 및 활성화 안정화 릴리스

Glitter Media Manager는 게시글 첨부파일에 종속되지 않는 독립적인 미디어 자산 관리 모듈입니다. 사이트 전체에서 이미지와 문서를 검색·분류·재사용할 수 있도록 중앙 미디어 카탈로그, 폴더·태그, 메타데이터, REST API 및 관리자 UI를 제공합니다.

v1.10.3은 관리자 레이아웃의 partial 처리 오류로 모듈 활성화가 실패하던 문제를 수정한 유지보수 릴리스입니다. 신규 기능 추가보다는 기존 기능의 설치·활성화 안정성 개선에 초점을 맞췄습니다.

주요 수정 사항

모듈 활성화 실패 해결

이전 v1.10.2에서는 glitter-media_manager 활성화 과정에서 관리자 레이아웃 검증이 실패하며 HTTP 422 응답이 발생할 수 있었습니다.

  • 대상 레이아웃: admin_media_manager_index.json
  • 대상 partial: partials/admin_media_manager_index/_modal_media_asset_detail
  • 증상: partial include 경로가 허용된 디렉터리 외부라는 오류와 함께 모듈 활성화 실패

원인은 관리자 미디어 자산 상세 모달의 JSON partial은 존재했지만, 레이아웃 소스 선택 과정에서 우선 탐색되는 .g7.html partial이 누락되어 있던 것입니다. 존재하지 않는 우선 후보의 경로 처리 과정에서 실제 JSON partial을 확인하기 전에 검증 오류가 발생했습니다.

v1.10.3에서는 다음과 같이 수정했습니다.

  • 공식 레이아웃 decompiler로 _modal_media_asset_detail.g7.html 소스 추가
  • 대응하는 _modal_media_asset_detail.json을 공식 compiler 출력과 동기화
  • 기존 모달 ID, 구성 요소, 데이터 바인딩 및 closeModal 동작 유지
  • 모듈 메타데이터 버전을 1.10.3으로 갱신

코어의 경로 보안 검증을 완화하거나 변경하지 않았습니다.

검증 결과

다음 항목이 성공적으로 확인되었습니다.

  • 변경 JSON 유효성 검사
  • 레이아웃 compile round-trip 검사: mismatch 0
  • decompile check: 실패 0, 경고 파일 0
  • 전체 대상 레이아웃 검증 통과
  • partial의 실제 경로가 허용된 layouts 디렉터리 내부임을 확인
  • 모달 ID media_asset_detail_modal과 열기 대상의 일치 확인
  • bundled source와 설치본 일치 확인
  • 모듈 업데이트 1.10.2 → 1.10.3 성공
  • 모듈 활성화 및 관리자 레이아웃 등록 성공
  • 서버 내부 LayoutService를 통한 등록 레이아웃 해석 성공
  • 관리자 미디어 관리 페이지 HTTP 200 확인

검증 범위 안내: 인증된 관리자 브라우저에서 실제 미디어 항목을 클릭하여 상세 모달이 열리는 E2E 검증은 수행하지 않았습니다. 따라서 브라우저 상호작용까지 검증 완료된 것으로 간주하지 않습니다.

설치 및 업데이트

GitHub 저장소 설치 (권장)

그누보드7 관리자에서 모듈 관리 → 수동 설치 → GitHub로 이동하여 다음 저장소 URL을 입력합니다.

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

기존 설치 환경에서는 그누보드7이 제공하는 모듈 업데이트 절차로 v1.10.3을 적용한 후 활성화 상태를 확인하십시오.

ZIP 패키지 설치

GitHub Releases에서 해당 버전의 배포 패키지가 제공되는 경우, 관리자 모듈 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수 있습니다. Git 태그 생성만으로 ZIP 번들 패키지의 별도 제공 여부가 보장되는 것은 아닙니다.

설치 후 화면 로딩 문제가 발생하면 캐시 상태를 확인하십시오. 운영 캐시 변경은 영향 범위를 검토한 뒤 수행하는 것이 좋습니다.

기술 스택

  • PHP 8.3+ / Laravel 12.x
  • MySQL 계열 데이터베이스
  • React 19 / TypeScript / JSON Layout / Tailwind CSS
  • Vite

프로젝트 링크

이 릴리스 노트는 v1.10.3의 확인된 수정·검증 결과를 바탕으로 작성했습니다. Git 태그 v1.10.3의 푸시는 확인되었지만, GitHub Release 게시 및 별도 배포 패키지 업로드 여부는 여기서 확인하지 않았습니다.

Assets 4
Loading