Mublo Framework v1.10.0 릴리즈 — 쇼핑몰 가상계좌·후기 승인, 국가/도시 방문 통계

wwiz 2026-11-11 09:58 조회 27 수정됨

Mublo Framework v1.10.0 을 릴리즈했습니다.

이번 릴리즈의 중심은 쇼핑몰입니다. PG 가상계좌를 받을 수 있게 됐고, 구매후기를 관리자가 승인한 뒤 공개할 수 있게 됐습니다. 상품 목록에서 가격을 바로 고치고, 주문서의 주문인 칸을 회원 정보로 미리 채웁니다. 방문 통계에는 국가·도시별 통계가 선택 기능으로 들어왔습니다. 결제 플러그인 보안 수정이 있으니 꼭 올려 주세요.

데이터베이스 마이그레이션이 4건 있습니다(Shop 038·039·040, VisitorStats 003). 삭제할 파일은 없습니다. 이번에는 라우트 캐시를 비워야 합니다. 아래 업그레이드 항목을 먼저 읽어주세요.


PG 가상계좌

결제 플러그인이 가상계좌를 발급하면 주문을 주문접수(입금 대기) 로 옮깁니다. 30분 미결제 정리 대상에서 빠지고, 주문 완료·주문 상세 화면의 입금 계좌 안내에 은행·계좌번호·입금 기한이 나옵니다. 입금 통보가 오면 발급 때 기록한 거래번호와 같은 거래만 결제 완료로 바꿉니다.

결제 준비 데이터에는 주문인 이메일도 실려 PG 에 넘어갑니다. 비어 있으면 PG 가 자체 기본값을 씁니다.

가상계좌를 지원하는지는 결제 플러그인마다 다릅니다. 페이앱(PayApp)은 이번 버전에서 가상계좌를 지원하지 않는 것으로 정리했습니다(아래 보안 수정 참고).


구매후기 관리자 승인

쇼핑몰 설정 상세 탭 설정 탭의 "구매후기 → 후기 관리자 승인 후 공개"(기본값 끔)를 켜면, 고객이 쓴 후기를 승인 대기로 저장합니다.

  • 구매후기 관리 목록에 승인 대기 건수·필터·배지가 생기고, 한 건씩 또는 선택해서 승인할 수 있습니다. 공개로 바꿔 저장해도 승인됩니다.
  • 승인 전 후기는 상품 페이지·후기 수·평점에서 빠집니다. 작성자의 "내 후기"에는 "승인 대기"로 나옵니다.
  • 이미 등록된 후기와 관리자가 등록한 후기에는 적용되지 않습니다.

쇼핑몰의 다른 새 기능

  • 상품 목록에서 가격 바로 수정: 관리자 상품 목록의 판매가 칸에 연필 버튼이 생겼습니다. 판매가·원가를 바로 고칠 수 있습니다. 옵션·조합의 추가 금액은 상품 수정 화면에서 고칩니다.
  • "전체" 상품 탭 숨기기: 기본 설정 탭의 "상품 목록 → 전체 상품 탭 보이기"를 끄면 카테고리 메뉴에서 "전체"가 사라지고, /shop 으로 들어오면 첫 번째 대분류로 이동합니다. 검색은 지금처럼 전체 상품에서 찾습니다.
  • 주문인 이메일 필수: 주문서 / 추가 필드 탭(이전 이름 "주문 추가 필드")의 "주문인 이메일 필수"를 켜면 주문서에서 이메일을 꼭 받습니다. 서버에서도 검사합니다.
  • 주문인 정보 자동 채움: 로그인 회원이 주문서를 열면 회원 추가필드의 이름·연락처·이메일로 주문인 칸을 미리 채웁니다. 주문인이 고칠 수 있습니다.

세 설정(전체 탭·이메일 필수·후기 승인)은 모두 해당 마이그레이션을 실행한 뒤에 저장해야 합니다.


국가·도시 방문 통계 (선택 기능)

방문 통계(VisitorStats)가 방문자 IP 로 국가·도시를 기록합니다. 환경 분석에 국가별·도시별 차트가, 실시간 방문 목록에 "지역" 열이 생깁니다.

켜려면 두 가지가 필요합니다.

  1. composer require geoip2/geoip2:^3.3 으로 라이브러리를 설치합니다.
  2. MaxMind 무료 계정으로 GeoLite2-City DB 파일을 받아 storage/geoip/GeoLite2-City.mmdb 에 둡니다. 이 파일은 라이선스상 재배포할 수 없어 배포본에 넣지 않았습니다.

둘 중 하나라도 없으면 지역 값만 비고 나머지 통계는 그대로 쌓입니다. 이전 방문 기록에는 소급되지 않습니다.


그 밖의 새 기능

  • 프론트 기본 화면 모드: 환경 설정 → 테마 설정 → 프론트 화면 모드에서 사이트 기본값을 기기 설정 따름(기본값)·라이트·다크 중에 고릅니다. 방문자가 화면 모드 스위치로 직접 고르면 그쪽이 우선합니다.
  • 회원 추가필드 이미지 미리보기: 관리자 회원 수정 화면에서 파일형 추가필드에 올라온 이미지(jpeg·png·gif·webp)를 썸네일로 보여 줍니다. 누르면 새 탭에서 원본이 열립니다.

