Mublo Framework v1.11.0 릴리즈 — 주문 정보 수정·상품 복사, 도메인 DNS 설정 안내

wwiz 2026-11-18 10:15 조회 16 수정됨

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

이번 릴리즈의 중심은 쇼핑몰 관리 기능입니다. 주문 상세에서 주문인 정보와 배송지를 고칠 수 있고, 상품을 복사할 수 있습니다. 분류마다 상품 목록 위에 안내 이미지를 붙일 수 있고, 주문 목록과 엑셀에 회원 아이디가 나옵니다. 사이트 관리 쪽에서는 도메인 수정 화면이 DNS를 어떻게 설정하라고 안내해 주고, 최고관리자는 아직 DNS가 연결되지 않은 주소도 별칭으로 먼저 등록해 둘 수 있습니다.

쇼핑몰 등급별 포인트·할인·적립 설정이 저장되지 않던 문제를 고쳤습니다. 회원 등급을 쓰는 쇼핑몰이라면 업데이트 후 이 값을 다시 입력해 저장해 주세요.

데이터베이스 마이그레이션이 2건 있습니다(Shop 043·044). 삭제할 파일은 없습니다. 라우트 캐시도 비워야 합니다. 아래 업그레이드 항목을 먼저 읽어 주세요.


주문인·배송지 정보 수정

관리자 주문 상세의 주문인 정보·배송 정보 카드에 수정 버튼이 생겼습니다. 주문인(이름·휴대폰·이메일)과 배송지(수령인·연락처·우편번호·주소·상세주소·주문 메모)를 고칠 수 있습니다.

  • 암호화와 검색 인덱스는 주문을 만들 때와 같은 방식으로 다시 만듭니다. 고친 뒤에도 주문 검색에 잘 잡힙니다.
  • 무엇을 바꿨는지 주문 이력에 "정보 수정"으로 남깁니다. 바뀌기 전과 후의 값은 일부를 가려서 기록합니다.
  • 송장이 이미 등록된 주문이면 수정 창에 발송 안내를 띄웁니다. 배송지를 바꿔도 배송비는 다시 계산하지 않고, 회원의 기본 배송지도 바꾸지 않습니다.

상품 복사

관리자 상품 목록과 상품 수정 화면에서 상품을 복사할 수 있습니다.

  • 상품 정보·이미지·옵션·옵션 조합·상세 설명·상품정보제공고시를 복제합니다.
  • 복사본은 상품명 뒤에 " (복사)"가 붙고 판매 중지 상태로 만들어집니다. 복사가 끝나면 복사본의 수정 화면으로 이동합니다.
  • 후기·문의·찜·주문은 복제하지 않습니다. 이미지 파일은 새로 만들지 않고 원본과 같은 파일을 씁니다.

쇼핑몰의 다른 새 기능

  • 분류별 목록 안내 이미지: 분류 편집 창에서 "목록 안내 이미지"(PC 이미지, 선택 모바일 이미지, 선택 링크)를 넣으면, 그 분류의 상품 목록에서 분류 탭 바로 아래, 상품 목록 위에 보여 줍니다. 하위 분류에 이미지를 따로 넣지 않으면 가장 가까운 상위 분류의 이미지를 씁니다. 상품 상세·주문 화면과 전체 상품·검색 목록에는 나오지 않습니다.
  • 주문 목록·엑셀에 회원 아이디: 관리자 주문 목록의 주문인 칸에 회원 아이디를 함께 보여 줍니다. 주문 엑셀에도 "회원 아이디" 칼럼이 생겼고, 엑셀 칼럼 선택 창에서 기본으로 체크됩니다. 비회원 주문이나 찾을 수 없는 회원이면 빈칸입니다.

도메인 DNS 설정 안내

관리자 → 도메인 수정 화면의 주소 변경·별칭 카드에, 도메인 DNS를 무엇으로 설정해야 하는지(이 서버의 IP)가 나옵니다. DNS 확인을 누르면 레코드마다 호스트·유형·넣을 값·지금 값·상태를 표로 보여 줍니다.

  • 루트 도메인은 @와 www를, 하위 도메인은 그 이름을 안내합니다.
  • Cloudflare 네임서버를 쓰는 도메인이면 Cloudflare 대시보드에서 설정하는 방법도 함께 안내합니다.
  • 최고관리자는 DNS 확인에 실패한 주소도 확인 없이 추가로 별칭에 미리 등록할 수 있습니다. DNS를 옮기기 전에 사이트를 먼저 준비해 둘 때 씁니다. 중복·형식 검사는 그대로 하고, 그 주소를 대표 주소로 지정할 때는 DNS를 다시 확인합니다. 하위 사이트 소유자는 지금처럼 DNS 확인을 통과해야 추가할 수 있습니다.

