Mublo Framework v1.2.0 을 릴리즈했습니다. 이번 버전은 모바일 글쓰기 경험 개선, 전환 통계의 구조 개편, 그리고 확장 API(이벤트) 경계 정리가 중심입니다. 데이터베이스 마이그레이션은 없습니다.

새로워진 것

• 에디터 — 모바일 툴바 별도 구성: data-toolbar-mobile · data-toolbar-items-mobile · data-toolbar-breakpoint 속성으로 좁은 화면용 툴바를 따로 지정할 수 있습니다. 기본·갤러리 글쓰기 스킨은 768px 이하에서 필수 편집 버튼만 표시합니다.
• 에디터 — compact 툴바 프리셋 추가: 되돌리기 · 되돌리기 취소 · 굵게 · 기울임 · 밑줄 · 링크 · 이미지 7개 버튼으로, 기존 minimal(3개)과 basic(20개) 사이를 채웁니다. 320px 폭에서 한 줄에 들어갑니다.
• 관리자 — 확장 업로드 사전 점검: 업로드 모달이 열릴 때 plugins/ · packages/ 에 실제로 쓸 수 있는지 미리 확인합니다. 쓸 수 없으면 그 자리에서 원인과 해법을 안내하므로, zip 을 고르고 업로드를 누른 뒤에야 실패를 알게 되던 흐름이 사라집니다.
• 개발 도구 — 이벤트 payload 검사: 이벤트가 코어 내부 타입을 반환해 확장이 몰래 결합되는 것을 양쪽(생산자 composer check-event-payload, 소비자 check-extension-api)에서 검사합니다.
• Core — 이벤트 스칼라 접근자 추가: MemberUpdatedEvent::getPreviousLevelValue(), DomainDeletedEvent::getDomainName(), DomainUpdatedEvent::getPreviousValues(), BlockPageRenderingEvent 의 페이지 접근자 5종. 아래 "호환성 주의"에서 제거된 엔티티 게터를 대체합니다.

바뀐 것

• VisitorStats — 전환 통계 개편: 폼 확장의 테이블을 직접 읽던 구조를 걷어내고, ConversionRecordedEvent 로 통보된 전환만 집계합니다. "폼별 전환"이 "소스별 전환"으로 바뀌어 주문 · 상담 · 가입 · 폼 접수가 한 화면에서 같은 축으로 보입니다.
• 관리자 — 확장 업로드 결과를 확인 모달로: 설치 결과(서명 확인 여부, 활성화 방법)를 읽기 전에 새로고침으로 잘리던 문제가 사라졌습니다.

호환성 주의 (커스텀 확장 개발자)

번들 확장은 모두 대응되어 있습니다. 직접 만든 확장이 있다면 아래를 확인하세요.

• 이벤트의 엔티티 게터 10개 제거: 회원 이벤트 7종의 getMember(), DomainDeletedEvent::getDeletedDomain(), DomainUpdatedEvent::getPreviousDomain(), BlockPageRenderingEvent::getPage(). 회원 정보는 MemberQueryInterface 로 조회하고, 도메인 · 블록 페이지 값은 새 스칼라 접근자를 사용하세요.
• VisitorStats 관리자 API 변경: /api/conversion-stats 는 byForm · topForm 대신 bySource · topSource 를 돌려주고, /api/conversions 는 요청 필드가 form_id → source_type 으로 바뀌었습니다. /api/form-conversions · /api/event-conversions 는 제거되었습니다.

고친 것

• Shop — 등급 변경 쿠폰 오발행 수정: 등급 쿠폰(LEVEL 트리거)이 변경 전 등급으로 발행 대상을 판정해, 승급한 회원이 쿠폰을 못 받고 강등된 회원이 상위 쿠폰을 받던 문제를 수정했습니다.
• 관리자 — 확장 업로드 오류 메시지 구분: 디렉토리 부재까지 "쓰기 권한이 없습니다"로 표시하던 문제를 수정했습니다.

업그레이드 방법

새로 설치: MubloFramework-v1.2.0.zip (vendor 포함 배포본) 을 받아 설치하면 됩니다.

v1.1.0 에서 업그레이드: 패치 zip(mublo-1.1.0-to-1.2.0-patch.zip, 변경 파일 60개)을 설치 루트에 덮어쓰고, 아래 파일 1개를 삭제하면 끝입니다.

plugins/VisitorStats/Repository/ConversionRepository.php

이번 릴리즈는 마이그레이션이 없고 composer 의존성 변경도 없으므로 vendor 디렉토리는 건드리지 않아도 됩니다. 자세한 절차는 패치 zip 안의 PATCH-NOTES.txt 를 참고하세요.

v1.1.0 미만에서 올라오는 경우에는 먼저 v1.1.0 업그레이드 절차(마이그레이션 포함)를 완료한 뒤 이 패치를 적용하세요.

상세 변경 내역

• 전체 코드 변경 비교 (v1.1.0 → v1.2.0, 파일 단위 diff): github.com/wwiz-mublo/mublo/compare/v1.1.0...v1.2.0
• CHANGELOG: CHANGELOG.md 의 [1.2.0] 섹션

이번 릴리즈에 포함된 PR 목록입니다. 각 링크에서 해당 변경의 코드와 논의를 볼 수 있습니다.

• #24 — 에디터: 반응형 툴바와 compact 프리셋 추가
• #25 — Core: 코어가 확장 테이블·카테고리를 직접 알던 결합 제거
• #26 — VisitorStats: 전환 통계가 폼 확장 테이블을 직접 읽던 결합 제거
• #27 — Shop: 등급 쿠폰이 변경 전 등급으로 발행 대상을 판정하던 문제 수정
• #28 — Core: 이벤트 반환값으로 새던 내부 엔티티 의존 제거
• #29 — Core: 이벤트 payload 동결분을 0건으로 정리
• #30 — 개발 도구: 패키지 테스트 수집을 와일드카드로 변경
• #32 — 관리자: 확장 업로드 쓰기 권한 사전 확인