보안 수정

  • 페이앱(PayApp) 결제 통보 검증 강화: 설정이 없는 사이트나 연동 정보가 빈 통보를 거부하고, 결제 KEY 의 위변조 방지 해시와 발신 IP 허용목록을 검사할 수 있게 했습니다. 통보마다 페이앱 상태와 주문번호를 다시 대조합니다. 주문에 반영하지 못한 승인 결제, 지원하지 않는 가상계좌 발급, 주문을 찾을 수 없는 입금은 자동 취소를 시도합니다. 통보 로그의 비밀값은 가리고, 관리자 설정 화면에서도 비밀값을 다시 보여 주지 않습니다.
  • 테스트 결제(TestPay) 차단 방식 변경: 예전에는 APP_ENV=production 만 막았습니다. 이제 local·development·dev·testing 에서만 동작합니다. prod·staging·오타·빈 값처럼 알 수 없는 환경에서는 모든 결제를 성공시키는 테스트 게이트웨이를 아예 등록하지 않습니다.
  • 보안 파일 다운로드: 화면에 바로 보여 주는(inline) 주소라도 실제 내용이 jpeg·png·gif·webp 가 아니면 파일 다운로드로 내려보냅니다. SVG·HTML 이 사이트 도메인에서 열리지 않게 했습니다.

그 밖에 고친 것

  • 관리자 접근 권한 저장: 접근 권한 관리에서 1차 메뉴를 고르면 서브메뉴를 불러오지 못해(404) 권한을 저장할 수 없었습니다.
  • 큰 리포트 엑셀 다운로드: 회원 수만 명처럼 행이 많은 리포트를 받으면 메모리가 모자라 파일이 안 받아졌습니다. 이제 행을 받는 대로 파일에 써서, 7만 6천 행 × 20열이 약 6MB 메모리로 끝납니다. 서식·셀 값 처리는 그대로이고, 열 너비는 앞쪽 2,000행을 기준으로 정합니다.

업그레이드

v1.9.0 에서: 패치 zip(mublo-1.9.0-to-1.10.0-patch.zip, 변경 파일 75개)을 설치 루트에 덮어씁니다. 삭제할 파일은 없고, .env 는 덮어쓰지 않습니다. 이번에는 vendor 변경이 없습니다.

★ 마이그레이션을 실행해야 합니다. 덮어쓴 뒤 바로 관리자 → 시스템 관리 → 데이터베이스 마이그레이션에서 미실행 마이그레이션 실행을 누르세요.

  • Shop 038_shop_show_all_products_tab.sql: 전체 상품 탭 설정
  • Shop 039_shop_orderer_email_required.sql: 주문인 이메일 필수 설정
  • Shop 040_shop_review_approval.sql: 후기 승인 설정과 후기의 승인 대기 컬럼
  • VisitorStats 003_add_geo_columns.sql: 국가·도시 컬럼

실행 전에는 새 컬럼이 없어 쇼핑몰 설정 저장이 실패하고, 방문 통계 환경 분석 화면 전체가 열리지 않습니다. GeoIP 를 설정해 둔 상태라면 방문 기록 저장도 실패합니다.

★ 라우트 캐시를 비워야 합니다. storage/cache/routes 안의 파일을 지우세요. 상품 가격 바로 수정과 후기 선택 승인 주소가 새로 생겨, 비우지 않으면 404 가 납니다.

CSS·JS 가 바뀌었습니다. 적용 후 브라우저에서 강력 새로고침(Ctrl+F5)을 해 주세요. 시스템 관리 에서 버전이 1.10.0 인지도 확인하세요.

프론트 스킨 basic 파일이 바뀌었습니다 — Shop 의 주문서, 주문 완료·주문 상세, 상품 목록, 내 후기 화면, 그리고 프론트 프레임의 Head.php 입니다. 이 파일을 복사해 고쳐 쓰신다면 두 가지를 다 알아 두세요. 덮어쓰면 고친 내용이 사라집니다. 덮어쓰지 않으면 이번 기능(전체 탭 숨기기, 이메일 필수 표시, 주문인 자동 채움, 가상계좌 안내, 승인 대기 표시, 기본 화면 모드)이 그 스킨에 적용되지 않습니다. 차이를 직접 옮겨 주세요.

Shop 1.7.0 은 코어 1.10.0 이상이 필요합니다. 번들째 올리면 신경 쓸 일이 없습니다. Shop 만 따로 올리지는 마세요.

v1.9.0 미만에서 올라오는 경우에는 v1.9.0 까지 올린 뒤 이 패치를 적용하거나, 전체 배포본으로 교체하세요.


확장을 직접 만드셨다면

깨지는 계약은 없습니다. 새로 생긴 것과, 커스텀 스킨이 챙겨야 할 것이 있습니다.

  • Contract\Payment\VirtualAccountConsumerInterface · VirtualAccountIssue (신규, 선택): 결제를 받는 패키지가 구현하면 가상계좌 발급 시 주문을 입금 대기로 기록받고, 입금 통보 후에는 기존 verifyPayment 로 결제 완료가 됩니다. 구현하지 않은 패키지는 지금처럼 가상계좌를 받지 않습니다.
  • SecureFileService::parseMetaWithUrl(): 래스터 이미지 메타에 inline 미리보기 주소 preview_url 을 함께 돌려줍니다.
  • 커스텀 Shop 스킨: 상품 목록은 $showAllTab 을 보고 "전체" 링크를 숨겨야 합니다. 주문서는 $ordererEmailRequired 로 필수 표시를 하고, $ordererPrefill(name·phone·email)로 주문인 칸을 채울 수 있습니다. 이메일 필수 검사는 스킨과 무관하게 서버가 합니다.
  • 커스텀 프론트 프레임 스킨: <html data-default-theme> 속성과 Head 의 화면 깜빡임 방지 스크립트를 basic 스킨처럼 맞춰야 기본 화면 모드 설정을 따릅니다.

상세 변경 내역

포함된 PR: #111 · #112 · #113 · #114 · #115 · #116 · #117 · #118 · #119 · #120

글쓰기

댓글 0

등록된 댓글이 없습니다.