안내에 쓰는 서버 IP는 .env 의 DOMAIN_DNS_A 로 정합니다. 비워 두면 지금 접속한 관리자 주소의 IP를 씁니다. 관리자 주소가 Cloudflare 프록시 뒤에 있다면 자동으로 잡힌 값이 Cloudflare IP가 되므로, DOMAIN_DNS_A 에 서버의 실제 IP를 꼭 적어 주세요. 하위 도메인을 CNAME으로 안내하려면 DOMAIN_DNS_CNAME 을 씁니다. 두 값의 설명은 새 .env.example 에 있습니다.


배너 슬라이드 화살표·인디케이터

배너 블록 설정에 있던 "좌우 화살표 표시"·"페이지 인디케이터 표시"를 basic 스킨이 이제 따릅니다. 슬라이드 출력에 배너가 2장 이상이면 이미지 좌우 가운데에 이전/다음 버튼이, 아래에 점 인디케이터가 나옵니다.

지금까지 이 두 설정은 저장만 되고 화면에 쓰이지 않았습니다. 이미 만들어 둔 블록은 갑자기 화살표가 생기지 않습니다 — 값이 없는 블록은 계속 표시하지 않고, 설정 폼의 기본값도 꺼짐으로 맞췄습니다. 보이게 하려면 블록 설정에서 체크해 저장하세요.


고친 것

  • 등급별 포인트·할인·적립 설정 저장: 쇼핑몰 설정의 회원 등급별 포인트 사용 한도(최소·최대)와 등급별 할인·적립 값이 "저장되었습니다"가 떠도 실제로는 버려지고 있었습니다. 그래서 등급이 있는 사이트에서는 최대 사용 포인트가 기본값 30,000으로 고정돼 있었습니다. 이제 저장됩니다. 지금까지 한 번도 저장된 적이 없으므로, 업데이트 후 등급별 값을 다시 입력해 저장해 주세요.
  • 재고 차감 기록: 재고 차감을 주문 이력에 기록할 때, DB 설정에 따라(엄격 모드) 기록이 실패할 수 있었습니다. 마이그레이션 043 에서 함께 바로잡았습니다.

업그레이드

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

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

  • Shop 043_shop_order_info_change_log.sql: 주문 이력에 정보 수정·재고 유형과 상세 칼럼 추가
  • Shop 044_shop_category_list_banner.sql: 분류의 목록 안내 이미지 칼럼

실행하기 전에는 분류 저장과 주문인·배송지 수정이 실패합니다.

★ 라우트 캐시를 비워야 합니다. storage/cache/routes 안의 파일을 지우세요. 상품 복사·주문 정보 수정·분류 안내 이미지 업로드 주소가 새로 생겨, 비우지 않으면 404가 납니다.

★ 쇼핑몰 등급별 값을 다시 저장하세요. 회원 등급을 쓰는 쇼핑몰이라면 쇼핑몰 설정에서 등급별 포인트 사용 한도와 할인·적립 값을 입력하고 저장해 주세요.

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

프론트 스킨 basic 파일이 바뀌었습니다 — Shop 상품 목록(views/Front/Product/basic/List.php 와 product-list.css), 배너 블록 basic 스킨(basic.php·style.css)입니다. 이 파일을 복사해 고쳐 쓰고 계시다면 두 가지를 다 알아 두세요. 덮어쓰면 고친 내용이 사라집니다. 덮어쓰지 않으면 분류 안내 이미지와 배너 화살표·인디케이터가 그 스킨에 나오지 않습니다. 차이를 직접 옮겨 주세요.

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


확장을 직접 만드셨다면

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

  • Request::isCloudflareIp() (신규): IP가 Cloudflare 공개 대역에 속하는지 판정합니다.
  • 커스텀 Shop 상품 목록 스킨: $listBanner(pc·mobile·link, 없으면 null)로 분류 안내 이미지를 출력할 수 있습니다. 출력하지 않으면 이미지가 나오지 않을 뿐 다른 동작은 그대로입니다.
  • 커스텀 배너 스킨: 블록 설정의 $contentConfig['show_navigation']·$contentConfig['show_pagination'] 을 읽어 화살표·인디케이터를 그리면 됩니다. 값이 없으면 꺼짐으로 보세요.

상세 변경 내역

포함된 PR: #121 · #122 · #123 · #124 · #125

글쓰기

댓글 0

등록된 댓글이 없습니다.