Skip to content

7.2.0

Latest

Choose a tag to compare

@HeuJung HeuJung released this 19 Nov 16:49

이번 릴리스는 다양한 호스팅 환경과 엔터프라이즈 운영 대응에 집중했습니다.

관리자 화면에서 버튼 한 번으로 코어를 업데이트할 수 있고, 중간에 실패하면 백업본으로 자동 복구합니다. FTP 만 쓸 수 있거나 서버 예약 실행(크론)·서버 명령(SSH)을 쓸 수 없는 호스팅, 문서 루트를 public 으로 바꿀 수 없는 호스팅에서도 설치하고 운영할 수 있으며, 하위 폴더(https://example.com/g7/) 설치를 지원합니다.

소셜 로그인·회사 계정(SSO) 로그인을 붙일 수 있는 외부 인증 확장점, 운영자가 정하는 회원가입 항목과 표시 이름, 이미지 썸네일 자동 생성, 관리자 화면의 스케줄·큐 관리를 새로 제공합니다. 확장 패키지 서명 확인과 레이아웃 갱신·확장 업데이트 미리보기도 더했습니다.

Added

  • 코어 스케줄 시딩과 개발자 패키지 명령(custom:vendor-bundle·custom:vendor-verify)의 콘솔 안내가 머리말, 결과 줄, 요약까지 사이트 언어(ko·en·ja)로 나옵니다.
  • 최고관리자 비밀번호를 잊었을 때 이메일을 몰라도 서버 터미널에서 재설정할 수 있습니다. php artisan user:reset-password 를 이메일 없이 실행하면 최고관리자 계정을 보여 주고(여럿이면 고르게 함) 확인을 받은 뒤 재설정하며, 그 계정이 차단 같은 상태라 여전히 로그인할 수 없으면 이유도 알려 줍니다. (sir.kr 커뮤니티의 오오소피아 님께서 문의해주셨습니다.)
  • 레이아웃 편집 권한이 있는 관리자에게 보이는 레이아웃 편집 단추를 화면 오른쪽 아래로 옮기고, 글자 없는 아이콘 단추로 바꿨습니다. 환경설정 > 일반 「레이아웃 편집 단추」에서 끌 수 있으며, 저장하면 새로고침 없이 바로 반영됩니다.

레이아웃 보존·업데이트 미리보기

  • 레이아웃 갱신(*:refresh-layout, 관리자 [레이아웃 갱신])과 확장 업데이트를 실행하기 전에 화면별 판정(유지·새 판 적용·병합·삭제 예정)을 미리 볼 수 있습니다. 명령은 --dry-run(--json), 관리자 화면은 갱신·업데이트 창에서 바로 보이며, 화면마다 「새 판 적용」·「내 수정 유지」를 골라(--decisions=<파일>·API decisions) 그대로 실행합니다. 미리보기는 DB·파일·캐시를 바꾸지 않습니다.
  • 확장 업데이트 미리보기(POST /api/admin/{modules|plugins|templates}/{id}/update/preview, CLI *:update --dry-run --json)가 새 판 선언에서 빠져 지워질 메뉴·권한·역할·알림 정의·알림 템플릿(남는 알림의 빠진 발송 수단)·본인확인 정책·스케줄을 운영자 수정본 표시와 함께 보여 줍니다. 업데이트가 돌리지 않는 확장 시더의 기본 데이터 정리는 목록에 넣지 않습니다.
  • 운영자가 고친 화면을 새 판으로 덮어쓰기 직전에 그 판을 레이아웃 버전 이력에 남깁니다 — 버전 이력 화면에서 되돌릴 수 있습니다.
  • 레이아웃 버전 이력과 확장 조각 버전 이력의 목록 응답이 판마다 어디서 왔는지(확장 업데이트·레이아웃 갱신·「새 판 적용」·업그레이드로 덮기 직전에 남긴 운영자 판인지, 병합 결과인지)와 병합 충돌 수를 함께 알려 줍니다. 출처를 적지 않던 예전 판은 출처 없음으로 나옵니다. 레이아웃 편집기 [버전 기록]은 덮기 직전에 남긴 판이 맨 위(최신)에 있어도 [복원]을 보이고, 저장한 사람 없이 동기화가 남긴 판의 저장자를 「시스템」으로 보입니다.
  • 레이아웃·확장 조각·커스텀 번역을 영구 삭제하기 직전, 운영자가 고친 것이면 본문과 최근 버전(최대 50개)을 활동 로그에 남깁니다. 활동 로그 표에서 펼쳐 볼 수 있고, 본문은 저장된 원문 그대로($t: 번역 문구 포함) 보입니다.
  • 새 판 선언에서 빠진 메뉴·권한·역할·알림 정의/템플릿·본인확인 정책·시드 엔티티·스케줄을 지우기 직전, 운영자가 고친 데이터가 있으면 활동 로그에 남깁니다. 운영자가 만든 하위 메뉴는 지우지 않고 최상위로 올립니다.
  • 활동 로그 목록 API 에 deletion_snapshot 파라미터를 더했습니다. 참이면 영구 삭제·선언 정리·커스텀 번역 삭제 직전 기록만 돌려줍니다(목록 행의 snapshot 요약과 같은 판정).
  • 식별자 없이 전체 레이아웃 갱신(template:refresh-layout·module:refresh-layout·plugin:refresh-layout)을 실행해도 확장마다 판정별 화면 수와 운영자 수정과 겹친 화면 목록을 보여 줍니다(낱개 갱신과 같은 꼴).

명령줄 운영·여러 서버 운영

  • 7.1.6 에서 --yes(-y, 확인 질문만 생략)를 받던 명령(core:update, module:·plugin:·template: 의 update·uninstall, language-pack:uninstall, settings:migrate-to-json, search:index, analytics:anonymize·analytics:purge·analytics:purge-extension, hotfix:rollback-stale-files)은 7.2.0 에서도 같은 형태로 받고, 확인 질문이 없는 language-pack:update 도 받게 했습니다. 확장 일괄 갱신 스크립트를 module:update·plugin:update·template:update 와 같은 형태(-y)로 돌려도 언어팩만 「The "-y" option does not exist.」 로 실패하지 않습니다. 7.2.0 에 새로 온 stage:apply-to-live·stage-layouts:reset-from-live 와 core:execute-upgrade-steps 의 --yes 도 -y 로 쓸 수 있습니다. 비대화형 자동화가 확인만 건너뛸 때 --force(같은 판 재적용·다운그레이드 허용·코어 호환 검사 생략·같은 판 스텝 재실행·멈춘 업데이트 정리)를 쓸 필요가 없습니다. --yes 는 미서명 패키지 확인을 대신하지 않습니다(--allow-unsigned).
  • 업그레이드 스텝 실행 대장(upgrade_step_runs)을 두어, 같은 DB 를 쓰는 다른 서버가 이미 끝낸 스텝은 「이미 실행됨」으로 건너뜁니다(관리자 화면 코어 업데이트 포함). 검수 서버에서 같은 판 번호로 다시 배포해 --force 로 돌리면 고친 스텝만 다시 돕니다(docs/extension/upgrade-step-guide.md 「실행 대장」·「내용 지문」).
  • php artisan extension:reset-files-from-bundled — 같은 판인데 파일이 다른 확장·언어팩의 활성 폴더만 번들 내용으로 덮어씁니다(운영자 custom/ 보존, 판 번호·업그레이드 스텝·레이아웃 본문은 그대로, 예전 이름 extension:sync-files). 범위는 docs/extension/extension-update-system.md 「같은 판인데 파일만 다를 때」.
  • php artisan stage:apply-to-live — 검수 서버가 먼저 업데이트해 운영 서버의 업데이트가 「업데이트 없음」으로 끝날 때, 운영 서버에서 파일 맞추기 → 레이아웃 갱신(운영자 수정 유지) → 미뤄 둔 정리를 차례로 실행합니다(검수 서버 데이터는 옮기지 않음, docs/backend/runtime-role.md 「운영 서버 배포 순서」).
  • php artisan g7:migrate-plan — 실행 대기 마이그레이션의 SQL·파괴 여부·출처(core·custom·module:<id>·plugin:<id>)와 새 판의 업그레이드 스텝 목록을 실행 없이 보여 줍니다. 컬럼 삭제·이름 변경·타입 변경·NOT NULL 전환은 미루기 권장으로 표시합니다. 업그레이드 스텝은 describe() 로 설명을 붙일 수 있습니다.
  • php artisan extension:list [--type=…] [--json] — 설치·번들 확장의 상태와 DB·활성 폴더·번들 판을 쓰기 없이 출력합니다(--json 은 schema 1, 설치 전이면 종료 1).
  • php artisan storage:paths [--json] — storage 경로를 운영 데이터·서버별 파일·업데이트 상태·임시 파일로 나눈 목록(config/g7-storage.php)을 보여 줍니다. 백업 대상·서버 간 공유 경로를 정할 때 씁니다. 이름이 시각으로 바뀌는 항목(app/public-storage-broken-* 등)은 접두사로 표시하고, 그 이름으로 시작하는 파일·폴더가 있으면 「있음」으로 보입니다.
  • .env 의 G7_RUNTIME_ROLE=stage 로 같은 DB·캐시를 쓰는 검수 서버를 띄울 수 있습니다. 검수 서버는 스케줄·큐 워커·사이트맵·SEO 캐시·방문 분석을 돌리지 않고 관리자 화면의 확장·코어·언어팩 변경을 막으며, 레이아웃과 코드 범위 캐시를 운영과 따로 둡니다. 확장 업데이트는 업데이트 중 상태를 공유 DB 에 쓰지 않아 운영 화면에서 그 확장이 빠지지 않습니다. 검수 서버는 .env 의 APP_URL 에 자기 주소를 적으면 그 주소가 사이트 주소가 되어(공유 설정의 사이트 URL 이 덮지 않음) 자기 주소로 화면을 엽니다 — 운영 주소로 이동하지 않습니다(docs/backend/runtime-role.md). 검수 서버의 레이아웃 편집기 위에는 「검수용 저장」 안내 띠(layout_editor.chrome.stage_banner)가 보입니다.
  • 검수 서버의 확장 업데이트는 새 판에서 빠진 메뉴·권한·알림 정의 등의 삭제를 미루고, 운영 서버가 php artisan extension:apply-deferred-cleanup 으로 그 순간의 운영 서버 선언 기준으로 실행합니다(배포 뒤 운영 서버에서 생긴 데이터는 지우지 않고, 판 번호가 같아도 운영 서버 파일 내용이 검수 서버와 다르면 기다림). 판 번호를 올리지 않고 코어 선언을 고친 배포는 php artisan core:resync-declarations 로 반영합니다. core:execute-upgrade-steps 에 확인만 넘기는 --yes 를 더했습니다 — 운영 서버 배포는 --force(실행 대장 무시) 대신 이 옵션으로 검수 서버가 이미 끝낸 업그레이드 스텝을 건너뜁니다. 검수 서버 레이아웃은 php artisan stage-layouts:reset-from-live 로 운영 레이아웃으로 덮어씁니다(운영 → 검수 서버 방향만, 검수 서버의 레이아웃 캐시도 함께 비움).
  • 검수 서버(G7_RUNTIME_ROLE=stage)는 모듈·플러그인·템플릿·언어팩의 activate·deactivate·uninstall 명령을 안내 후 종료 코드 1 로 끝냅니다 — 같은 DB 를 쓰므로 검수 서버의 template:activate 가 운영 사이트의 활성 템플릿을 끄고, module:uninstall --delete-data 가 운영 테이블을 지웁니다. 설치·업데이트·레이아웃 갱신·번들 파일 복원·업그레이드 스텝 명령은 그대로 실행합니다(새 확장은 검수 서버에 설치해 시험하고, 켜기·끄기·제거는 운영 서버에서 합니다). 검수 서버의 language-pack:update 는 언어팩 상태를 바꾸지 않고 판과 파일만 새로 해, 업데이트하는 동안 운영 사이트에서 그 언어가 빠지지 않습니다(다국어 DB 항목의 번역 재적용은 운영 서버에서 업데이트할 때 합니다).
  • 같은 DB 를 쓰는 서버들의 코드 판이 다를 때(검수 서버가 새 판을 먼저 받음), 각 서버는 자기 코드에 없는 명령·작업의 스케줄을 실행하지 않고 건너뜁니다 — 실패 이력·오류 로그·실패 알림이 쌓이지 않고, 경고 로그는 하루 한 번만 남깁니다. 판정 자체가 실패하면 건너뛰지 않고 실행합니다.
  • .env 의 G7_SCHEDULER=off 로 그 서버의 스케줄 실행(서버 cron·웹 크론 주소·방문 트리거)을 끌 수 있습니다. 여러 서버가 같은 DB 를 쓸 때 한 대만 스케줄을 돌리게 할 때 씁니다(공유 설정 system.cron_mode 와 별개). 꺼진 서버(검수 서버 포함)의 웹 크론 주소는 그 사실을 알리는 문구로 답합니다 — 「서버 크론 전용」 안내와 구분됩니다.
  • .env 의 G7_PUBLIC_LINK_URL 로 메일·알림·문자의 회원용·관리자용 링크 주소를 정할 수 있습니다 — 공개 주소와 다른 주소로 띄운 서버도 공개 주소로 링크를 보냅니다. 결제·본인인증 콜백 주소와 결제·본인인증 뒤 브라우저가 돌아가는 주소는 사이트 주소 그대로입니다.
  • 점검 모드(php artisan down)에서 비밀 주소(--secret)를 열면 우회 쿠키를 받고 들어갈 수 있습니다. 통과 경로(G7_MAINTENANCE_EXCEPT, * 허용), 허용 IP(G7_MAINTENANCE_ALLOW_IPS, CIDR 허용, 리버스 프록시 뒤에서는 TRUSTED_PROXIES 기준 접속 주소), --retry·--refresh·--status·--redirect 도 반영합니다.
  • 환경설정 > 보안의 「HTTPS 강제 적용」이 실제로 동작합니다(GET 301, 그 밖 308). 프록시 뒤에서는 TRUSTED_PROXIES 가 필요하고, 잠겼을 때는 php artisan settings:set security.force_https false 로 끕니다.
  • 알림 템플릿 받는 사람에 「사이트 관리자 이메일」(환경설정 > 일반의 관리자 이메일, 메일만)을 추가했습니다. 주소가 비어 있으면 보내지 않고 경고 로그를 남깁니다.

확장 개발자 — 운영 훅·도구

  • 훅 core.identity_logs.before_purge — 본인확인 로그를 보관주기로 지우기 직전, 배치마다 로그 ID 로 발화합니다. 로그를 참조하는 자기 테이블은 이 훅에서 지웁니다.
  • 필터 훅 core.settings.filter_system_info_sections — 확장이 관리자 정보 탭에 카드(배지·항목·접는 목록·알림)를 더할 수 있습니다. 형식이 틀린 카드는 빠지고, 확장 하나가 오류를 내도 화면은 열립니다.
  • AbstractPlugin::uninstallData() — 플러그인이 코어 행에 더한 데이터는 「데이터도 함께 삭제」를 고른 제거에서만 이 메서드로 지웁니다.
  • 레이아웃 테이블 이름을 질의에 쓸 때는 App\Support\LayoutTable::name(), 캐시 드라이버는 CacheDriverFactory::core()·::extension() 을 씁니다(검수 서버 테이블·캐시 범위). 실행 역할은 App\Support\RuntimeRole, 바깥으로 나가는 링크 주소는 SiteUrl::forOutboundLinks() 입니다.
  • 업데이트 확인 응답에 GitHub 조회 실패 사유 check_error, 일괄 확인 결과에 failures 가 생깁니다. GithubHelper::fetchLatestRelease() 반환값에 HTTP 상태 status 가 생깁니다. 언어팩 업데이트 확인의 팩별 결과 details[].error 도 실패 응답(요청 한도 초과·인증 실패·서버 오류)을 사유로 싣고, 그 팩의 최신 버전 정보를 덮지 않습니다.

템플릿 환경설정·파비콘

  • 템플릿 설정 화면을 그 템플릿이 공급합니다. 모듈·플러그인처럼 템플릿이 화면 레이아웃(settings/template_settings.g7.html)과 부품 묶음(dist/settings/settings.iife.js·settings.css, 부품 매니페스트 components.settings.json)을 내고, 코어가 관리자 화면에 설치된 템플릿(꺼진 것 포함)의 묶음과 문구({템플릿id}.{묶음})를 싣습니다. 그래서 어느 관리자 템플릿이 켜져 있든 설정 화면이 뜹니다. 켜진 관리자 템플릿은 layouts/overrides/{템플릿id}/template_settings.* 와 부품 overrides 로 그 화면을 덮어쓸 수 있습니다. 관리자 템플릿이 그려 주는 공용 화면은 없습니다 — 화면을 공급하지 않은 템플릿은 목록 「설정」이 잠깁니다.
  • 템플릿 설정에 메뉴 칸(menu)이 생겼습니다. 칸을 선언한 템플릿이 공급한 편집기(번들 sirsoft-basic 은 관리자 메뉴 관리와 같은 끌어서 놓는 트리 + 항목 편집 판)로 운영자가 사용자 화면 메뉴를 2단까지 짜고, 항목마다 보이는 대상(모두·회원만·비회원만·특정 역할)을 정할 수 있습니다. 템플릿은 「게시판 전체」처럼 그 자리에 무엇을 그릴지 아는 자동 항목을 선언할 수 있고, 저장할 때 서버가 구조·깊이·항목 수·주소 안전성을 검사해 잘못된 항목 위치에 오류를 알립니다. 메뉴·목록 칸 항목의 오류 문구는 내부 키 대신 칸 이름과 몇 번째 항목(이름)인지로 말합니다.
  • 템플릿이 자체 환경설정을 가질 수 있습니다. 템플릿에 config/settings/defaults.json 하나만 두면(모듈 설정과 같은 섹션 구조 — 섹션별 기본값·칸 선언·화면 노출) 관리자 > 템플릿 목록 카드의 「설정」에 섹션마다 탭 하나씩(모듈·코어 환경설정과 같은 모양, 저장은 지금 탭만) 설정 화면이 자동으로 열립니다. 칸은 글자·긴 글·숫자·켜기/끄기·선택·색·주소·사이트 안 링크·이메일·언어별 문구·목록(행 추가·삭제·순서)·파일·이미지 13가지이고, 서버가 같은 선언으로 검증합니다(파일 칸은 선언한 형식·크기만 받음). 비밀값 칸은 암호화해 저장하고 화면에는 가려 보이며 공개 설정에 싣지 않습니다. 「기본값으로」로 섹션 또는 전체를 되돌릴 수 있고, 칸 이름을 바꾼 템플릿은 renamed_from 으로 옛 값을 이어받습니다. 화면을 직접 그리려면 settings/template_settings.g7.html 을 두면 되고(그것이 우선, 켜진 관리자 템플릿에 자동 등록되며 레이아웃 편집기로도 고칠 수 있음), 꺼진 템플릿도 미리 설정해 둘 수 있습니다. 보기는 「템플릿 조회」, 저장·되돌리기는 새 권한 「템플릿 설정」(core.templates.settings)이 필요합니다. 활성 템플릿의 공개 설정은 레이아웃에서 {{_global.templateSettings?.섹션?.키}} 로 읽고(engine-v1.94.0), 표준 키 branding.accent·branding.color_scheme_default 는 <html data-g7-accent>·<html data-g7-color-scheme-default> 로 실립니다. 서버 코드는 g7_template_settings(), 명령줄은 settings:get/settings:set --template=<식별자>(파일 칸은 조회만, 비밀값은 파일로만 받고 조회 때 가림)로 다룹니다. 코어·모듈이 이미 가진 값과 이름이 겹치는 칸은 설치 때 경고합니다. 레이아웃 편집기는 템플릿 설정에 연결된 값을 「템플릿 설정에 연결된 값」으로 보이고 직접 바꾸지 않게 합니다. 템플릿 삭제 창에 지워질 설정 폴더 크기와 첨부 수가 보입니다. 설정 화면의 저장은 고른 파일을 먼저 올리고, 하나라도 올리지 못하면 저장하지 않고 그 사유를 남깁니다.
  • 브라우저 탭 아이콘(파비콘)을 설정할 수 있습니다. 환경설정 > 일반 탭에 「파비콘」 칸이 생겼고, 템플릿 설정의 파비콘이 있으면 그것이 우선합니다(사용자 화면은 활성 사용자 템플릿, 관리자 화면은 활성 관리자 템플릿 기준). 둘 다 비우면 기본 그누보드7 아이콘이 나옵니다. ICO·PNG·SVG·GIF·JPG·WEBP 를 1MB 까지 받으며, SVG 는 스크립트·외부 참조가 없는 안전한 파일만 받습니다. 일반 탭 파비콘 칸 아래에 「현재 ○○ 템플릿 설정의 파비콘이 우선 적용됩니다」 안내와 템플릿 설정으로 가는 버튼이 나옵니다. 오류·점검·DB 접속 오류 화면과 설치 마법사에도 기본 아이콘이 나옵니다. 탭 아이콘은 저장 뒤 다음 화면부터 바뀝니다.

개발자 화면 자리(custom 예약 자리)

  • 그누보드7 화면 대신 개발자가 직접 만든 화면(Blade·HTML+jQuery·외부 프레임워크)을 쓸 수 있는 예약 자리를 마련했습니다 — routes/custom.php·app/Custom·resources/views/custom·public/custom·lang/custom·config/custom.php·database/migrations/custom·custom/. 코어 업데이트는 이 자리를 덮지도 지우지도 않으며, 업데이트 패키지에 이 자리의 파일이 들어 있으면 시작 전에 멈춥니다(G7_UPDATE_RESERVED_PATHS 로 목록 조정). 사용법은 docs/custom-development.md 에 정리했습니다.
  • routes/custom.php 에 등록한 주소는 그누보드7 화면보다 먼저 처리되고, 등록하지 않은 주소는 그누보드7 화면이 그대로 그립니다. 코어 API·확장 자산·빌드·설치기·개발 대시보드·사이트맵 주소(/api·/plugins·/modules·/build·/storage·/install·/dev·/sitemap.xml)와 정적 파일 확장자 주소는 등록되지 않고 경고로 남습니다. 사용자 템플릿이 없어도 동작합니다. 끝·연속 슬래시가 붙은 주소(/hello/·/hello//sub)는 그누보드7 화면과 같이 정규형으로 301 이동합니다(GET·HEAD).
  • 개발자 화면용 미들웨어 custom.auth(회원만)·custom.admin(관리자만)과, 로그인한 회원을 알려 주는 ScreenAuth::user(), 같은 서버 안에서 코어·확장 API 를 그 회원 자격으로 부르는 InternalApiClient 를 추가했습니다.
  • resources/views/custom 아래 .html 파일을 뷰로 쓸 수 있습니다(서버가 파일 그대로 내보냄). lang/custom 은 custom:: 번역, database/migrations/custom 은 마이그레이션 경로로 읽히고, App\Custom\CustomServiceProvider 가 있으면 마지막에 등록됩니다.
  • 개발자 전용 Composer 자리 custom/composer.json 을 추가했습니다. 코어 업데이트 전에 개발자 패키지가 새 코어 패키지와 맞지 않으면(요구 버전 불만족, 같은 패키지 다른 버전) 업데이트를 시작하지 않고 표로 알려 주며, 관리자 업데이트 확인 창에도 같은 표와 해결 순서가 보입니다. Composer 가 없는 서버는 php artisan custom:vendor-bundle 로 만든 custom/vendor-bundle.zip 을 설치기와 업데이트가 풀어 줍니다(custom:vendor-verify 로 무결성 확인).
  • php artisan custom:check 로 예약 자리 현황·등록된 개발자 주소·거부된 주소·개발자 패키지와 코어 충돌을 확인합니다(개발 대시보드에도 단추를 두었습니다).
  • php artisan custom:example board 로 게시판 목록·글보기(Blade), HTML+jQuery 로그인·목록, 관리자 화면 견본을 예약 자리에 만듭니다. 이미 있는 파일은 덮지 않고 멈춥니다.

외부 화면 지원

  • 환경설정 → 일반 탭에 「사용자 화면 URL」을 추가했습니다. 회원 화면을 다른 주소(Next.js 등)가 그릴 때 그 주소를 적으면 알림 메일의 링크, 비밀번호 재설정 링크, 메일 본인인증 링크, 결제 성공·실패 복귀, 본인인증 복귀, 사이트맵 주소가 그 주소 기준으로 만들어집니다. 비워 두면 종전처럼 사이트 주소를 씁니다.
  • 서버가 만드는 화면 링크마다 화면 키(auth.reset_password·board.post·ecommerce.product 등)를 두고, 필터 훅 core.screen_url.filter_path 로 경로를 바꿀 수 있게 했습니다.
  • 공개 설정 API GET /api/frontend-config(사용자)·GET /api/admin/frontend-config(관리자)를 추가했습니다. 그누보드7 화면이 받는 설정(window.G7Config)과 같은 값을 외부 화면이 JSON 으로 받습니다.

스케줄 관리

  • 관리자 > 스케줄 관리 화면을 정식으로 제공합니다. 코어·모듈·플러그인이 등록한 예약 작업과 운영자가 직접 등록한 작업을 한 화면에서 보고, 실행 주기·활성 여부·중복 실행 방지 시간 등을 바꾸고, 바로 실행할 수 있습니다. 검색 대상·소유(코어/모듈/플러그인/직접 등록)·유형·상태·최근 결과·실행 방식 등으로 걸러 볼 수 있습니다.
  • 모든 예약 작업을 데이터베이스에 등록된 목록 기준으로 실행합니다. 지금까지는 관리자 화면에서 직접 등록한 작업이 「즉시 실행」으로만 돌고 정해진 주기에는 실행되지 않았는데, 이제 주기에 맞춰 실행됩니다. 코어와 설치된 확장이 선언한 작업은 설치·업데이트 때 자동으로 등록되며, 운영자가 편집 창에서 실제로 바꾼 값만 확장을 업데이트해도 유지됩니다(손대지 않은 제한 시간과 실행 시각은 확장의 선언을 계속 따르고, 운영자가 직접 등록한 작업에는 「운영자 수정됨」 표시가 붙지 않습니다). 확장을 데이터와 함께 제거하면 그 확장의 작업도 함께 정리되고, 비활성화한 확장의 작업은 실행되지 않습니다.
  • 예약 작업마다 스케줄러 안에서 바로 실행할지, 큐로 보내 워커가 처리하게 할지 고를 수 있습니다.
  • 큐로 보내는 예약 작업의 「즉시 실행」이 워커에서 거절되면(앞선 실행이 아직 끝나지 않음, 실행 잠금 저장소 오류, 소유 확장 비활성) 실행 이력에 「거절됨」 줄과 사유, 누른 관리자가 남습니다. 요청은 「큐에 넣었습니다」로 이미 끝나 있어 지금까지는 거절을 로그로만 알 수 있었습니다. 거절은 실행이 아니므로 실패 알림이 나가지 않고 「마지막 실행」 결과도 바뀌지 않습니다. 실행 이력 응답에 reject_reason, reject_reason_label 이 추가되고 status 에 rejected 값이 생깁니다(schedule_histories.status 값 추가, reject_reason 칸 추가).
  • 「30초마다」 실행 주기와, 성공한 실행은 이력에 남기지 않는 「실패만 기록」 옵션을 추가했습니다.
  • 스케줄러가 최근에 돌았는지 보여 주는 상태 카드를 추가했습니다. 3분 넘게 소식이 없으면 크론 설정을 확인하라고 안내합니다.
  • 예약 작업이 실패하면 관리자에게 메일과 사이트 알림으로 알려 줍니다(같은 작업은 하루 한 번). 환경설정 > 알림 정의에서 끌 수 있습니다.
  • 예약 작업 이름과 설명을 언어별로 입력할 수 있습니다. 일본어 이름은 언어팩으로 제공됩니다.
  • 스케줄 관리 화면의 「보안 정책」에서 예약 실행이 허용·거부된 명령, Shell 실행 여부, 허용된 작업 클래스를 읽기 전용으로 확인할 수 있습니다. 서버 관리자는 storage/app/schedule_security.json 에 허용 명령·옵션·작업 클래스와 거부 명령을 더할 수 있으며(코어 거부 목록은 풀 수 없음), 이 파일은 코어 업데이트 때 보존됩니다. Shell 유형은 서버 .env 의 SCHEDULE_SHELL_ENABLED·SCHEDULE_SHELL_ALLOWED_BINARIES 로만 켤 수 있으며, .env.example 에 두 항목과 사용법을 안내합니다.

큐 관리

  • 스케줄 관리 > 큐 탭 — 대기 작업·실패 작업·처리 기록을 보고, 실패한 작업을 하나씩 또는 한 번에(최대 100건) 다시 실행하거나 삭제할 수 있습니다. 다시 실행할 때 원래 연결이 큐 워커에 등록되어 있지 않으면 기본 연결로, 원래 큐가 등록되어 있지 않으면 그 연결의 기본 큐로 넣습니다. 실패 작업의 시도 횟수는 database 드라이버에서도 처리 기록의 값으로 보이며, 알 수 없으면 「-」로 표시합니다. 「큐 작업 조회」 권한이 없는 관리자에게는 큐 탭이 보이지 않고, 큐 주소로 바로 들어오면 권한 안내가 나옵니다. 큐 현황이나 목록을 불러오지 못하면 「대기 중인 작업이 없습니다」 대신 불러오지 못했다는 안내를 보입니다.
  • 큐 작업 처리 기록 — 작업이 성공했는지 실패했는지를 작업마다 남깁니다. 환경설정 > 드라이버에서 끄거나 보관 기간(기본 7일)을 바꿀 수 있고, 실패 작업도 같은 기간이 지나면 매일 새벽 정리됩니다(queue:prune-records).
  • 큐 탭의 대기·실패·처리 기록 목록을 등록·실패·처리 일시 등으로 정렬할 수 있습니다.

외부 인증 로그인(소셜 로그인 등)

  • 외부 인증으로 본인이 확인된 회원을 비밀번호 로그인과 같은 관문(계정 잠금 → 회원 상태 → 2단계 인증(인증 앱 포함) → 비밀번호 변경 → 휴면 해제)으로 로그인시키는 공개 메서드 AuthService::loginVerifiedUser() 를 추가했습니다. 응답 모양도 비밀번호 로그인과 같습니다.
  • 로그인 인계를 추가했습니다. 확장은 회원을 확인한 뒤 LoginHandoffService::issue() 로 한 번만 쓰는 코드(120초)를 받아 /login?login_handoff={코드} 로 보내고, 로그인 화면이 POST /api/auth/login/handoff 로 바꾸면 2단계 인증·비밀번호 변경·휴면 해제 안내가 비밀번호 로그인과 똑같이 뜹니다. 템플릿 엔진 액션 loginHandoff(engine-v1.92.0)가 이 교환을 합니다. 관리자 로그인도 같은 방식으로 인계합니다(issue($user, $context, 'admin') → /admin/login?login_handoff= → POST /api/auth/admin/login/handoff, engine-v1.93.0).
  • 로그인 완료 훅 core.auth.after_login 의 두 번째 인자에 로그인 수단(login_method — 비밀번호 로그인은 password, 외부 인증은 social:kakao 같은 이름)을 더했습니다. 외부 인증 로그인이 2단계 인증(인증번호 재발송 포함)·비밀번호 변경을 거쳐도 같은 이름이 실립니다.
  • 비밀번호 없는 회원을 지원합니다. 확장은 AuthService::register($data, ['issue_token' => false]) 로 비밀번호·토큰 없이 가입시킬 수 있고(공개 가입 API 는 종전대로 비밀번호 필수), 회원 응답에 비밀번호 설정 여부(has_password)가 실립니다(값은 싣지 않음). 비밀번호 없는 회원은 마이페이지 비밀번호 변경·정보 수정·비밀번호 재설정 메일로 현재 비밀번호 없이 처음 비밀번호를 정합니다. 회원 정보 응답은 비밀번호를 만들 수 있는지(can_set_password, 관리자 회원 상세는 password_status.can_set)와 그 이유, 본인 재확인에 실제로 쓰일 방법(reauth_provider)도 알려 주어, 화면이 저장 전에 미리 안내할 수 있습니다.
  • 비밀번호 확인이 필요한 곳(마이페이지 정보 수정 진입·앱 키 재생성·관리자 본인 정보 수정)에서 비밀번호 없는 회원은 이메일 인증번호로 본인을 확인합니다 — 코어 본인인증(목적 sensitive_action)으로 받은 확인 토큰을 verification_token 으로 보냅니다.
  • 7.1.x 기본 템플릿을 복사해 만든 옛 템플릿에서도 소셜 로그인·회사 계정 로그인이 동작합니다. 그 템플릿의 로그인·가입·관리자 로그인 화면에 확장 단추 자리와 로그인 인계 교환이 없으면 코어가 화면을 내보낼 때 채우고, 정보 수정 진입 확인과 비밀번호 변경 화면에는 비밀번호 없는 회원용 「본인 확인 계속하기」와 첫 설정 안내를 더합니다. 템플릿 파일과 저장된 레이아웃은 바꾸지 않으며, 화면에서 기준 폼을 찾지 못하면 그대로 둡니다(docs/extension/layout-extensions.md 「옛 템플릿 호환 심」).
  • 비밀번호 없는 회원이 7.1.x 기본 템플릿을 복사한 옛 화면에서도 정보 수정 진입 확인·앱 키 재생성·관리자 본인 비밀번호 첫 설정·비밀번호 첫 설정을 마칠 수 있습니다. 옛 화면이 비밀번호 칸에 넣어 보낸 값은 쓰지 않고, 확인 관문은 본인인증 창(이메일 인증번호 등)을 띄운 뒤 원래 요청을 이어서 처리합니다(428, 목적 sensitive_action). 비밀번호 변경·정보 수정은 보낸 현재 비밀번호를 버리고 기존 본인인증 정책으로 확인합니다. 비밀번호 있는 회원과 7.2.0 화면의 동작은 같습니다.
  • 관리자 회원 목록 응답의 열 데이터를 확장이 한 번에 붙이는 필터 훅 core.user.filter_list_rows(페이지 전체 행 + 회원 묶음, 요청당 1회)를 추가했습니다.
  • 회원 응답에 메일 수신 가능 여부(email_deliverable)를 더했습니다. 대체 이메일(…@social.invalid)로 가입한 회원은 false 이고, 사용자 템플릿의 정보 수정 본인 확인·비밀번호 첫 설정 화면은 이 회원에게 메일 인증번호 대신 확장이 주입한 확인 수단(예: 소셜 로그인 플러그인의 「다시 로그인해 확인」)을 보입니다. 이 회원의 본인 확인은 그 회원에게 쓸 수 있는 수단(연결한 회사 계정이나 소셜 계정으로 다시 로그인 등)을 고르고, 휴대폰 본인인증처럼 회원과 연결되지 않은 수단은 운영자가 그 목적에 지정했을 때만 쓰입니다.

외부 인증 확장점(회사 계정 로그인·디렉터리 로그인·인증 프록시 등)

  • 로그인 인계 코드를 발급한 브라우저에 묶습니다. 인계 코드는 그 코드를 받은 브라우저에서만 교환되어, 주소가 새거나 가로채져도 다른 브라우저에서 로그인할 수 없습니다. 확장이 API 응답으로 코드를 줄 때는 LoginHandoffService::issueTicket() 으로 받은 쿠키를 응답에 함께 싣습니다.
  • 로그인 문맥에 세션 수명 상한(max_session_minutes — 사용 중 연장·토큰 갱신도 넘지 못함)과 외부 세션 참조(external_ref)를 더했습니다. 로그인 완료 훅 문맥에 token_id·external_ref 가 실립니다.
  • 외부 인증 확장이 회사 계정 회원의 비밀번호 로그인·재설정·설정을 막을 수 있습니다(필터 core.auth.password_auth_decision). 막힌 회원이 비밀번호로 로그인하면 「이 계정은 비밀번호로 로그인할 수 없습니다」 안내와 그 수단으로 가는 버튼이 보입니다. 확장은 같은 판정으로 2단계 인증을 반드시 거치게 할 수도 있습니다. 재설정 링크 확인(POST /api/auth/validate-reset-token)과 재설정(POST /api/auth/reset-password)도 redirect_prefix=admin 을 받아, 관리자 재설정 화면에서 막힌 계정의 이동 버튼이 관리자 로그인으로 갑니다.
  • 외부 자격 증명 검증자(ExternalCredentialVerifierInterface, 필터 core.auth.registered_credential_verifiers)로 로그인 폼의 아이디·비밀번호를 사이트 밖(사내 디렉터리 등)에서 확인할 수 있습니다. 이런 확장이 켜진 사이트는 로그인 칸에 이메일 대신 사내 아이디를 넣을 수 있습니다.
  • 로그인 화면이 이메일 칸을 벗어날 때 로그인 수단을 묻습니다(POST /api/auth/login/discover·/api/auth/admin/login/discover, 필터 core.auth.login_discovery). 회사 계정 주소면 비밀번호 칸 대신 「회사 계정으로 계속」 버튼이 보입니다. 사이트 전체를 회사 계정 로그인으로 바로 보내는 자동 이동(필터 core.auth.login_auto_redirect)도 받으며, 이때도 ?local=1 로 비밀번호 로그인 화면에 들어갈 수 있습니다.
  • 로그아웃 응답이 확장이 정한 이동 경로(data.redirect_url, 필터 core.auth.logout_redirect_url)를 돌려주면 그 경로로 갑니다(같은 사이트 안 경로만).
  • 회원 칸 잠금(필터 core.user.locked_fields) — 회사가 관리하는 이름·연락처 등은 마이페이지·관리자 화면에서 읽기 전용으로 보이고, 다른 값으로 저장하면 「회사 계정에서 관리하는 항목」 오류가 납니다.
  • 환경설정 > 보안에 「일반 회원가입 받기」를 추가했습니다. 끄면 회원가입 화면이 안내 카드로 바뀌고 가입 링크가 사라지며 공개 가입 API 가 거절됩니다. 관리자 추가와 외부 인증 확장이 만드는 계정은 계속 만들어집니다(필터 core.auth.self_registration_open). 화면 설정에는 이 필터까지 반영한 실효값(appConfig.auth.registration_open)이 따로 실려, 확장이 가입을 닫으면 가입 화면과 링크도 따라 닫힙니다.
  • 관리자 회원 추가에 「비밀번호 없이 만들기(외부 로그인 전용)」를, 회원 상세에 「모든 기기에서 로그아웃」을 추가했습니다(POST /api/admin/users/{user}/sessions/revoke).
  • 확장용 회원 차단·해제(UserService::blockUser()·unblockUser(), 액션 core.user.after_block·after_unblock)와 강제 로그아웃(revokeAllSessions(), 액션 core.user.after_sessions_revoked)을 공개했습니다. 차단은 이미 차단된 회원이어도 남은 로그인을 모두 끊습니다.
  • 확장 내부 가입이 본인인증 정책과 약관 동의 기록을 건너뛸 수 있습니다(register() 옵션 identity_policy => 'skip'(사유 필수, 활동 로그에 남음)·record_consents => false). 공개 가입 API 는 이 옵션을 받지 않습니다.
  • 행위자 없는 시스템 작업(외부 디렉터리 동기화 등)이 본인인증 정책에 막히지 않게 하는 SystemOperation::run() 을 추가했습니다.
  • 본인 재확인 수단을 회원마다 고릅니다. 메일을 받을 수 없는 회원이면 같은 목적의 다음 수단(회사 계정 다시 로그인 등)으로 넘어가고, 화면은 수단을 고정하지 않습니다.
  • 실측·개발용 명령 php artisan auth:handoff-issue {email} --guard=user|admin 을 추가했습니다(운영 환경에서는 거절).

알림 발송 수단

  • 알림에 확장이 템플릿을 준비하지 않은 발송 수단(예: 관리자 알림의 문자, 사이트내 알림만 있던 알림의 메일)을 켜면 그 수단의 빈 템플릿이 만들어져 바로 [편집]에서 제목, 본문, 받는 사람을 채울 수 있습니다. 저장 버튼으로 반영하는 확장 설정 화면과 스위치마다 바로 반영하는 환경설정, 게시판, 이커머스 알림 설정 탭 모두에서 됩니다
  • 새로 만든 빈 템플릿은 꺼진 상태로 시작하고, 받는 사람과 본문을 채우기 전에 켜려 하면 이유를 안내하고 막습니다. 수단을 다시 꺼도 써 둔 내용은 남고, [기본값으로 되돌리기]는 처음 만들었을 때의 빈 상태로 돌립니다
  • 켜기가 거절된 템플릿 스위치는 눌린 모양으로 남지 않고 저장된 상태로 돌아옵니다

확장 개발자

  • 확장 개발자용: 큐 작업에서 요청 문맥을 복원하는 HookContextCapture 에 within()·snapshot()·revert() 를 추가했습니다. 작업이 끝나면 복원한 로그인 사용자·요청·언어를 이전 상태로 되돌리고, 문맥에 사용자가 없으면 로그인 사용자를 비웁니다. 큐 워커는 작업마다 사용자 없이 시작합니다.
  • 확장 개발자용: 자체 템플릿을 쓰는 알림 채널 드라이버는 getDataFor($notifiable) 로 알림 변수의 언어별 값(7.1.5)을 받는 사람 언어로 고른 값으로 받습니다.
  • 확장 개발자용: 업로드 파일의 원래 이름을 읽는 App\Support\UploadedFileName::original() 을 추가했습니다. 브라우저가 파일 이름 속 큰따옴표와 줄바꿈을 %22, %0D, %0A 로 바꿔 보내는 것을 되돌리며, 첨부 이름을 저장하는 확장은 getClientOriginalName() 대신 이 함수를 씁니다.

확장 개발자 — 핸들러·이벤트 소유권

  • 확장·템플릿이 액션 핸들러를 등록하면서 다른 주인의 이름을 덮으면 브라우저 콘솔에 [G7] 경고가 나옵니다(engine-v1.94.0). 엔진이 직접 처리하는 이름(navigate·setState·toast 등 — 등록해도 호출되지 않음), 엔진 기본 핸들러(refresh·refetchDataSource 등), 다른 확장·템플릿이 이미 등록한 이름, 다른 주인의 접두어(예: 플러그인이 sirsoft-basic.x 를 등록)가 대상입니다. 등록 동작은 종전과 같습니다(마지막 등록이 이김). 자기 핸들러는 {자기 식별자}. 접두어로 등록하고 registerHandler(name, fn, { source: 식별자 }) 로 등록자를 밝히세요 — 규칙은 확장 개발 문서 「핸들러 등록」에 정리했습니다.
  • G7Core.componentEvent.off(name, callback) 으로 자기 구독만 해제할 수 있습니다(engine-v1.94.0).

확장 개발자 — 확장 CSS 자기 공급

  • 다크 모드 중립 표식을 추가했습니다. 템플릿이 template.json 의 features.color_scheme 으로 다크 방식({ "strategy": "ancestor-class", "selector": ".dark" }·{ "strategy": "media-query" }·{ "strategy": "none" })을 선언하면, 코어가 <html data-g7-color-scheme="dark|light"> 를 달고 테마가 바뀔 때마다 따라 바꿉니다(engine-v1.94.0). 확장 CSS 는 템플릿의 다크 방식을 몰라도 이 표식만 보면 됩니다. 현재 값은 G7Core.colorScheme.get() 으로 읽고, 레이아웃 편집기 프리뷰 프레임은 프리뷰 테마를, 검색엔진용 화면은 light 를 답니다. 선언하지 않은 템플릿은 none(늘 라이트)으로 봅니다 — 다크 모드가 있는 직접 만든 템플릿은 선언을 더하세요. 번들 템플릿 sirsoft-basic·sirsoft-admin_basic 은 ancestor-class + .dark 를 선언했습니다(2026-10-22 결정 9).
  • 템플릿의 확장 CSS 덮기를 추가했습니다. 템플릿이 template.json 의 extension_css_overrides(target·targetVersion·path)로 확장별 CSS 파일을 선언하면, 대상 확장이 활성이고 버전이 맞을 때만 모든 확장 CSS 뒤·운영자 추가 자산 앞에 싣습니다. 버전이 맞지 않으면 빼고(정보 로그) 확장 원래 모양으로 돌아옵니다. 컴포넌트 대체(overrides)와 같은 관례이며, 검색엔진용 화면도 같은 순서로 싣습니다(2026-10-22 결정 15).
  • 확장 CSS 클래스 앞글자 선언 assets.css.namespace 를 추가했습니다(module.json·plugin.json). 형식은 ^[a-z][a-z0-9]*(-[a-z0-9]+)*$ 이고, 손으로 쓴 CSS 는 {namespace}-…, Tailwind 같은 접두 빌드는 영문 소문자만 남긴 {letters}:… 를 씁니다. assets.css 를 선언한 확장은 namespace 도 선언하며, 다른 확장과 겹칠 수 없습니다. 그누보드7 번들 확장은 CSS 선택자가 자기 앞글자만 쓰는지, 화면이 쓰는 클래스가 자기 CSS 에 실제로 있는지를 소스 단계에서 검사합니다(2026-10-22 결정 10·11). 규약 전문은 확장 개발 문서 「확장 CSS 자기 공급 규약」에 정리했습니다.
  • 확장 레이아웃의 클래스를 자기 앞글자 클래스로 옮기고 필요한 CSS 를 만들어 주는 변환 도구와, 전환 전후 화면 스타일을 비교하는 지문 도구를 scripts/extension-css/ 에 두었습니다(2026-10-22 결정 13).
  • 확장 앞글자 해석 G7Core.style.splitExtensionClassPrefix(token) 을 추가했습니다. ecommerce:md:hidden 을 { prefix: "ecommerce:", rest: "md:hidden" } 으로 나눠, className 을 Tailwind 이름으로 읽는 템플릿 컴포넌트가 확장 클래스를 앞글자 없는 클래스와 같은 뜻으로 다룰 수 있습니다. 앞글자 목록은 활성 확장의 namespace 로 서버가 계산합니다(engine-v1.94.0).

서버 예약 실행(크론)을 걸 수 없는 호스팅

  • 서버에 예약 실행(크론)을 걸 수 없는 호스팅에서도 예약 작업이 동작합니다. 환경설정 > 시스템에서 발급받은 호출 주소를 호스팅 관리자 페이지의 예약 실행이나 외부 예약 서비스에 등록하면, 그 주소를 부를 때마다 밀린 정리 작업·사이트맵 생성 등이 실행됩니다. 호출 주기가 성겨 정해진 시각을 지나쳐도 그 사이에 돌았어야 할 작업을 한 번씩 따라잡아 실행하므로, 하루 한 번 도는 작업이 빠지지 않습니다.
  • 한 번의 호출이 서버의 실행 시간 제한에 걸리지 않도록 작업을 나누어 처리하고, 남은 작업은 다음 호출에서 이어서 실행합니다. 서버 예약 실행과 주소 호출이 함께 걸려 있어도 같은 작업이 겹쳐 돌지 않고, 서버 예약 실행이 이미 돌린 작업을 주소 호출이 다시 실행하지 않습니다.
  • 호출 주소에는 사이트마다 다른 비밀 번호가 들어가며, 허용할 접속 주소를 지정하거나 최소 호출 간격을 두어 과다 호출을 막을 수 있습니다(같은 순간에 도착한 호출도 하나만 실행합니다). 번호는 언제든 재발급할 수 있고, 재발급하면 기존 주소는 즉시 무효가 됩니다. 이 번호는 일반 환경설정 조회로는 볼 수 없으며 환경설정 수정 권한이 있을 때만 확인·복사할 수 있습니다.
  • 예약 실행을 걸 수단이 전혀 없는 사이트를 위해 「방문자 접속 시 실행」을 선택할 수 있습니다. 기본은 꺼져 있으며, 방문자가 없으면 실행되지 않는다는 점을 화면에서 함께 안내합니다.
  • 예약 작업이 며칠째 실행되지 않으면 관리자 대시보드에 경고가 표시됩니다. 서버 예약 실행을 쓰는 사이트에서도 그것이 고장 나면 같은 경고가 뜨며, 조치 안내만 환경에 맞게 달라집니다.
  • 예약 작업이 실행될 때마다 결과가 기록으로 남아 환경설정 > 시스템에서 지난 실행을 되짚어 볼 수 있습니다. 어느 작업이 언제 얼마나 걸려 돌았는지, 실패했다면 그 사유가 무엇인지 확인할 수 있습니다. 실행 시각은 사이트 시간대로(「지금 실행」을 누른 직후의 「마지막 실행」도 같다), 작업은 명령어 원문이나 내부 번호가 아니라 스케줄 관리 화면과 같은 작업 이름(지금 언어)으로 표시되며, 한 번의 실행은 한 줄로 남습니다. 「지금 실행」으로 돌린 작업은 스케줄 관리의 실행 이력에도 「수동 실행」과 누른 관리자로 남고, 실패한 작업은 「마지막 실행」의 실패 수에 들어갑니다. 종전에는 가장 마지막 실행 한 건만 보여 주고 그 앞의 결과는 덮여 사라졌습니다.
  • 대시보드의 예약 미실행 경고에서 설정 화면으로 바로 이동할 수 있고, 경고가 다른 항목과 구분되는 색으로 표시됩니다.
  • 설치 완료 화면이 서버 예약 실행 명령과 함께, 그 명령을 걸 수 없는 호스팅을 위해 환경설정 > 시스템의 「예약 작업」 주소 호출 설정을 안내합니다.

서버 명령(SSH)을 쓸 수 없는 호스팅

  • 환경설정 > 시스템에서 사이트가 서버 명령을 쓸 수 있는지와 그 판정 근거(차단된 함수, PHP 실행 파일 확인 결과)를 확인할 수 있고, 자동 판단 대신 특정 방식으로 고정하거나 그 자리에서 다시 감지할 수 있습니다.
  • 서버 명령을 쓸 수 없는 환경으로 설치하면 알림·백그라운드 작업을 요청 안에서 바로 처리하도록 설정합니다. 처리할 주체가 없어 작업이 쌓이기만 하던 상태가 생기지 않습니다. 확장이 예약한 작업(게시판·쇼핑몰·페이지·에디터의 정리 작업 등)도 서버 명령 없이 그대로 실행되며, 확장 쪽에서 따로 할 일은 없습니다. 알림 발송은 대상 인원과 실제 발송 건수를 기록에 남겨, 서버 시간 제한으로 뒷부분이 누락된 경우를 확인할 수 있습니다. 설치부터 예약 작업 연결·코어 업데이트까지의 절차는 INSTALL.md 「방법 6」에 있으며, 설치 화면의 실행 방식 안내에서 그 문서로 바로 이동할 수 있습니다.
  • 이 방식의 설치는 한 요청이 한 단계씩 처리하는데, 오래 걸리는 단계에서도 화면이 멈춘 것처럼 보이지 않습니다. 지금 도는 단계의 이름과 경과 시간이 초 단위로 표시되고(단계가 바뀌는 순간 새 단계 이름으로 바뀌어 앞 단계 이름이 남지 않습니다), 유난히 오래 걸리는 단계는 진행 기록에도 한 줄 남습니다. 단계가 쏟아내는 상세 기록은 한 줄씩이 아니라 한 번에 모아 그려 그 순간 화면이 굳지 않습니다.
  • 진행 기록이 화면에 무한정 쌓이지 않습니다. 최근 기록만 화면에 남기고 그보다 앞선 줄은 몇 줄이 접혔는지 함께 알리며, 전체 기록은 설치 기록 파일에서 볼 수 있습니다. 설치를 여러 번 재시도해 그 파일이 지나치게 커지면 한 벌을 보관본으로 넘기고 새로 이어 씁니다.
  • 설치 진행 상태는 다른 요청과 겹치는 순간에도 저장됩니다. 저장이 잠깐 부딪히면 곧바로 포기하지 않고 다시 시도하므로, 새로고침해 이어서 설치할 때 이미 끝난 단계부터 다시 시작되지 않습니다.
  • 설치를 중단하면 버튼이 곧바로 「중단 중」으로 바뀌고, 실행 중이던 단계가 끝나기를 기다리는 동안 왜 기다리는지를 진행 기록에 남깁니다. 되돌리기가 실행 중인 단계와 겹치지 않도록 기다리는 것이며, 그 시간이 얼마나 걸릴지는 그 단계의 길이에 달려 있습니다.
  • 디스크 공간 부족처럼 설치가 비정상적으로 멈춘 뒤 다시 시도할 때, 화면이 「다른 창에서 진행 중」이라고만 안내하던 문제를 고쳤습니다. 실제로는 그 창이 없을 수 있습니다 — 이제 남은 대기 시간을 초 단위로 보여 주고 그 시간이 지나면 스스로 이어서 진행합니다. 기다리는 동안 [처음부터 다시] 말고는 할 수 있는 일이 없던 상태가 사라집니다.
  • 설치 상태를 저장하지 못했을 때, 그리고 손상된 상태 파일의 진단용 사본을 남기지 못했을 때 그 사실과 남은 디스크 공간을 함께 기록에 남깁니다. 공간이 부족해 실패한 경우 원인을 바로 알 수 있습니다.
  • 리버스 프록시(CDN·로드밸런서) 뒤에 있는 사이트의 신뢰 범위를 환경설정 > 고급에서 고를 수 있습니다. 종전에는 이 값을 서버 파일(.env)로만 지정할 수 있어, 서버 명령을 쓸 수 없는 호스팅에서는 「설정되지 않았습니다」라는 진단만 보고 아무 조치도 할 수 없었습니다. 신뢰하지 않음 / 직전 프록시만 / 지정한 주소만 중에서 고르며, 지정 목록은 주소를 하나씩 태그로 넣거나 콤마로 구분한 목록을 붙여넣어 채웁니다.
  • 저장하기 전에 [이 값으로 지금 검사] 로 그 값이 어떤 결과를 내는지 확인할 수 있습니다. 방문자 IP 와 HTTPS 인식이 지금 값에서 어떻게 달라지는지 나란히 보여 주므로, 잘못 저장해 관리자 화면에 들어가지 못하게 되는 상황을 미리 피할 수 있습니다.
  • 이미 서버 파일(.env)에 이 값을 넣어 둔 사이트는 화면에 그 값이 그대로 보이며, 업그레이드만으로 설정이 바뀌지 않습니다. 서버 파일을 배포 기준으로 관리하는 설치는 종전처럼 그쪽을 우선하도록 잠글 수 있습니다.
  • 서버 명령 없이(단계별) 설치하는 도중 브라우저를 닫았다면 다른 브라우저에서 복구 토큰으로 소유권을 되찾아 설치를 이어 갈 수 있습니다. 앞 창에서 돌던 단계가 아직 끝나지 않았으면 끝날 때까지 기다렸다가 다음 단계부터 진행하고, 앞 창은 더 이상 설치를 진행하지 못합니다.
  • 설치 중 실패한 선택 확장을 건너뛰는 조작과 설치 소유권 되찾기도 설치를 진행하던 브라우저의 요청으로만 받습니다. 다른 사이트에 심은 자동 제출 폼으로는 부를 수 없고, 설치가 끝난 뒤에는 받지 않습니다.
  • 고유 이름 생성 함수(uniqid)를 막아 둔 호스팅에서도 코어 업데이트 뒤의 번들 확장 일괄 업데이트가 멈추지 않습니다.

문서 루트를 바꿀 수 없는 호스팅·하위 주소 설치

  • 문서 루트를 바꿀 수 없는 호스팅에서도 설치할 수 있습니다. 배포 파일을 문서 루트에 그대로 풀면 프로젝트 폴더가 곧 문서 루트인 배치로 설치가 시작되며, 함께 동봉된 루트 진입 파일과 보호 규칙이 설정 파일·저장소 같은 민감한 경로를 브라우저에서 열리지 않게 막습니다. 코어 업데이트가 이 두 파일을 다른 코어 파일과 함께 갱신하되, 운영자가 보호 규칙에 덧붙인 내용은 그대로 보존합니다. 7.1.x 에서 올리는 업데이트는 이전 판이 파일을 적용해 루트 진입 파일만 놓고 보호 규칙을 빠뜨리므로, 업데이트가 마무리하며 이번 배포본의 보호 규칙을 놓습니다(보호 규칙 파일이 이미 있으면 그대로 둡니다). 웹 서버가 그 보호·위임 규칙을 적용하지 않은 채(Apache 가 .htaccess 를 읽지 않거나 nginx·Caddy 에 설정 조각을 넣지 않은 경우) 설치 화면 주소를 열면, 같은 주소로 끝없이 이동하던 대신 무엇을 고쳐야 하는지 안내합니다. 이 배치에서 프로젝트 폴더 안의 실제 폴더 이름 주소(/docs 등)를 열어도 끝 슬래시 이동이 되풀이되지 않습니다. nginx·Caddy·IIS 용 설정 조각과 설치 안내(INSTALL.md 「방법 7」)를 함께 제공하며, 운영자가 서버 설정 조각을 고쳐 쓴 경우 업데이트가 그 파일을 덮어쓰지 않고 새 판본을 .dist 로 옆에 두고 알려 줍니다.
  • 웹 인스톨러에 「웹 노출 점검」이 추가되었습니다. 설정 파일 등 민감한 파일이 브라우저에서 실제로 열리는지 확인해 노출이 확인되면 설치 진행을 막고, 서버 사정으로 판정할 수 없을 때는 운영자가 직접 열어 확인하는 절차로 안내합니다. 판정할 수 없을 때는 그 사유(요청이 닿지 못함·기준 주소가 열리지 않음·일부 대상을 준비하지 못함)를 구분해 알려 주고, 직접 확인할 때 무엇이 정상인지를 「이 서버에 없는 주소」와 나란히 보여 줍니다 — 문서 루트를 바꿀 수 없는 배치에서는 설치 안내 화면이 뜨는 것이 정상입니다. 확인 결과는 나중에 살펴볼 수 있도록 기록됩니다.
  • public/storage 링크를 만들 수 없는 호스팅에서도 업로드한 공개 파일이 정상적으로 표시됩니다. 링크를 만들 수 없으면 사이트가 그 파일을 대신 내어주며, 캐시·부분 요청 등의 동작은 링크가 있을 때와 같고, 업로드된 HTML·SVG·XML 같은 문서 파일은 사이트 주소에서 페이지로 열지 않고 내려받게 합니다.
  • 사이트를 하위 주소(https://example.com/g7/ 처럼)에 설치할 수 있습니다. 화면 이동·API 호출·화면 구성 파일이 지정한 이미지와 폼 전송 주소·검색 엔진용 화면·편집기·번들 확장(결제·본인인증 포함)이 모두 그 주소 안에서 동작하며(검색엔진에 알리는 홈 주소와 사이트맵은 웹서버 정본과 같은 /g7/ 형태), 인스톨러도 하위 주소를 인식합니다. 한글이나 공백이 든 하위 주소에 프록시를 거쳐 설치해도 인스톨러가 진행되고, 사이트 주소(APP_URL)도 하위 주소까지 저장됩니다.
  • 하위 주소 설치에서 사이트 주소(APP_URL)의 경로가 실제 설치 위치와 다르면, 메일·사이트맵처럼 화면 요청 없이 만드는 주소가 사이트 밖을 가리키므로 요청마다 한 번 오류 로그를 남기고(설치 기본 로그 레벨에서도 기록됩니다), php artisan g7:asset-url-mode 조회 결과에 두 값을 그 출처(콘솔은 .env 의 APP_URL, 사이트 주소는 환경설정 사이트 URL)와 함께 나란히 보여 줍니다. 운영 환경에서 미리 만들어 두는 정적 파일(/build/ext/…)의 주소와 그 실패를 되살리는 주소, 화면 구성 파일이 적은 스크립트 주소(편집기 본체 등)도 설치 폴더 안을 가리켜, 첫 방문 화면이 서식 없이 뜨거나 아이콘과 글꼴이 빠지거나 편집기 화면에 불러오기 실패 띠가 남지 않습니다.
  • IIS 용 루트 web.config 도 .htaccess 와 같은 방식으로 갱신됩니다. 코어가 관리하는 블록만 교체되고, 운영자가 블록 밖에 덧붙인 IIS 설정은 업데이트 후에도 그대로 남습니다.
  • 서버 설정 조각(deploy/)의 보존 기록이 설치·업그레이드 시점에 만들어지고, 운영자가 .dist 로 받은 새 판본을 합치면 다음 업데이트부터 그 조각이 정상적으로 갱신됩니다. 합치던 중인 .dist 는 덮어쓰지 않고 더 새로운 판본을 .dist.new 로 따로 둡니다. 기록을 쓰지 못한 경우에도 업데이트 결과에 그 사실이 안내됩니다.
  • 네 서버 설정(Apache·nginx·Caddy·IIS) 모두 정적 파일 응답에 브라우저가 파일 형식을 추측하지 않도록 하는 헤더를 붙입니다. 업로드 파일을 웹서버가 직접 내어주는 사이트에서도 사이트가 내어줄 때와 같은 보호가 적용됩니다.

FTP 만 쓸 수 있는 호스팅

  • FTP 만 쓸 수 있는 호스팅에서도 설치할 수 있습니다. 배포 압축 파일과 함께 들어 있는 g7-setup.php 하나만 압축 파일 옆에 올린 뒤 브라우저로 열면 서버가 직접 압축을 풉니다. 파일이 많아도 나누어 처리하며 새로고침하거나 브라우저를 닫았다 들어와도 처리한 개수부터 이어서 풀고, 끝나면 압축 파일과 이 파일을 스스로 지웁니다. 서버에 만들어지는 확인 번호 파일을 FTP 로 열어야 진행할 수 있으며, 번호를 여러 번 틀리면 대기 시간이 늘고 번호가 새로 만들어집니다(번호 칸을 비운 채 누르면 틀린 것으로 세지 않고 번호를 넣으라고만 알립니다). Apache 에서는 압축을 푸는 동안 확인 번호 파일과 진행 상태 파일이 브라우저에서 열리지 않게 막습니다. 이미 설치가 끝난 사이트에서는 동작하지 않고, 그누보드7 배포본이 아닌 압축 파일이나 상위 폴더로 빠져나가는 경로가 든 압축 파일은 풀지 않습니다. 코어 업데이트는 이 파일을 만들지도 지우지도 않으므로, 설치를 마치며 사라진 파일이 나중에 업데이트로 되살아나지 않습니다. 7.1.x 에서 올리는 업데이트는 이전 판이 파일을 적용해 설치가 끝난 사이트의 프로젝트 폴더에 이 파일을 놓지만, 업데이트가 마무리하며 지웁니다. 설치 안내는 INSTALL.md 「방법 8」에 있습니다.
  • 폴더·파일 권한이 부족할 때의 안내가 두 벌로 나옵니다. FTP 프로그램에서 권한 값을 바꾸는 절차가 기본으로 펼쳐지고, 명령어 안내는 접힌 채로 함께 제공됩니다. 안내를 내기 전에 사이트가 먼저 권한 변경을 직접 시도하므로 성공하면 안내 자체가 나타나지 않으며, 이미 쓸 수 있는 폴더의 권한은 건드리지 않습니다. 웹 서버가 파일 소유자와 다른 계정으로 도는 호스팅처럼 표준 값(755·644)으로는 쓰기 권한이 생기지 않는 구성에서는 보조 값(707·606)을 함께 안내합니다.

관리자 화면에서 하는 코어 업데이트

  • 관리자 화면에서 버튼만 눌러 코어를 새 버전으로 올릴 수 있습니다. 환경설정에 「업데이트」 탭이 생겼고, 새 버전이 있으면 변경사항을 확인한 뒤 시작할 수 있습니다. 서버 명령(SSH)을 쓸 수 없는 호스팅을 위한 것으로, 종전에는 명령어 안내 문구만 있어 그런 호스팅에서는 코어를 올릴 방법이 없었습니다. 명령어로 올리는 방법은 같은 탭의 「고급」 안에 그대로 남아 있습니다.
  • 업데이트는 여러 단계로 나누어 진행하며 한 요청이 한 단계씩만 처리합니다. 서버의 요청 시간 제한에 걸리지 않고, 새로고침하거나 브라우저를 닫았다 들어와도 진행하던 지점부터 이어집니다. 배포본 압축 풀기, 백업, 적용 대상 산출, 의존성 반영, 번들 확장·언어팩 업데이트, 되돌리기, 마무리 정리와 파일 소유권·권한 복원처럼 오래 걸리는 단계는 여러 요청으로 나눠, 실행 시간이 30~60초인 호스팅에서도 단계마다 요청 시간 제한 안에서 이어 갑니다. 파일 적용, 마이그레이션, 업그레이드 스텝, 배포본 내려받기처럼 나눌 수 없는 단계는 한 요청에서 합니다. 화면은 서버가 그 단계를 마칠 때까지 기다리고, 응답이 끊겨도 서버는 그 단계를 마치며 화면이 상태를 다시 확인해 다음 단계를 부릅니다(진행은 업데이트 화면이 이어 가므로 화면을 닫으면 다시 열 때 이어집니다). 진행 중에는 어느 단계까지 갔는지와 지금 무엇을 하는지가 화면에 표시되고, 자세한 기록도 함께 볼 수 있습니다.
  • 중간에 실패하면 별도 조작 없이 백업본으로 되돌립니다. 단계가 서버 요청 시간 제한으로 끊기면 실패로 기록해 백업본으로 자동 되돌리므로 사이트가 점검 화면에 갇히지 않습니다. 번들 확장·언어팩은 끊긴 항목만 건너뛰고(끊긴 것은 기다리던 요청이라 그 항목이 끝까지 반영될 수 있으므로, 번들 단계 끝에서 실제 판을 확인해 반영됐으면 성공으로 세고, 확인하지 못하면 「업데이트되지 않았다」 대신 완료 여부를 확인하라고 알립니다. 끊긴 항목이 아직 돌고 있으면 그 작업이 끝날 때까지 기다린 뒤 다음 항목·마무리로 넘어가며, 재시작 등으로 사라진 작업은 기다리지 않고, 15분이 지나도 끝나지 않으면 확인 안내를 남기고 이어 갑니다. 사라진 작업이 남긴 그 확장의 「업데이트 중」 상태와 작업 잠금은 정리해, 안내대로 바로 개별 업데이트할 수 있습니다 — 파일을 바꾸기 전이었으면 업데이트 전 상태로, 바꾼 뒤였으면 비활성·「업데이트 있음」으로 둡니다. 기다리던 요청이 살아 있는 동안 그 작업만 비정상으로 끝난 경우도 같게 정리해, 바로 이어 하는 개별 업데이트·코어 업데이트가 10분간 「이미 진행 중」으로 거절되지 않습니다. 그 작업이 잡은 것이 확인된 잠금과 상태만 정리하고, 다른 작업이 진행 중인 확장이나 다른 서버에서 도는 작업은 건드리지 않습니다), 마무리는 같은 자리에서 다시 시도합니다. 마무리의 준비 구간(버전 기록, 캐시)이 계속 끊기면 되돌리고, 백업 정리를 시작한 뒤에는 되돌리지 않고 남은 정리를 건너뛰어 끝냅니다. 되돌리기는 이번 업데이트가 바꾼 파일부터 되돌리며 끊겨도 끝난 구간 다음부터 이어 받고, 파일을 되돌린 뒤의 정리(소유권·권한 복원, 임시 파일)만 요청 시간 안에 끝나지 않으면 그 정리를 건너뛰고 사이트를 엽니다. 실패 사유에는 터미널 색 코드가 섞이지 않습니다. 실패 화면은 「어느 단계에서 왜 실패했는지」와 함께 **「되돌렸으며 사이트는 정상 동작한다」**를 먼저 보여 줍니다. 파일 적용 단계에서 알린 루트 진입·보호 파일과 서버 설정 조각 안내(새 판본을 .dist 로 옆에 두었다 등)는 되돌리면 더는 해당하지 않으므로 「확인이 필요한 사항」에서 빠지고 「되돌리며 해당 없어졌다」는 알림으로 바뀌며, 명령줄 core:update 도 되돌린 뒤 같은 알림을 출력합니다(적용 단계 안내는 한 번만 나오고, 되돌린 뒤의 알림과 실패 문장은 진행 막대 줄에 붙지 않고 제 줄에 나옵니다). 번들 확장 일부가 실패한 뒤 되돌린 경우 그 경고는 「코어는 업데이트 전 판으로 되돌렸고 이미 새 판으로 갱신된 확장은 그대로」로 바뀝니다. 되돌리기까지 실패한 경우에만 수동 복구 절차와 백업 위치·실패 기록 경로를 안내합니다. 복구 절차는 FTP 로 백업본을 되돌리고 점검 모드를 해제하는 방법이 기본이며, 명령어 절차는 「SSH 를 쓸 수 있다면」 조건과 함께 덧붙입니다. 시작 전 쓰기 권한 부족 안내와 점검 모드 해제 실패 안내도 같은 기준을 따릅니다.
  • 시작하기 전에 실제로 바뀔 파일들에 쓸 수 있는지, 백업과 새 버전을 함께 둘 공간이 있는지 미리 확인합니다. 쓸 수 없는 경로가 있으면 그 목록과 함께 업데이트를 시작하지 않고 안내합니다. 권한을 임의로 바꾸거나 파일 소유자를 변경하지는 않습니다. 이 확인은 한 요청 시간 안에서 할 수 있는 만큼 하고(확인하지 못한 경로가 적용 단계에서 막히면 자동으로 되돌립니다), 링크·정션(Windows 의 public\storage 등)은 확인 대상에서 뺍니다.
  • 시작 화면에서 「번들 확장·언어팩 함께 업데이트」(기본 켬)와 「검색 인덱스 다시 만들기」(기본 끔)를 고를 수 있고, 레이아웃을 새 버전으로 덮어쓸지 수정한 것을 보존할지 선택할 수 있습니다. 수정한 레이아웃이 있으면 그 개수와 함께 보존을 권합니다. 이 선택은 그 실행에만 적용되며 설정으로 저장되지 않습니다.
  • 새 버전을 자동으로 내려받을 수 없는 서버(외부 접속 차단)를 위해, 릴리스 압축 파일을 FTP 로 올려 두고 그것을 지정해 업데이트할 수 있습니다. 「고급」 안에 있으며, 이후 과정은 자동 내려받기와 완전히 같습니다.
  • 코어 업데이트를 실행할 수 있는 권한이 설정 수정 권한과 분리되었습니다. 새 권한은 최고관리자에게만 기본 부여되며, 권한이 없는 관리자에게는 업데이트 영역이 비활성이 아니라 보이지 않습니다. 업데이트 실행·성공·실패는 활동 기록에 남습니다.
  • 업데이트 진행 중에는 사이트가 점검 모드로 전환되지만, 관리자는 진행 화면과 실패 시 복구 화면에 계속 접근할 수 있습니다. 진행은 업데이트 화면이 이어 가므로 진행·되돌리기 도중 그 브라우저를 닫으면 다시 열 때까지 멈춰 있습니다 — 같은 브라우저로 돌아오면 이어지고, 다른 브라우저·기기에서는 점검 화면의 관리자 확인 칸에 코어 업데이트 권한이 있는 관리자 계정을 확인하면 관리자 화면에 들어가 업데이트 탭에서 이어 갈 수 있습니다(확인 칸은 관리자 화면 업데이트가 진행·되돌리기·복구 중일 때만 보이고, 시도는 10분에 5회로 제한하며, 틀린 비밀번호는 일반 로그인 실패와 함께 세어 잠긴 계정은 이 칸으로도 들어갈 수 없습니다). 점검 모드를 우회하는 값은 업데이트 기록 파일과 진행 기록에 남기지 않습니다(명령줄 업데이트 포함).
  • 진행 중이던 업데이트는 화면에 다시 들어오면 스스로 이어집니다. 브라우저를 닫았거나 통신이 끊겨도 남은 단계를 자동으로 계속하며, 실패 후의 되돌리기도 같은 방식으로 조작 없이 마무리됩니다.
  • 시작 화면이 「쓸 수 있는지·공간이 있는지」를 누르기 전에 알려 줍니다. 막힌 경로가 있으면 그 목록과 함께 표시되어, 안 되는 서버에서 사이트를 점검 모드로 보낸 뒤에야 알게 되는 일이 없습니다.
  • 새 버전 확인이 실패하면(외부 접속이 막힌 서버) 그 사유가 화면에 남고, 대안인 「고급」의 압축 파일 지정으로 안내합니다.
  • 실패 화면에서 다음에 할 일을 바로 열어 볼 수 있는 [조치 방법 보기]가 제공됩니다.
  • 올릴 새 버전이 없을 때는 시작 버튼과 선택 항목이 나타나지 않습니다. 「최신 버전입니다」 상태에서는 확인 버튼만 보입니다.
  • 설치·업데이트 과정에서 남는 정리 대상을 관리자 화면에서 확인할 수 있습니다. 웹 단계 설치·업데이트가 남기는 자격증명이나 사용자 파일 사본도 정리 대상에 들어가 서버에 영구히 쌓이지 않습니다.
  • 관리자 화면에서 하는 업데이트도 명령줄 업데이트와 같이, 이 사이트가 설치하지 않은 공식 번들 확장은 새 버전 파일을 받지 않고 건너뜁니다. 건너뛴 번들은 확장 목록 안내에서 나중에 배치할 수 있고, 업데이트가 실패해 되돌리면 그 안내도 업데이트 전 상태로 돌아갑니다.
  • 새 버전 배포본이 개발자 화면 자리(custom 예약 자리)에 파일을 싣거나 개발자 패키지가 새 코어와 맞지 않으면, 관리자 화면 업데이트도 아무 파일을 바꾸기 전에 멈추고 그 사유를 업데이트 화면에 남깁니다.
  • 업데이트 시작 요청의 선택 항목 값이 잘못되었을 때 오류 문구가 내부 필드 이름 대신 화면의 항목 이름(레이아웃 처리 방식, 직접 올린 ZIP 파일 등)으로 표시됩니다. 명령줄 업데이트가 확인 목록 앞에 내는 머리말도 사이트 언어로 표시됩니다.

레이아웃 편집기

  • 미리보기 줌 도구에 「실제 크기」 토글을 더했습니다. 켜면 미리보기를 1:1 로 보고, 캔버스보다 넓으면 캔버스 안에서 가로로 스크롤합니다(engine-v1.95.0).
  • 확인 창의 고정 하단 단추(Modal footer)를 편집기에서 고르고, 고치고, 옮기고, 지울 수 있습니다(engine-v1.95.0).
  • 관리자 화면과 사용자 사이트에서 레이아웃 편집 권한이 있는 사람에게 왼쪽 아래 편집 단추를 보입니다. 누르면 보던 화면이 선택된 채 레이아웃 편집기가 열립니다(engine-v1.95.0).
  • 편집기가 편집기 정보를 받지 못하면 알림과 다시 시도 단추를 보입니다(engine-v1.95.0).
  • 편집 모드 레이아웃 응답의 슬롯 자리 노드에 슬롯 이름 __slot 이 실립니다 — 꾸밈 자리가 둘 이상인 레이아웃(홈·게시판 목록·쇼핑 목록·상품 상세·카테고리)의 편집분을 편집기가 슬롯별로 저장합니다.

파일 서빙 — 웹서버 위임

  • 환경설정 > 드라이버에 「웹서버 파일 위임」을 추가했습니다. Apache mod_xsendfile(X-Sendfile) 또는 nginx(X-Accel-Redirect)를 고르면 템플릿·모듈·플러그인 자산, 공개 스토리지 파일, 확장 아이콘, 히어로섹션 배너 영상, 게시판·페이지·상품 본문의 로컬 미디어를 PHP 가 읽어 보내는 대신 웹서버가 직접 전송하고 범위 요청(영상 탐색·이어받기)도 웹서버가 처리합니다. 캐시 검증·Cache-Control·파일 이름·유형 추측 차단 헤더는 종전과 같습니다(nginx 는 내부 위치가 유형 추측 차단 헤더를 넘기지 않으므로 화면 안내대로 그 위치에 add_header 로 다시 붙입니다). 기본은 「없음」이며 웹서버 설정이 함께 필요합니다(설정·확인 절차: docs/backend/file-serving-delegation.md). .env 의 G7_FILE_DELEGATION·G7_FILE_DELEGATION_ACCEL_PREFIX 로도 지정할 수 있습니다(.env 우선 모드 G7_ENV_PRIORITY=true 일 때 — 꺼져 있으면 화면 저장값이 이깁니다). 원격 디스크(S3) 파일과 첨부 다운로드는 대상이 아닙니다.
  • 같은 카드에 「설정 점검」(웹서버 종류·모듈과 생성될 매핑을 보여 줌)과 「실제 전송 확인」(저장된 설정으로 작은 파일을 받아 본문이 오는지 판정, 적용 중인 방식이 「사용 안 함」이거나 그 파일이 위임 경로 밖이라 PHP 가 보내게 되면 성공 대신 그 사유를 알림) 버튼, Apache·nginx 설정 안내(설치 위치 실경로 포함)를 두었습니다. 켠 뒤 화면 자산이 열리지 않으면 php artisan settings:set drivers.file_delegation none 으로 되돌리거나, .env 우선 모드(G7_ENV_PRIORITY=true)에서 G7_FILE_DELEGATION=none 으로 되돌릴 수 있습니다.

이미지 썸네일

  • 업로드 이미지 서빙 주소에 ?size={규격} 또는 ?w={숫자} 를 붙이면 환경설정의 규격대로 줄인 썸네일을 첫 요청 때 만들어 저장하고 내줍니다. 코어 첨부와 레이아웃 첨부가 이 규약을 따르고, 파라미터가 없으면 종전과 같은 원본입니다. 자세한 계약은 docs/backend/image-thumbnails.md.
  • 환경설정 > 업로드에 「썸네일」 카드(사용 여부, 본문 이미지 규격, 정리 스케줄, 저장 위치별 사용량과 비우기, 기존 이미지 썸네일 만들기)와 「썸네일 규격」 표를 추가했습니다. 규격은 코어 고정 xs, sm, md, lg, xl, og 와 확장이 등록한 규격, 운영자가 추가한 규격이고 규격마다 크기, 맞춤, 품질, 출력 형식을 정합니다. 자르기 규격은 「작은 원본 확대」를 꺼도 결과가 규격 비율을 지킵니다(원본이 한쪽만 작으면 원본 안에서 규격 비율로 잘라 그 크기로 냅니다).
  • 환경설정 > 드라이버에 「이미지 처리」 카드를 추가했습니다. GD(기본)와 Imagick(확장이 설치된 서버에서만 보임) 중 고르며, 업로드 축소와 썸네일 생성이 같은 엔진을 씁니다.
  • JPEG 썸네일은 EXIF 방향 8가지(회전과 좌우, 상하 뒤집기)를 모두 따릅니다.
  • 권한이 걸린 원본(코어 첨부, 게시판, 페이지, 리뷰, 클레임)의 썸네일은 비공개 디스크에만 저장하고 Cache-Control: private 로 냅니다. 완전 공개 원본의 썸네일 저장 디스크로 공개 자산 디스크(public, S3, CDN)를 고르면 302 로 직접 주소를 줍니다. 302 응답에도 스트림과 같은 X-Content-Type-Options: nosniff 를 붙입니다.
  • 편집기 본문에 넣은 이미지(본문 미디어)의 서빙 주소도 ?size={규격}, ?w={숫자} 썸네일 규약을 따릅니다. 본문 미디어 골격(AbstractContentMediaService)이 글, 페이지, 상품의 열람 게이트를 지난 뒤에 썸네일을 내므로 원본을 볼 수 없는 요청은 썸네일도 받지 못하고, 서명 주소에 size, w 를 덧붙여도 서명이 유지됩니다. 본문 미디어 썸네일은 문서 공개 여부와 무관하게 비공개 디스크에 저장하고 Cache-Control: private 로 냅니다. 동영상, 오디오와 Range 요청은 종전과 같습니다. 본문 미디어를 쓰는 확장은 서빙 컨트롤러의 서명 검증에서 size, w 를 빼고(ThumbnailQuery::ignoreClosure()) 자기 서빙 주소를 core.thumbnail.filter_url_patterns 에 더하면, 화면과 검색엔진 봇 화면의 본문 이미지가 본문 이미지 규격과 크기별 srcset 주소로 나갑니다.
  • 본문 미디어 골격에 행의 썸네일 원본 정보를 돌려주는 thumbnailSourceFor() 를, ContentMediaResponder::respond() 의 응답 사양에 thumbnail_source 를 추가했습니다. 본문 미디어를 쓰는 확장의 썸네일 원본 제공자가 서빙과 같은 원본 정보를 씁니다.
  • 원본을 스토리지 드라이버로 지우거나 덮어쓰면 그 원본의 썸네일을 저장소 계층이 자동으로 지웁니다(디렉터리째 지우기 포함). 로컬 원본은 원본 수정 시각이 썸네일보다 늦으면 다시 만듭니다. 확장을 제거하면 그 확장 원본의 썸네일도 지웁니다. 썸네일을 끄면 원본을 올릴 때 썸네일 연동을 건너뛰고(원본에 공개 주소가 있으면 원본 CDN 무효화만 남김), 다시 켤 때 썸네일 저장소를 비워 끈 동안 덮어쓴 원본의 옛 썸네일이 나가지 않게 합니다. 원격(S3) 원본이나 원격 썸네일 저장소에서 이미지를 올릴 때 더 보내는 요청은 많아야 1~2회입니다. 공개 주소(CDN)가 있는 원본은 이미지가 아닌 파일(PDF 등)도 덮어쓰거나 지우면 원본 주소를 무효화합니다.
  • 움직이는 GIF, WebP, PNG(APNG)는 썸네일로 바꾸지 않고 원본을 그대로 냅니다. 업로드 탭 「움직이는 이미지는 원본 사용」을 끄면 첫 장면으로 정지 썸네일을 만들고(GD 엔진은 움직이는 WebP 를 읽지 못해 원본), 확장은 훅 core.thumbnail.filter_animated_original 로 형식과 원본별로 바꿀 수 있습니다. 다시 켜면 이미 만든 정지 썸네일 대신 바로 원본으로 돌아갑니다.
  • 환경설정 > 업로드 「썸네일 규격」 표와 본문 이미지 규격, 비우기, 기존 이미지 썸네일 만들기의 규격 선택지가 확장이 등록한 규격을 식별자 대신 그 확장이 정한 이름(현재 언어)으로 보이고, 식별자는 이름 아래에 작게 둡니다. 확장은 core.thumbnail.filter_presets 의 규격 행에 label(다국어 키)을 주면 되고, 이름은 썸네일 파일과 저장값에 영향이 없습니다.
  • 원본 가로를 아는 이미지의 srcset 에서 원본보다 큰 후보를 빼는 함수 G7Core.thumbnail.contentSrcsetWithin(url, maxWidth, { includeOriginal }) 를 추가했습니다. 템플릿 본문 이미지와 번들 히어로섹션, 팝업 플러그인이 이 함수를 쓰며 화면에 나가는 srcset 은 그대로입니다.
  • 이미지 썸네일 서버 보호 값 여섯(IP 하나가 1분에 새로 만드는 썸네일 수, 생성 잠금 대기 시간, 원본 최대 픽셀 수, 기존 이미지 썸네일 만들기의 한 번 처리 수와 시간 예산, 썸네일 비우기 한 번 호출의 시간 예산)을 .env(G7_THUMBNAIL_GENERATE_PER_MINUTE, G7_THUMBNAIL_LOCK_WAIT_SECONDS, G7_THUMBNAIL_MAX_SOURCE_PIXELS, G7_THUMBNAIL_PREGENERATE_BATCH, G7_THUMBNAIL_PREGENERATE_TIME_BUDGET, G7_THUMBNAIL_PURGE_TIME_BUDGET)와 환경설정 > 업로드 썸네일 카드의 「고급」 칸으로 정할 수 있습니다. 생성 잠금 대기는 기본 10초(130초)이며, 같은 썸네일을 여러 요청이 동시에 처음 열 때 이 시간을 넘으면 원본을 캐시하지 않고 냅니다. 다른 .env 대응 설정과 같이 .env 우선 모드(G7_ENV_PRIORITY=true)에서 .env 에 값이 있으면 그 값이 이기고 화면 칸은 잠기며, 칸을 비우면 .env 값 또는 기본값을 씁니다. 비우기 시간 예산은 기본 10초(160초)입니다.
  • 코어 첨부(/api/attachment/{hash})의 다운로드에 켜진 본인인증 정책(hook 범위 core.attachment.before_download_action, route 범위 api.attachment.download)이 걸려 있으면 원본을 Cache-Control: private 로 냅니다(권한 훅이 매핑된 경우와 같은 처리, 코어 첨부의 썸네일은 원래 늘 private). 정책이 없으면 원본은 종전처럼 공유 캐시를 허용합니다.
  • 환경설정 > 업로드의 썸네일 설정 값이 실제로 바뀌면 저장할 때 큐 워커에 재시작 신호를 보내, 등록 시 썸네일을 만드는 작업이 새 설정을 씁니다.
  • 명령 php artisan thumbnails:prune(규격이 바뀌었거나 원본이 없어진 썸네일 정리, 매일 05:20 자동 실행, 업로드 탭에서 끔)과 php artisan thumbnails:pregenerate(기존 이미지 썸네일 미리 만들기)를 추가했습니다.
  • 개발 DB 에서 이미지 썸네일을 직접 확인할 때 쓰는 샘플 시더 Database\Seeders\Sample\ThumbnailMeasureSeeder 와 정리 시더 ThumbnailMeasureCleanupSeeder 를 추가했습니다. 실측 회원 2명(아바타 포함)과 실측 사이트 로고를 만들고, 정리 시더는 그 회원과 로고를 지운 뒤 원래 로고 설정으로 되돌립니다. 명령줄에서 G7_PLAYWRIGHT_BYPASS=1 을 준 실행에서만 동작하며 --sample 에는 포함되지 않습니다. 콘솔 출력과 실행 거부 사유는 사이트 언어(ko, en, ja)로 나옵니다.
  • 관리자 API GET /api/admin/thumbnails/stats·POST /api/admin/thumbnails/purge·POST /api/admin/thumbnails/pregenerate 를 추가했습니다(조회 core.settings.read, 비우기·만들기 core.settings.update). 비우기는 같은 디스크를 나눠 쓰는 위치나 규격 하나를 지울 때와 원격 저장소를 통째로 비울 때, 요청 하나가 정한 시간 예산을 넘지 않게 나눠 지우고 next_cursor 로 이어 갑니다.
  • 확장 훅 core.thumbnail.filter_presets(규격), filter_url_patterns(서빙 경로), filter_source_providers(원본 제공자), filter_url(봇 화면과 og 주소를 이미지 변환 서비스로 위임), filter_processors(엔진), filter_animated_original(움직이는 이미지 원본 여부), after_purge(CDN 무효화용)를 추가했습니다. 확장 서빙 지점 연결 방법은 docs/backend/image-thumbnails.md 에 있습니다. filter_processors 가 배열이 아닌 값을 돌려주거나 코어 엔진 자리에 엔진이 아닌 값을 넣어도 코어 엔진으로 돌아갑니다.
  • og:image, og:image:secure_url, twitter:image 가 등록된 서빙 경로의 주소면 og 규격 썸네일로 나가, 선언한 크기(SEO 탭 기본 1200×630)와 실제 이미지 크기가 맞습니다. og 규격은 원본이 그 크기보다 작아도 확대해 선언한 크기로 냅니다. 레이아웃이 크기를 직접 선언했으면 바꾸지 않습니다.
  • 검색엔진 봇 화면의 본문 이미지와 Img 의 thumbPreset 이 사람 화면과 같은 썸네일 주소와 지연 로딩을 내고, 봇 화면에서도 thumb, thumbSrcset 파이프를 쓸 수 있습니다. 템플릿 seo-config.json 의 fields 렌더 항목(상품 카드 등)도 "thumbPreset" 을 받아 같은 썸네일 주소와 srcset 을 냅니다.
  • 썸네일 설정(업로드 탭 thumbnail_*)이 바뀌면 SEO 프리렌더 캐시를 비웁니다.
  • 썸네일을 요청했는데 원본을 보낸 경우(규격보다 작은 원본, 움직이는 이미지, 정의되지 않은 규격 등)에는 그 주소를 원본 주소의 긴 캐시(최대 1년, 불변 표시 포함)로 두지 않고 줄인 이미지와 같은 시간(환경설정 레이아웃 캐시 유지 시간, 기본 1시간, 1년 이하)만 캐시해, 규격이나 「움직이는 이미지는 원본 사용」을 바꾸면 반영됩니다. 원본 응답에 CDN 용 유지 시간(s-maxage)이 있으면 그것도 같은 시간으로 줄입니다. 본문 이미지, 상품·카테고리·리뷰 이미지, 페이지 첨부, 배너와 팝업 이미지에 같이 적용됩니다. 생성 제한이나 일시 오류로 원본을 보낸 경우는 종전대로 캐시하지 않습니다.
  • 공개 자산 디스크(S3·CDN·public)에 둔 확장 이미지(이커머스 상품·카테고리·리뷰, 에디터, 히어로섹션, 팝업)는 응답에 원본 직접 주소와 썸네일 기준 주소(같은 출처 서빙 주소)를 함께 실어, 원본 한 장은 직접 주소로 받고 화면의 썸네일·srcset 은 ?size= 서빙 주소(공개 썸네일 디스크로 302 — 리뷰 이미지 썸네일은 노출 게이트가 있어 비공개 썸네일을 서버가 보냅니다)로 받습니다. 종전에는 공개 자산 디스크를 켜면 그 이미지들의 썸네일이 조용히 사라지고 원본만 나갔습니다.

회원 항목 설정

  • 회원 항목을 운영자가 정할 수 있습니다. 이름, 닉네임, 휴대폰, 전화번호, 언어, 국가, 시간대, 홈페이지, 주소, 서명, 자기소개가 회원 항목이 되어, 환경설정의 회원 탭에서 항목마다 사용, 필수, 가입 화면 표시, 순서를 바꿉니다. 기본값은 종전과 같습니다(이름만 필수, 가입 화면에는 이름, 닉네임, 휴대폰, 전화번호, 언어).
  • 7.1.x 에서 올린 사이트는 업데이트 직후의 가입 화면, 내 정보 수정, 검증이 업데이트 전과 같습니다. 업데이트가 회원 항목을 종전과 같은 기본값으로 만들고, 기존 회원의 닉네임에도 중복 판정과 닉네임 중복 필터가 쓰는 비교 값을 채웁니다. 다시 실행해도 운영자가 바꾼 항목 설정과 운영자가 추가한 항목은 그대로입니다. 7.2.0 부터는 코어 업데이트가 설치·직전 업데이트 때 놓은 번들 파일 목록을 남겨, 다음 업데이트(여러 판을 건너뛰어도)에서 새 판이 지운 번들 파일을 그 목록과 대조해 지웁니다(운영자가 고친 파일과 직접 넣은 파일, 업데이트 제외 설정으로 뺀 경로, 이름의 대소문자만 바뀐 파일은 남기고, 고쳐져 남긴 파일은 알림). 업데이트가 파일을 적용하기 전에 실패해 되돌려도 이 목록은 바뀌지 않으며, 목록은 설치와 업데이트만 만듭니다(서버 설정 조각 원장 씨앗 명령을 손으로 실행해도 디스크로 목록을 만들지 않습니다). 업데이트가 7.2.0 에서 없앤 확장 화면 조각 파일(가입 화면의 결제 통화·배송 국가 칸, 마케팅 동의 칸, 회원 알림 설정 등)을 이전 판이 남긴 번들 폴더에서 걷어 내므로, 번들 확장 업데이트 뒤 가입·내 정보·관리자 회원 화면에 옛 조각이 문구 키 그대로 보이거나 같은 칸이 두 벌로 나오지 않습니다(운영자가 고친 파일은 남깁니다). 게시판·쇼핑몰이 선언하는 회원 항목은 이어지는 번들 확장 업데이트(건너뛰었으면 나중의 그 확장 업데이트)가 만들며, 그 전 단계의 업그레이드 스텝은 이를 실패로 알리지 않습니다.
  • 운영자가 회원 항목을 추가할 수 있는 입력 유형 15종을 제공합니다: 한 줄 글, 여러 줄 글, 숫자, 예/아니오, 날짜, 날짜+시간, 기간, 하나 선택, 여러 개 선택, 전화번호, 이메일, URL, 주소, 파일, 이미지.
  • 항목 관리 API 를 추가했습니다(/api/admin/field-sets/{set}/fields — 목록, 상세, 추가, 수정, 삭제, 순서, 미입력 회원 수). 변경은 즉시 저장되며, 다른 관리자가 먼저 바꾼 표에서 온 요청은 409(fields_changed)로 거부합니다. 선택지를 지우면 그 값을 고른 회원의 값이 함께 비워집니다.
  • 환경설정에 회원 범주(member)를 추가했습니다(닉네임 중복 금지, 금지어, 변경 주기, 표시 이름 설정). 공개 설정에는 회원이 고를 수 있는 표시 이름 종류, 회원 기본 종류, 닉네임 변경 주기만 나갑니다.
  • 확장이 항목 집합, 항목, 입력 유형을 선언할 수 있습니다(getFieldSets(), getFields(), getFieldTypes()). 다른 확장이 가진 집합에도 항목을 선언할 수 있고, 운영자가 바꾼 사용, 필수, 순서는 확장을 업데이트해도 유지됩니다. 필터 훅 core.field.filter_sets, core.field.filter_types, core.field.filter_definitions, core.field.filter_rules 로 집합, 유형, 항목 목록, 검증 규칙을 조정할 수 있습니다.
  • 확장이 선언한 회원 항목의 이름과 안내문을 그 확장의 언어팩으로 번역할 수 있습니다. 확장은 도우미 App\Extension\Helpers\ExtensionLangTexts::collect() 로 자기 언어 파일과 그 확장을 대상으로 하는 활성 언어팩의 backend/{언어}/{파일}.php 를 함께 읽어 선언합니다. 확장 언어팩을 켜거나 끄면 그 확장의 항목 선언을 다시 동기화해 항목 이름에 반영합니다. 항목 표와 회원 폼의 출처 이름, 확장이 준 입력 유형의 출처 배지는 설치 기록의 확장 이름(언어팩이 채운 일본어 등)에서 화면 언어로 고릅니다.
  • 가입, 관리자 회원 추가와 수정, 내 정보 수정의 검증 규칙이 회원 항목 설정에서 만들어집니다. 설정을 바꾸지 않은 사이트의 규칙과 오류 문구는 종전과 같습니다. 운영자가 추가한 항목은 요청의 custom_fields.{키} 로 받고, 내 정보와 관리자 회원 상세 응답의 custom_fields 로 돌려줍니다(관리자 전용 항목은 본인 응답에서 빠집니다). 가입 요청에 fields_version 을 실으면 화면이 받은 항목 구성이 낡았을 때 409(fields_changed)로 알려 줍니다. 7.1.x 기본 템플릿을 복사해 만든 템플릿처럼 회원 항목을 그리지 않는 화면에서 온 요청(fields_version 이 없는 가입, 내 정보 수정, 관리자 회원 추가와 수정)은 그 화면에 없던 항목(운영자가 추가한 항목, 확장이 선언한 항목, 7.1.x 가입 화면에 없던 주소와 홈페이지 같은 기본 항목)을 필수로 두어도 그 칸 없이 저장됩니다. 보낸 값의 형식 검사와 그 화면에 있던 기본 항목의 규칙은 그대로이고(기간, 주소처럼 칸이 여럿인 항목은 일부 칸만 보내면 나머지 필수 칸도 검사합니다), 그렇게 가입하거나 추가된 회원에게 추가 정보 입력을 요구하지 않습니다. 빈 항목은 템플릿을 7.2.0 으로 올린 뒤 운영자가 채웁니다. 기본 템플릿의 가입, 내 정보 수정, 관리자 회원 추가와 수정 화면은 fields_version 을 함께 보냅니다.
  • AuthService::register() 를 직접 부르는 확장은 required_fields => 'defer' 옵션으로 필수 항목 입력을 나중으로 미룰 수 있습니다(users.required_fields_deferred_at 에 시각이 남습니다). 가입 저장 데이터를 조정하는 필터 core.auth.filter_register_data 와, 회원 항목 값이 바뀐 뒤 실행되는 액션 core.user.fields.after_update 를 추가했습니다.
  • 회원 항목 값 변경은 활동 로그에 남고, 탈퇴 회원의 항목 값은 보관 기간 처리 때 함께 파기됩니다.
  • users.name 이 비어 있을 수 있게 됐습니다(이름을 주지 않는 외부 인증 공급자, 이름 항목을 끈 사이트).
  • 닉네임 정책을 추가했습니다(환경설정 > 회원). 중복 금지를 켜면 전각과 반각, 대문자와 소문자, 공백만 다른 닉네임도 같은 닉네임으로 보고 막습니다. 금지어가 든 닉네임과, 변경 주기 안의 재변경도 막습니다. 판정은 닉네임을 바꿀 때만 하므로 정책을 켜기 전부터 겹치던 닉네임은 그대로 쓸 수 있고, 관리자가 관리자 화면에서 정하는 닉네임은 금지어와 변경 주기를 따르지 않습니다.
  • 중복 금지를 켜거나 끄면 기존 회원의 닉네임을 백그라운드 작업(큐)이 다시 대조합니다. 작업이 끝나기 전에도 새로 정하는 닉네임의 중복은 막습니다.
  • 가입 화면이 그릴 회원 항목을 주는 공개 API GET /api/auth/register/fields 를 추가했습니다. 운영자가 정한 사용, 필수, 가입 화면 표시, 순서가 반영된 항목 계약(폼 경로, 유형, 이름, 선택지, 제한 값)과 정의 버전을 돌려줍니다. 파일과 이미지 항목은 가입에서 받지 않고 안내용으로만 나옵니다. 조회 인자는 필터 core.auth.register_fields_validation_rules 로 늘릴 수 있습니다.
  • 가입 항목 API 의 조회 인자 pending_token, pending_source 로 외부 계정 가입 창(소셜 로그인, SSO)이 공급자가 준 값을 받습니다. 코어는 두 인자를 해석하지 않고 필터 core.field.filter_definitions 의 문맥(extra)으로 넘기며, 구독한 확장이 그 요청의 항목 사본에 채운 초기값(constraints.default)과 잠금(ui.readonly, ui.locked_reason)이 항목 계약의 default, readonly, locked_reason 으로 나갑니다. 저장된 항목 정의와 정의 버전은 바뀌지 않습니다.
  • 확장 조각 마크업의 <extension> 봉투가 version-constraint 속성을 받습니다. 템플릿이 다른 확장의 조각을 자기 판본으로 대체할 때(템플릿 오버라이드) 대상 확장의 버전 제약을 적어 두면, 설치된 확장의 버전이 제약에 맞지 않을 때 원본 조각이 그려집니다. 종전에는 이 속성을 적으면 컴파일 오류가 났습니다.
  • 환경설정 회원 탭이 쓰는 안내 API 를 추가했습니다. GET /api/admin/member-fields/nickname-duplicates 는 지금 겹치는 닉네임의 종 수와 회원 수를, GET /api/admin/member-fields/nickname-recompute-status 는 중복 검사 준비 작업의 진행 상태를 돌려줍니다. 항목 목록 응답의 notices.signup_layout_modified 는 가입 화면 레이아웃이 운영자 수정본이라 항목 설정이 보이지 않을 수 있는지 알려 줍니다.
  • 내 정보 수정과 보기 화면이 그릴 회원 항목을 주는 API GET /api/me/fields 를 추가했습니다. 본인이 고칠 수 있는 항목과 볼 수만 있는 항목(관리자만 수정 범위)을 함께 주고, 잠긴 칸에는 사유(locked_reason)를, 닉네임 변경 주기가 지나지 않은 닉네임 칸에는 다시 바꿀 수 있는 시각(locked_until)을 싣습니다.
  • 관리자 회원 폼과 회원 상세가 그릴 회원 항목을 주는 API GET /api/admin/users/form-fields(회원 추가 화면용)와 GET /api/admin/users/{user}/form-fields(수정, 상세용)를 추가했습니다. 관리자만 수정, 관리자만 열람 항목까지 범위(edit_scope)와 함께 주고, 수정과 상세용은 현재 값의 보기용 글자, 올라간 파일, 닉네임 마지막 변경 시각, 비어 있는 필수 항목을 함께 줍니다. 추가 화면용은 회원 추가 권한이 있어야 받고, 수정과 상세용은 그 회원에 대한 회원 조회 권한의 범위를 따릅니다. 요청 규칙 필터 core.user.admin_form_fields_validation_rules 를 제공합니다.
  • 관리자 회원 목록 API(GET /api/admin/users)에 필터 nickname_duplicate(닉네임이 다른 회원과 겹치는 회원)와 required_missing(필수 항목이 비어 있는 회원)을 추가했고, 운영자가 회원 검색으로 켠 추가 항목의 값으로 검색할 수 있습니다(검색 대상 custom:{키}). 행마다 비어 있는 필수 항목(pending_required_fields)을 싣고, 운영자가 목록 열과 회원 검색으로 켠 추가 항목을 member_fields.columns, member_fields.search_fields 로 알려 줍니다.
  • 회원의 파일, 이미지 항목에 파일을 올리고 지우는 API 를 추가했습니다(본인 POST|DELETE /api/me/fields/{key}/file, 관리자 POST|DELETE /api/admin/users/{user}/fields/{key}/file). 허용 확장자, 최대 크기, 최대 개수는 운영자가 항목에 정한 값을 따릅니다. 올린 파일은 본인과 회원 조회 권한이 있는 관리자만 내려받을 수 있고, 공개 프로필에 노출하는 이미지 항목만 누구나 볼 수 있습니다. 탈퇴하거나 회원을 삭제하면 올린 파일도 함께 지워지고, 항목을 삭제하거나 그 항목을 선언한 확장을 지우면 그 항목에 회원들이 올린 파일도 함께 지워집니다(삭제 창의 값 수는 파일을 올린 회원 수를 셉니다).
  • 회원 응답(내 정보, 로그인 사용자, 관리자 회원 상세)에 잠긴 칸마다의 사유 locked_reasons 를 추가했습니다. 확장은 새 필터 core.user.locked_field_reasons 로 자기가 잠근 칸의 사유를 줍니다. 사유를 주지 않은 칸은 locked 입니다. 기존 locked_fields 와 필터 core.user.locked_fields 는 그대로입니다.
  • 「기존 회원에게도 입력 요구」를 켠 필수 항목이 비어 있는 회원의 쓰기 요청(POST, PUT, PATCH, DELETE)을 코어, 모듈, 플러그인 API 전체에서 403(error_code: required_fields_pending)으로 거부합니다. 응답의 data.pending_required_fields(항목 키)와 data.fields(키와 이름)로 화면이 안내합니다. 읽기 요청과 관리자 API 는 막지 않습니다. 필수 항목을 건너뛰고 만들어진 회원(required_fields => 'defer')은 요구를 켜지 않은 필수 항목까지 대상이고, 다 채우면 보통 회원과 같은 기준으로 돌아갑니다. 그 회원이 고칠 수 없게 잠긴 칸은 대상에서 빠집니다.
  • 추가 정보 입력 화면용 API 를 추가했습니다. GET /api/me/fields?context=required 는 그 회원에게 비어 있는 필수 항목만 돌려주고, PUT /api/me/required-fields 는 그 항목의 값만 받아 저장합니다(기존 값을 바꾸지 못하므로 재확인을 요구하지 않습니다). 본인 응답(GET /api/auth/user, GET /api/user/auth/user, GET /api/admin/auth/user)과 로그인을 마친 응답에 비어 있는 필수 항목 키 pending_required_fields 를 싣습니다.
  • 미입력 회원에게도 열어 둘 라우트를 정하는 미들웨어 별칭 allow.pending_required_fields 와 필터 core.required_fields.filter_exempt_routes 를 추가했습니다. 코어는 로그아웃, 토큰 갱신, 내 정보(/api/me 아래 전부와 /api/user/profile 의 수정, 언어 변경), 알림 읽음과 삭제, 본인인증에 표식을 붙였습니다. 결제 결과 처리나 외부 계정 연결처럼 추가 정보 입력 중에도 열려 있어야 하는 라우트를 가진 확장은 표식을 붙이거나 필터로 라우트 이름을 보태야 합니다.
  • 본인인증 수단이 확인한 이름, 휴대폰, 생년월일, 성별을 회원 항목에 채우는 선택 계약 App\Contracts\Extension\ProvidesVerifiedClaimsInterface 와 값 객체 VerifiedClaims 를 추가했습니다. 본인인증 프로바이더가 이 계약을 구현하면, 항목의 「본인인증 연결」에 따라 가입 화면 항목이 인증 값으로 채워지고(GET /api/auth/register/fields?verification_token=… 의 default, verified_claims), 「인증 값으로 채우고 잠금」을 켠 항목은 가입 요청에서 서버가 인증 값으로 덮어쓰며 내 정보 수정에서 잠깁니다(locked_reason: identity). 잠금은 지금 값이 그 회원의 최근 인증 값과 같은 항목에만 걸립니다 — 인증 값이 채우지 못한 칸에 회원이 직접 쓴 값이나 운영자가 나중에 잠금을 켠 항목의 이전 값은 잠기지 않습니다. 로그인 회원이 다시 본인인증을 마치면 잠금 항목이 새 인증 값으로 맞춰집니다. 계약을 구현하지 않은 수단에서는 아무것도 달라지지 않습니다.
  • 본인인증 채움값 API POST /api/identity/claims 와 필터 core.identity.filter_verified_claims 를 추가했습니다. API 는 토큰의 인증 값과 회원 항목 키별 채움값, 잠글 항목 키를 돌려주고, 필터로 확장이 인증 값을 고치거나 대신 줄 수 있습니다. 가입 화면의 채움·잠금은 「가입 전 본인확인」 정책을 켠 사이트에서만 쓰입니다 — 정책이 꺼져 있으면 API 는 status: disabled 와 빈 값을 주고, 가입 요청의 인증 결과로 항목을 덮어쓰거나 본인인증을 기록하지 않습니다.
  • 가입 요청(POST /api/auth/register)이 verification_token 을 가입 전 본인인증 정책을 켜지 않은 사이트에서도 선택 값으로 받습니다. 정책을 켠 사이트는 입력 검증을 먼저 합니다 — 빈 칸이나 틀린 입력은 본인 확인 요구(428)보다 먼저 칸별 오류(422)로 알리고, 입력이 맞는데 인증 결과가 없을 때만 428 로 인증 창을 엽니다. 전에는 빈 칸으로 제출해도 428 이 먼저 와 칸 오류 없이 「본인 확인이 필요합니다.」만 뜨고 인증 창도 열리지 않았으며, 입력을 바르게 채운 경우에도 인증을 마친 뒤에야 입력 오류를 보았습니다. 실린 토큰이 만료됐거나 알 수 없으면 종전처럼 검증 오류(422)입니다. 확장 개발자용: 폼 요청에 App\Contracts\Http\DefersIdentityPolicyUntilValidated 를 달면 그 라우트의 본인확인 정책이 입력 검증 뒤에 강제됩니다. 문서: docs/backend/identity-policies.md 「입력 검증 먼저」
  • 첨부파일 저장소 계약(AttachmentRepositoryInterface)에 대상 여럿의 지정 컬렉션 첨부를 한 번에 읽는 getByAttachmentablesAndCollections() , 한 대상 유형 전체에서 지정 컬렉션에 첨부를 가진 대상 수를 세는 countAttachmentablesByTypeAndCollection(), 그 첨부 ID 만 읽는 idsByAttachmentableTypeAndCollection()(회원 파일 항목을 지울 때 삭제 창의 건수와 함께 지울 첨부를 정하는 데 씀)를 추가했습니다. 이 계약을 직접 구현한 확장은 세 메서드를 구현해야 합니다.
  • 금지어 검증 규칙 App\Rules\ForbiddenWords 를 추가했습니다. 확장은 자기 금지어 목록과 문구로 이 규칙을 쓸 수 있습니다.
  • AuthService::register() 와 UserService::updateUser() 에 옵션 nickname_policy => 'skip_field' 를 추가했습니다. 화면 없이 회원을 만들거나 고치는 확장이 넘기면, 닉네임이 정책에 걸렸을 때 닉네임만 빼고 저장하고 액션 core.user.nickname_rejected 로 알립니다. 넘기지 않으면 닉네임 칸의 검증 오류가 납니다.

표시 이름

  • 회원을 화면에 어떤 이름으로 보일지 정하는 표시 이름 구조를 추가했습니다. 종류는 이름, 닉네임, 가린 이름(홍동), 아이디 가림(gil**), 이름(닉네임), 회원 추가 항목의 값이고, 값이 없으면 정해진 대체 순서를 따릅니다. 닉네임이 비었을 때 이름으로 대신하지 않습니다.
  • 이름이 보이는 자리(영역)마다 방식을 정할 수 있습니다: 상위 영역 따름, 종류 고정, 회원이 고른 값. 코어 영역은 사이트 기본, 관리자 화면, 알림과 알림 채널입니다. 사이트 기본의 처음 방식은 「회원이 고른 값」이라, 환경설정 > 회원 > 표시 이름의 「회원 기본 종류」를 바꾸면 사이트 기본과 그것을 따르는 영역(게시판 글과 댓글, 알림 등)이 함께 바뀝니다. 관리자 화면은 「이름」 고정입니다. 설정을 바꾸지 않은 사이트는 회원 기본 종류가 「이름」이라 화면과 응답의 이름 값이 종전과 같습니다.
  • 환경설정 > 회원 > 표시 이름의 「회원 기본 종류」 아래에 이 값을 지금 쓰는 영역을 보입니다(저장 전에 바꾼 방식도 바로 반영). 쓰는 영역이 하나도 없으면 바꿔도 화면에 변화가 없다고 알립니다. 표시 이름 안내 API(GET /api/admin/member-fields/display-name-options)의 영역마다 「회원이 고른 값」인 인스턴스(게시판마다 설정 등)의 이름 member_instances 가 옵니다.
  • 회원 응답에 다른 회원에게 보이는 이름 display_name 을 추가했습니다. name, nickname 은 원본 그대로입니다. 본인 응답과 관리자 회원 상세에는 회원이 고른 종류 display_name_kind 와 선택 가능 여부 can_choose_display_name 이 함께 옵니다. 관리자 회원 목록의 행에도 display_name 이 옵니다.
  • 회원이 가입 화면과 내 정보 수정에서 표시 이름 종류를 고를 수 있습니다(요청 키 display_name_kind). 고르려면 새 권한 core.profile.display_name.choose 가 필요하고 운영자가 허용한 종류가 둘 이상이어야 합니다. 권한이 없거나 허용하지 않은 종류면 422 입니다. 새 권한은 기본 user 역할에 부여됩니다.
  • 가입 항목 API 와 내 정보 항목 API 의 응답에 종류 선택 칸의 묶음 display_name 을 추가했습니다. 고를 수 있는 종류와 종류별 미리보기 글자, 고른 종류가 허용에서 빠졌는지(value_unavailable)를 줍니다. 조회 인자 preview_name, preview_nickname, preview_email 로 입력 중인 값의 미리보기를 받을 수 있습니다.
  • 표시 이름 설정이 닉네임을 쓰면 닉네임 항목이 잠깁니다. 어떤 영역이 닉네임이 필요한 종류로 고정이면 사용과 필수가, 회원이 고를 수 있는 종류에 그런 종류가 있으면 사용이 고정됩니다(그 종류로 보이는 회원만 닉네임이 필수). 항목 목록 응답의 lock_reasons 에 사유 코드 nickname_display 가 실립니다.
  • 환경설정 회원 탭이 쓰는 API 를 추가했습니다. GET /api/admin/member-fields/display-name-options 는 종류와 영역 목록을, GET /api/admin/member-fields/nickname-empty-count 는 닉네임이 빈 회원 수를 줍니다. 설정 저장에 member.nickname_require_existing_members 를 실으면 닉네임 항목의 「기존 회원에게도 입력 요구」가 함께 켜집니다.
  • 표시 이름 종류로 쓰이는 회원 추가 항목은 삭제할 수 없습니다. 삭제 API 가 409(field_in_use)와 사용처 목록을 돌려줍니다.
  • 관리자 회원 폼의 회원 상태에 회원이 고른 종류와 지금 보이는 이름을 추가했습니다(읽기 전용). 관리자는 회원의 종류를 바꾸지 못합니다.
  • 확장이 표시 이름 종류와 영역을 등록할 수 있습니다(getDisplayNameKinds(), getDisplayNameAreas()). 필터 core.display_name.filter_kinds, core.display_name.filter_areas, core.display_name.filter_resolved 와, 회원의 표시 이름에 영향을 주는 값이 바뀌면 실행되는 액션 core.user.display_name_changed 를 추가했습니다.
  • 확장이 쓰는 표시 이름 계산기 App\DisplayName\DisplayNameResolver(한 명, 여러 명 한 번에), 작성자 검색과 작성자순 정렬 헬퍼 App\DisplayName\DisplayNameQuery, 회원 관계의 컬럼 제한용 User::displayColumns() 를 추가했습니다. 사용자 화면의 작성자 검색은 그 자리에서 보이는 종류의 원본 값만 찾습니다(가린 종류는 찾지 않습니다).
  • 회원 탭 설정을 저장하면 검색 엔진용 미리 그린 화면을 전부 비웁니다.
  • 관리자 화면에 나가는 회원 이름이 관리자 화면 영역의 표시 이름이 됩니다: 활동 로그의 행위자, 알림 발송 이력의 발신자와 수신자, 회원 알림함의 수신 회원, 알림 템플릿의 지정 수신자, 스케줄 등록자와 실행한 사람, 메뉴 등록자, 첨부 파일 업로더, 레이아웃 버전의 저장자, 개인정보 수동 실행의 접수자, 개인정보 처리 대상 명단(휴면, 비밀번호 만료, 최근 검색어), 방문자 통계의 회원, 대시보드 최근 알림의 수신자. 이름을 받지 않는 사이트에서도 빈칸이 되지 않고 닉네임, 아이디 가림 순서의 값이 보입니다. 관리자 회원 목록, 상세, 수정 폼의 이름과 닉네임은 원본 그대로입니다.
  • 관리자 화면 응답에 실명 보조 real_name 을 추가했습니다. 관리자 엔드포인트의 응답이고, 요청한 관리자에게 회원 조회 권한이 있고, 실명이 표시 이름과 다를 때만 실립니다(조건에 맞지 않으면 키가 없습니다). 조회 범위가 본인이나 소유 역할로 좁혀진 관리자는 자기 실명만 봅니다. 이름 키가 name 이 아닌 응답은 created_by_real_name, requester_real_name 을 씁니다.
  • 공개 프로필의 이름이 사이트 기본 영역의 표시 이름이 됩니다. 닉네임으로 보이는 사이트에서 공개 프로필 응답에 실명이 실리지 않습니다.
  • 관리자 화면의 회원 검색과 회원 알림함의 수신 회원 검색이 이름과 닉네임을 모두 찾습니다.
  • 확장이 응답에 회원 이름을 실을 때 쓰는 App\DisplayName\MemberNamePresenter 를 추가했습니다. 표시 이름과 실명 보조를 같은 규칙으로 만들고, 목록의 회원 값을 한 번에 읽어 둡니다. 리소스에서는 memberNameFields(), memberDisplayName(), preloadMemberDisplayNames() 로 씁니다.
  • 표시 이름 종류로 쓸 수 있게 켠 회원 추가 항목에 닉네임 금지어를 적용합니다. 다른 회원에게 이름으로 보이는 값이라 사칭을 막기 위해서입니다. 조건은 닉네임과 같습니다(전각, 대소문자, 공백 차이 무시, 관리자 화면에서 정하는 값은 면제, 이미 저장된 값은 그대로 둠).

알림의 받는 사람 이름과 회원 항목 변수

  • 알림의 받는 사람 이름({recipient_name})이 채널의 표시 이름 영역(core:notification:{채널})으로 계산됩니다. 운영자가 메일과 사이트 알림을 다르게 정하면 같은 사람에게 채널마다 다른 이름이 나갑니다. 수신자가 많아 나뉘어 발송될 때도 같은 규칙입니다. 설정을 바꾸지 않은 사이트는 종전처럼 회원 이름이 나갑니다. 필터 {hook_prefix}.notification.personalize_data 의 인자는 그대로입니다.
  • 코어 알림(가입 환영, 비밀번호 재설정, 비밀번호 변경, 비밀번호 만료 안내와 만료, 휴면 안내)의 이름 변수가 받는 사람의 표시 이름으로 채워집니다. 값이 {recipient_name} 인 알림 데이터 칸은 키 이름과 무관하게 모두 바뀝니다.
  • 메일의 받는 사람 이름은 메일 채널의 표시 이름이고, 발송 이력에 새로 남는 수신자 이름은 그 시점의 관리자 화면 영역 표시 이름입니다. 이미 남은 이력은 바뀌지 않습니다.
  • 알림 템플릿에서 받는 회원의 항목 값을 변수로 쓸 수 있습니다: {member.display_name}, 코어와 확장 항목 {member.<키>}, 운영자 추가 항목 {member.custom.<키>}. 템플릿이 참조한 변수만 채우고 수신자 묶음마다 값을 한 번에 읽습니다. 「관리자만 열람」 항목과 파일 항목은 변수가 되지 않습니다.
  • 템플릿 편집 화면의 변수 목록(알림 정의 응답의 variables)에 회원 공통 변수가 group: member 로 덧붙습니다. 미리보기는 회원 변수를 설명 글자로 보입니다.
  • 알림 템플릿 저장 응답에 warnings 를 추가했습니다. 지워졌거나 꺼진 회원 항목의 변수를 쓰면 저장은 되고 없는 변수 이름을 알려 줍니다.
  • 필터 core.notification.filter_member_variable_keys(확장 채널이 채울 회원 변수 이름을 보탬)와 core.notification.filter_template_variables(편집 화면의 변수 목록)를 추가했습니다. 받는 사람이 아닌 회원의 이름을 알림에 실을 때 쓰는 App\Notifications\RecipientDisplayName 을 추가했습니다.

확장 공개 계약·비공개 첨부 저장소·첨부 업로더

  • 모듈·플러그인이 다른 확장에 공개하는 PHP 표면을 module.json·plugin.json 의 public_api(네임스페이스, 클래스, 읽기 전용 Model)로 선언할 수 있습니다. 관리자 확장 상세 화면에 「공개 API」 칸으로 보입니다. 다른 확장은 공개된 계약과 공개 훅만 써야 하고, 그 밖의 내부 클래스와 테이블을 직접 쓰는 번들 확장은 검수에서 막힙니다 (#83 @jiwonpapa 님께서 건의해주셨습니다.)
  • 환경설정 > 드라이버에 「비공개 첨부 저장소」를 추가했습니다. 권한을 확인한 뒤 내려주는 파일(코어, 게시판, 페이지 첨부와 클레임 이미지, 본문 미디어, 내보내기 파일)을 어느 디스크에 저장할지 한 번에 고릅니다. 「기본」이면 지금처럼 사이트 스토리지 드라이버를 따르고, 바꾼 뒤 올린 파일만 새 디스크에 저장되며 이미 올린 파일은 원래 디스크에서 그대로 내려갑니다. 플러그인이 비공개 디스크를 등록하면 선택지에 붙고, 공개 자산 스토리지와 같은 디스크를 고르면 경고합니다. .env 로 디스크를 고정한 항목은 카드에 따로 안내합니다 (#83 @jiwonpapa 님께서 건의해주셨습니다.)
  • 확장 개발자용으로 비공개 원본을 저장하는 서비스를 AbstractModule::PRIVATE_ATTACHMENT_BINDING 으로 묶으면 이 선택을 따르고, .env 고정은 getPrivateAttachmentDiskPin() 으로 알릴 수 있습니다.
  • 첨부 업로더 21곳(관리자 환경설정의 로고, 파비콘, 기본 OG 이미지와 게시판, 이커머스, 페이지, 히어로섹션, 팝업, 사용자 글쓰기, 클레임, 리뷰)에 확장점 attachment_uploader 를 두었습니다. 업로더 플러그인이 이 확장점 하나로 업로더 화면을 바꿔 끼울 수 있고, 업로드 계약 값은 화면이 기존 값으로 넘겨 줍니다. 교체하지 않으면 지금 업로더가 그대로 보입니다 (#83 @jiwonpapa 님께서 건의해주셨습니다.)
  • 권한이 걸린 이미지의 썸네일 저장 위치에 비공개 첨부 저장소로 등록된 디스크도 고를 수 있습니다. 공개 자산 디스크는 계속 고를 수 없습니다.
  • 「데이터까지 삭제」로 확장을 지우면 원격 비공개 디스크와 공개 자산 디스크에 남은 그 확장의 파일도 함께 지웁니다. 지우지 못한 디스크가 있으면 제거는 끝까지 하고 경고를 남깁니다.

확장 패키지 서명 검증

  • 모듈, 플러그인, 템플릿, 언어팩을 ZIP 이나 GitHub 로 설치하거나 업데이트할 때, 코어를 업데이트할 때 패키지 서명(SHA-256 + Ed25519)을 확인합니다. 서명이 틀렸거나 신뢰하지 않는 키로 서명한 패키지는 설치하지 않습니다. 서명이 없는 패키지는 한 번 더 확인을 받고 설치하며, 환경설정 > 보안 「미서명 패키지 차단」을 켜면 서명 없는 패키지를 아예 받지 않습니다. 7.1.x 관리자 템플릿을 복사해 쓰는 사이트는 확인 단추가 없으므로, 그 화면에서 보낸 설치와 업데이트는 7.1 처럼 서명 없는 패키지를 확인 없이 진행하고 서버 로그에 남깁니다. 이때도 「미서명 패키지 차단」, 서명 불일치, 신뢰하지 않는 키는 그대로 막습니다. (#83 @jiwonpapa 님께서 건의해주셨습니다.)
  • 설치한 확장에 검증 결과(검증됨, 서명 없음, 번들 등)와 서명 키가 기록되고 확장 상세 화면에 보입니다.
  • 공식 배포본(코어, sirsoft 확장, 언어팩)을 검증하는 코어 내장 서명 키(sirsoft:dc05cd817a9ac65c)가 들어 있습니다. 코어 업데이트는 내장 키로만 검증합니다.
  • 환경설정 > 보안에 「확장 신뢰 키」 구획을 추가했습니다. 다른 제작사의 공개키를 vendor 범위와 함께 등록하고 지울 수 있고, 등록과 삭제는 비밀번호를 다시 확인합니다. sirsoft 범위는 내장 키만 서명할 수 있습니다.
  • 명령 extension:keygen(서명 키 만들기), extension:sign(ZIP 또는 디렉터리 서명), extension:trust-key add|remove|list(신뢰 키 관리)를 추가했습니다. module|plugin|template:update, core:update 에 --allow-unsigned 와 --signature=(ZIP 의 서명 파일), language-pack:install 에 --allow-unsigned 와 --signature=(URL 설치의 서명 파일 주소), language-pack:update 에 --allow-unsigned 를 추가했습니다.
  • 관리자 API GET|POST /api/admin/extension-trust-keys, DELETE /api/admin/extension-trust-keys/{id} 를 추가했습니다. 설치와 업데이트 요청은 allow_unsigned, ZIP 업로드는 signature 파일, 언어팩 URL 설치는 signature_url 을 받습니다. 7.2.0 관리자 화면은 설치, 업데이트, 코어 업데이트 착수에 표식 integrity_aware=1 을 늘 보내며, 이 표식이 없는 요청은 옛 화면으로 보고 서명 없는 패키지를 확인 없이 진행합니다. 서명 없는 패키지는 409 package_unsigned, 서명이 틀렸거나 신뢰하지 않는 키는 422 로 거절합니다.
  • 언어팩 설치 창에 URL 탭을 추가했습니다. 주소에 연결하지 못하면(이름 해석 실패·연결 거부·시간 초과) 응답 오류와 같이 422 와 그 사유(「URL(…) 에서 언어팩을 다운로드하지 못했습니다: …」)로 알리고, 예상하지 못한 설치 실패는 원인을 서버 로그에 남깁니다.
  • 설치 마법사가 PHP sodium 확장을 권장 항목으로 확인합니다. 없으면 서명을 검증할 수 없어 서명 없는 패키지와 같이 다룹니다.
  • php artisan search:index --repair 로 검색 인덱스를 다시 만든 뒤에도 색인 누락이 남으면, 남은 표 이름과 표를 다시 만드는 명령(ALTER TABLE ... ENGINE=InnoDB, ALGORITHM=COPY;)을 명령 출력과 로그에 안내합니다. 표 안의 숨은 문서 번호 연결이 어긋난 표는 인덱스 재생성으로 고쳐지지 않기 때문입니다. 표 재구축은 큰 표에서 오래 걸리고 그동안 쓰기가 막히므로 자동으로 실행하지 않습니다. 확장·코어 업데이트에서 재생성을 고른 경우와 개발 도구의 「검색 인덱스 점검」 출력에도 같은 안내가 나오고, 업데이트 응답의 검색 인덱스 결과에는 advice 로 실립니다.

Changed

레이아웃 보존·업데이트 (동작 변경)

  • 레이아웃 갱신(*:refresh-layout, 관리자 [레이아웃 갱신], 개발 대시보드)의 기본이 운영자 수정 유지(keep)로 바뀌었습니다. 종전처럼 새 판으로 덮으려면 --layout-strategy=overwrite(API layout_strategy=overwrite)를 고릅니다.
  • 검수 서버(G7_RUNTIME_ROLE=stage)에서 호환성 복구 API(POST /api/admin/extensions/{type}/{identifier}/recover)도 409 로 막습니다 — 복구는 확장을 다시 켜는 수명주기 동작입니다. 수명주기 경로 전체가 이 잠금을 거치는지 등록된 경로 목록으로 검사합니다.
  • GenericEntitySyncHelper::cleanupStale() 의 entityLabel 이 언어별 묶음(LocalizedValue::translateAll())도 받습니다. 운영자가 고친 시드 행을 지우기 직전 남기는 활동 로그가 로그를 볼 때의 언어로 항목 이름을 보입니다.
  • 플러그인을 제거할 때 「데이터도 함께 삭제」를 고르지 않으면 관리자 메뉴를 지우지 않습니다(종전에는 일부 플러그인이 옵션과 무관하게 지웠습니다).
  • 템플릿을 제거하면 그 템플릿의 레이아웃 첨부 파일·커스텀 번역·미리보기·다른 출처 조각을 함께 지웁니다(운영자 데이터는 삭제 직전 기록).
  • 부모 행을 지우는 경로(회원·역할·메뉴·권한·스케줄 일괄·알림 정의·템플릿·본인확인 로그 파기·확장 메뉴/권한 일괄 삭제)가 자식 행을 DB 연쇄 삭제에 맡기지 않고 명시적으로 지웁니다. 확장 메뉴 일괄 삭제는 다른 출처의 하위 메뉴를 최상위로 올립니다.

명령줄 운영 (동작 변경)

  • core:update 는 번들 확장 일괄 업데이트가 끝난 뒤에 점검 모드를 풉니다(실패·예외에서도 풉니다).
  • core:update 가 업그레이드 스텝 핸드오프로 멈추면 종료 코드가 0 에서 75(재개 필요)로 바뀝니다. 번들 일괄 업데이트 자식이 정상 종료했는데 결과를 남기지 않으면 실패 1건으로 셉니다.
  • module:check-updates·plugin:check-updates·template:check-updates 는 GitHub 조회에 실패한 확장이 있으면 실패 표를 출력하고 종료 1 이며, 그 확장의 DB 업데이트 정보(업데이트 여부·최신 판·출처)를 덮지 않습니다 — 번들에 더 새 판이 있어도 그 판은 출력에만 보입니다. *:update --source=github 는 조회에 실패하면 「업데이트 없음」(0) 대신 사유와 함께 종료 1 입니다(소스 자동이면 번들 기준으로 판정하고 경고 한 줄).
  • 단독 실행한 core:execute-upgrade-steps 는 낡은 메모리 가드에 걸리지 않고(새 프로세스), 코어 업데이트 실행 잠금을 잡습니다. 재개 안내는 APP_VERSION=<대상 판> 접두(PowerShell 형식 포함)를 적습니다. spawn 실패 모드는 app.update.spawn_failure_mode(기본 abort) 하나만 읽습니다.
  • 콘솔이 없는 실행(cron·CI·원격 명령)에서 번들 일괄 업데이트의 전략 선택, 비밀번호 재설정·설정 지정의 비밀값 입력을 묻지 않고 기본값을 쓰거나 실패합니다(종전에는 응답을 무한히 기다렸습니다).

회원

  • 회원 저장소의 findManyByIdsKeyed() 가 표시 이름 계산에 필요한 칸(User::DISPLAY_COLUMNS)을 읽습니다. getNamesByIds() 는 원본 이름을 돌려주며 이름이 없는 회원은 빈 문자열입니다. 화면에 보일 이름은 표시 이름 계산기로 만듭니다.
  • 탈퇴한 회원의 닉네임 접미사가 _탈퇴 에서 _탈퇴_{회원 ID} 로 바뀌었습니다. 닉네임 중복 금지를 켠 사이트에서 같은 닉네임으로 다시 가입한 회원이 또 탈퇴해도 겹치지 않습니다. 이미 탈퇴한 회원의 닉네임은 바꾸지 않습니다.

레이아웃 반응형

  • 번들 템플릿과 확장 레이아웃의 화면 폭 분기를 Tailwind 반응형 접두(sm: md: lg: xl: 2xl: min-[..]: max-[..]:) 대신 엔진 responsive 로 모두 바꿨습니다. 화면은 그대로이고, 관리자 상품 목록 이미지는 칸 크기와 같은 경계(767px 이하는 큰 썸네일, 768px 이상은 80px 칸에 맞는 작은 썸네일)로 규격이 바뀝니다. 레이아웃에 Tailwind 반응형 접두를 쓰면 정적 검사가 막습니다. 작성법은 docs/frontend/responsive-layout.md. 개발자 도구의 Tailwind 검증기도 폭 접두 클래스를 경고하고 대응하는 엔진 responsive 구간을 알려 주며, 스타일 추적기는 Tailwind 폭 접두 대신 엔진 responsive 를 권하고 엔진 responsive 로 숨긴 요소를 폭 조건 없는 숨김으로 잘못 알리지 않습니다.
  • 관리자 화면과 확장 관리자 화면(게시판·이커머스·페이지와 플러그인 17종) 레이아웃이 폭에 따라 모양이 바뀌던 의미 클래스(필터 행·라벨, 2·3열 격자, 페이지 제목과 머리, 머리 단추 묶음, 본문 여백, 상단 고정 탭, 검색바, 나눈 입력 칸, 넓은 화면 표 등과 확장의 같은 이름 사본) 대신 엔진 responsive 구간 값으로 폭을 나눕니다(화면 변화 없음). 번들 레이아웃은 폭 미디어를 품은 클래스를 쓰지 않으며, 레이아웃이 그런 클래스를 쓰거나 원본 CSS 의미 클래스에 반응형 @apply·폭 미디어를 두면 정적 검사가 막습니다. 관리자 필터 줄 라벨과 입력 칸 이름을 잇는 곁 라벨 표식은 폭과 무관한 filter-field-label 이 맡습니다(예전 filter-label 도 계속 받습니다).
  • 두 번들 템플릿 부품(관리자 페이지 머리말·하단 줄·창 바닥 단추 줄·카드 목록 열 수·첨부 썸네일·권한 트리 격자·다국어 입력·상단 사용자 이름·열 선택·코드 편집기, 사용자 헤더·푸터 여백·쪽 이동 맨 앞·맨 끝 단추·첨부 썸네일·방문자 카운터·화면 뼈대)과 히어로 슬라이더가 Tailwind 반응형 접두나 폭 미디어 클래스 대신 렌더 폭으로 모양을 고릅니다. 일반 화면은 그대로이고, 레이아웃 편집기 미리보기에서 기기를 바꾸면 창 폭과 상관없이 그 기기 폭의 모양으로 보입니다. 관리자 부품은 폭 미디어가 걸린 옛 클래스(page-title·page-actions·admin-footer-row·modal-footer-row) 대신 폭과 무관한 새 클래스(page-heading·page-action-group·admin-footer-bar·modal-footer-bar)를 붙이므로, 사이트 CSS 가 옛 이름을 꾸몄다면 새 이름에도 같은 규칙을 줍니다.
  • 사용자 템플릿과 관리자 템플릿의 Grid 부품 responsive 속성(sm, md, lg, xl, 2xl 구간별 열 수)이 Tailwind 반응형 접두 클래스 대신 엔진 폭으로 열 수를 골라, 레이아웃 편집기 미리보기에서도 기기 폭에 맞는 열 수로 보입니다. 사용자 템플릿의 화면 뼈대도 같은 판정을 씁니다.
  • 레이아웃 굽기가 한 부품의 responsive 에서 열린 커스텀 구간(768-, -1023 처럼 한쪽 끝을 비운 키)이 다른 열린 구간이나 프리셋과 같은 폭에서 함께 맞으면 경고(responsive_open_range_overlap)를 냅니다. 엔진은 맞는 키 하나만 골라(커스텀이 프리셋보다, 좁은 구간이 넓은 구간보다 먼저이며, 위가 열린 구간끼리는 먼저 적은 것) 나머지 값을 그 폭에서 버리므로, 768- 과 1024- 를 그 순서로 적으면 1024- 값은 어느 폭에서도 쓰이지 않습니다. 굽기는 막지 않으며 번들 레이아웃에는 해당하는 곳이 없습니다.

개발자 화면·외부 화면

  • 코어 알림 링크, 비밀번호 재설정 링크(회원·관리자), 메일 본인인증 링크, 관리자에게 가는 알림의 관리자 화면 링크를 화면 주소 키로 만듭니다. 회원 링크는 「사용자 화면 URL」, 관리자 링크는 사이트 주소 기준이며, 주소 필터로 경로를 바꿀 수 있습니다. 회원에게 가는 알림·메일의 {site_url} 도 「사용자 화면 URL」(비우면 사이트 주소)이고, 관리자 로그인 화면에서 요청한 비밀번호 재설정 메일, 관리자가 받는 비밀번호 변경 완료 메일, 관리자에게만 적용되는 본인인증 정책의 인증 메일, 관리자 화면에서 시작한 본인인증 메일(확인 링크 포함)은 사이트 주소 기준입니다. 비밀번호 변경 완료 메일의 로그인 링크도 관리자에게는 관리자 로그인 화면입니다. 본인인증 시작 API(POST /api/identity/challenges)는 시작 화면 범위 scope(admin·user)를 받습니다.
  • 로그인·회원가입·토큰 갱신 API 가 서버 세션과 그 로그인의 토큰을 짝지어 둡니다. 토큰이 회수·만료되면 개발자 화면에서도 바로 비회원이 되고 그 세션의 로그인은 로그아웃 처리됩니다. 7.2.0 이전에 로그인한 회원은 개발자 화면에서 비회원으로 보이며, 다시 로그인하면 됩니다(그누보드7 화면은 영향 없음). 로그인 화면의 로그인 수단 묻기(POST /api/auth/login/discover)는 서버 세션을 열지 않습니다. 이메일을 넣고 곧바로 로그인해도 로그인 직후 개발자 화면이 비회원으로 보이지 않습니다.
  • 엔진 화면 안에서 개발자 화면 주소(routes/custom.php 의 GET 주소)로 이동하면 전체 페이지로 이동하고, 뒤로·앞으로 가기로 그 주소에 오면 새로 불러옵니다(engine-v1.92.0). 개발자 주소가 없으면 종전과 같습니다.
  • 본인인증 복귀 주소로 「사용자 화면 URL」과 같은 출처도 받습니다.
  • 토큰 만료 연장을 개발자 화면 요청에도 적용합니다.

스케줄 관리

  • 사이트맵 생성 주기·시각은 환경설정 > SEO 대신 관리자 > 스케줄 관리의 「사이트맵 생성」에서 바꿉니다. 기본값과 다른 주기를 저장해 둔 사이트는 업데이트할 때 그 주기가 스케줄로 옮겨집니다. 환율 갱신 시각(한국수출입은행 환율 플러그인)도 같은 방식으로 스케줄 관리로 옮겨졌습니다.
  • GeoIP 데이터베이스 갱신 주기는 환경 변수(GEOIP_SCHEDULE_FREQUENCY·GEOIP_SCHEDULE_TIME) 대신 스케줄 관리의 「GeoIP 데이터베이스 갱신」에서 바꿉니다. 환경 변수로 주기를 바꿔 둔 사이트는 업데이트할 때 그 주기가 스케줄로 옮겨지며, 환경 변수 줄은 더 이상 쓰이지 않습니다.
  • 중복 실행 방지를 켜고 끄는 대신 잠금을 유지할 시간(분)으로 정합니다(0 = 끔). 기존 작업의 잠금 시간은 그대로 옮겨집니다.
  • 코어·확장이 등록한 예약 작업은 이름·유형·명령을 바꾸거나 삭제할 수 없습니다(사용 여부로 끕니다). 복제하면 운영자가 직접 등록한 작업으로 만들어집니다. 목록 행 메뉴의 「삭제」가 막혀 있을 때, 코어·확장이 등록한 작업이면 「직접 등록한 작업만 삭제할 수 있습니다.」, 삭제 권한이 없으면 「권한이 없습니다.」로 까닭을 구분해 안내합니다.
  • 「즉시 실행」이 예약 실행과 같은 경로로 돌아, 큐로 보내는 작업은 「큐에 넣었습니다」로 접수만 알리고, 실패한 실행도 결과 창에 그대로 보여 줍니다.
  • 활동 로그에는 관리자가 누른 수동 실행만 남기고, 스케줄러가 돌린 예약 실행은 실행 이력에만 남깁니다. 큐로 보낸 작업을 「즉시 실행」해도 활동 로그의 실행자·IP·브라우저 정보는 누른 관리자의 것으로 남습니다.

확장 개발자

  • 타입 검사 설정을 브라우저 코드(tsconfig.app.json, Node 타입 없음)와 시험(tsconfig.test.json, Node 타입과 Vitest 전역)으로 나눴습니다. 루트 tsconfig.json 은 둘을 잇기만 하므로 검사는 npx tsc -b 나 각 설정으로 합니다. 템플릿은 원본(templates/_bundled)만 검사하고, 설치된 사본(templates/<식별자>)은 검사하지 않습니다.
  • 확장 개발자용: 엔진 공개 타입에서 ActionDefinition 의 type, handler 와 ComponentDefinition 의 id 를 선택 필드로 바꿨습니다. 레이아웃 JSON 에서 실제로 생략하는 값이라 타입을 그에 맞춘 것이고, 동작은 같습니다.
  • 확장 개발자용: 템플릿 template.json 의 error_config.layouts 에 선택 키 default 를 둘 수 있습니다. 오류 코드에 맞는 레이아웃이 없으면 이 레이아웃으로, 그것도 없으면 엔진 내장 오류 화면으로 그립니다(다른 코드의 레이아웃으로는 대신하지 않음). 번들 템플릿 sirsoft-admin_basic 과 sirsoft-basic 은 공통 오류 화면(errors/default)을 등록해, 전용 오류 화면이 없는 오류(400, 422, 429, 502, 504 등)도 관리자 화면과 사이트 틀 안에 받은 코드, 새로고침 단추, 홈 단추로 보입니다.
  • 예약 작업 실행 후 훅 core.schedule.after_run 이 실패한 실행에서도 발행됩니다(결과는 이력의 상태로 구분). 실패만 다루려면 새 훅 core.schedule.run_failed 를 구독합니다. 큐 관리 화면의 재시도·삭제·정리 전후 훅(core.queue_job.*)과 허용 Job 클래스 필터 core.schedule.filter_allowed_job_classes 도 추가했습니다.
  • 확장의 getSchedules() 를 옛 형식(name 없음)에서 새 형식으로 바꾸면, 옛 형식이 명령에서 만들던 자동 이름의 스케줄을 새 name 으로 이어받습니다. 코어를 먼저 7.2.0 으로 올린 뒤 확장을 나중에 업데이트해도 그 사이 운영자가 바꾼 주기·사용 여부와 실행 이력이 남습니다(명령 문자열이 같을 때).
  • G7Core.websocket.subscribe() 가 구독마다 고유 키(채널:이벤트#번호)를 돌려줍니다(engine-v1.94.0). 그 키로 unsubscribe() 하면 자기 구독만 끊기고, 같은 채널·이벤트를 듣는 다른 화면·확장은 계속 받습니다. leaveChannel(channel) 은 채널명이 정확히 같은 구독만 정리합니다.
  • 템플릿 핸들러는 등록자를 템플릿 식별자로 밝혀 등록합니다(engine-v1.94.0). 엔진 기본 핸들러는 등록자 engine 입니다.
  • 확장 화면의 스타일은 확장이 자기 CSS 로 싣습니다. 템플릿 CSS 의 클래스(Tailwind 유틸리티·input·section-heading-md 같은 의미 클래스)에 기대지 않으므로, 템플릿이 어떤 CSS 라이브러리를 쓰든 확장 화면 모양이 같습니다. 그누보드7 은 Tailwind 를 전제하지 않습니다(2026-10-22 결정 7·8·14).
  • 레이아웃 편집기 프리뷰가 사용자 템플릿 CSS 의 층을 벗겨 층 없이 싣던 것을, 층 이름을 프리뷰 층(g7-preview) 하나로 모아 싣도록 바꿨습니다. 관리자 화면 머리가 @layer g7-preview, g7-extension; 을 선언해 프리뷰에서도 확장 CSS 의미 칸이 템플릿 초기화 규칙을 이깁니다(사용자 화면과 같은 우선순위).
  • 확장 CSS 의 우선순위를 세 칸으로 나눴습니다. 사용자·관리자·검색엔진용 화면의 <head> 가 템플릿 CSS 바로 뒤에 @layer g7-extension; 을 선언해 ① 확장 의미 클래스(@layer g7-extension)는 템플릿의 층 규칙보다 위·층 없는 규칙보다 아래, ② 확장 유틸리티는 층 없이 템플릿 뒤, ③ 템플릿의 확장 CSS 덮기 파일은 모든 확장 CSS 뒤에 옵니다(2026-10-22 결정 15).
  • namespace 를 선언한 확장의 CSS 는 서빙할 때 g7-extension·properties 층만 남기고 나머지 층 래퍼(빌드 도구가 만든 theme·utilities 등)와 층 순서 선언을 걷어 냅니다. 확장 병합 번들(/api/{modules|plugins}/bundle.css)과 개별 자산 서빙이 같은 처리를 합니다. namespace 를 선언하지 않은 확장 CSS 는 종전대로 내보냅니다.
  • 관리자 템플릿 교체 계약에서 「스타일 클래스」 항목을 뺐습니다. 확장 관리자 화면이 템플릿의 의미 클래스를 쓰지 않으므로 새 관리자 템플릿은 그 클래스를 갖출 필요가 없고, 대신 선택 계약으로 「확장 CSS 덮기」를 둘 수 있습니다.
  • 템플릿을 불러올 때 template.json 의 features.color_scheme(방식이 세 값 밖이거나 ancestor-class 에 selector 없음)과 extension_css_overrides(배열 아님, target·dist/ 아래 path 없음, 해석할 수 없는 targetVersion, 같은 target 중복) 형식을 검사합니다. 틀리면 필수 필드가 빠진 것과 같이 그 템플릿을 불러오지 않고 오류 로그를 남깁니다.
  • 확장 개발자용: vendor 묶음 명령(core:, module:, plugin: 의 vendor-bundle, vendor-verify 와 일괄 명령 vendor-bundle:build-all, vendor-bundle:verify-all)의 머리말, 결과 줄, 요약이 영어 고정 대신 사이트 언어(ko, en, ja)로 나옵니다. en 사이트의 문구는 종전과 같고, 크기는 묶음에 맞게 B, KB, MB 로 표기합니다.
  • 이번 판에 새로 들어온 코어 명령(custom:check, custom:example, custom:vendor-bundle, custom:vendor-verify, queue:prune-records, g7:schedule-run, core:deploy-ledger-seed 등)의 설명도 php artisan list 와 --help 에서 사이트 언어(ko, en, ja)로 나옵니다. 종전에는 이 명령들만 언어와 상관없이 한국어로 고정돼 있었습니다.
  • 관리자 메뉴 정의의 permission 키가 이제 동작에 쓰입니다. 확장이 선언한 역할이 그 권한을 가지면 메뉴가 그 역할에 붙습니다. permission 이 없는 단독 메뉴는 선언 역할에 붙지 않습니다.
  • 확장 개발자용: 템플릿 template.json 에 선택 필드 expose(첫 화면에 미리 실을 최상위 키 이름 목록)를 둘 수 있습니다. 선언한 키의 값만 페이지에 함께 실리고, 엔진이 앱을 시작할 때 읽는 키가 모두 실려 있으면 템플릿 설정을 따로 요청하지 않습니다. 선언이 없는 템플릿은 종전처럼 요청합니다. 선언이 배열이 아니거나 엔진이 읽는 키가 빠지면 설치·업데이트 결과에 경고가 나옵니다(설치는 그대로 됩니다, engine-v1.96.0).
  • 확장 개발 API: 메뉴 저장소 계약(MenuRepositoryInterface)에 메뉴 권한을 지우는 deleteMenuPermissions() 를 더하고, getAccessibleNavigationMenus() 에 이 서버가 불러온 모듈·플러그인 식별자를 받는 선택 인자 두 개를 더했습니다. 이 계약을 직접 구현한 클래스는 메서드를 추가하고 시그니처를 맞춰야 합니다.
  • 확장 개발 API: 코어 저장소 계약에 메서드를 더했습니다 — RoleRepositoryInterface·UserRepositoryInterface::deleteMenuPermissions(), LayoutRepositoryInterface·LayoutExtensionRepositoryInterface 의 삭제된 행 포함 조회(getWithTrashedBySource()·getWithTrashedByTemplateId())와 LayoutExtensionRepositoryInterface::forceDeleteRow(), LayoutExtensionVersionRepositoryInterface::getRecentVersionsWithContent(), LayoutPreviewRepositoryInterface::deleteByTemplateId(), NotificationTemplateRepositoryInterface::delete(), PermissionRepositoryInterface::getChildrenByParent(), ScheduleHistoryRepositoryInterface::deleteByScheduleIds(). LayoutVersionRepositoryInterface::getVersions()·IdentityVerificationLogRepositoryInterface::purgeOlderThan() 에는 선택 인자를 더했습니다. 이 계약을 직접 구현한 클래스는 메서드를 추가해야 합니다.

외부 인증 로그인(소셜 로그인 등)

  • 비밀번호가 없는 회원은 비밀번호 만료 정책 대상이 아닙니다 — 만료 안내 메일·만료 처리(토큰 회수)·로그인 변경 관문·관리자 지정 변경 요구에서 빠지고, 관리자 회원 상세의 비밀번호 정보는 「해당 없음」 으로 보입니다.
  • 비밀번호가 없는 회원의 이메일로 틀린 비밀번호 로그인을 반복해도 실패 횟수를 세지 않아 계정이 잠기지 않습니다(응답은 종전과 같은 「인증 실패」).
  • 받을 수 없는 대체 이메일(예약 최상위 도메인 .invalid, 외부 인증이 이메일을 주지 않을 때 쓰는 주소)은 이메일이 없는 것과 같게 다룹니다 — 메일 2단계 인증을 요구하지 않고, 메일 알림을 건너뛰며, 비밀번호 재설정 메일을 보내지 않습니다.
  • 레이아웃 컴파일러가 새 엔진 액션 loginHandoff 를 인식합니다.

회원 상태와 로그인 유지

  • 회원 상태(차단·탈퇴·휴면·가입 후 인증 대기)를 모든 API 가 같은 관문에서 다시 봅니다. 로그인한 뒤 차단된 회원은 확장 API 를 포함해 더 쓸 수 없고, 휴면·인증 대기 회원은 공개 목록·상세를 손님처럼 봅니다. 확장 라우트에 상태 검사를 따로 붙이지 않아도 됩니다.
  • 로그인 실패로 계정이 잠기는 순간 그 회원의 다른 기기 로그인도 모두 끊습니다.
  • 확장이 회원 저장 필터로 최고관리자 지정을 바꾸지 못하게 막고 경고를 남깁니다.

파일 서빙과 API 응답

  • 레이아웃 편집기를 열 때 확장마다 따로 보내던 편집기 스펙 요청을 한 번으로 묶었습니다. 새 공개 API GET /api/templates/{identifier}/editor-spec-bundle 가 활성 모듈과 플러그인, 템플릿의 스펙을 항목별 판정(정상, 비활성, 실패)과 함께 한 응답으로 돌려주고, 한 확장이 실패해도 나머지는 받습니다. 개별 API(/api/{templates|modules|plugins}/{identifier}/editor-spec)는 그대로 있습니다(engine-v1.95.0).
  • 파일 서빙 응답이 유형을 알 수 없는 파일을 내려받기(application/octet-stream)로 내보냅니다. 종전에는 저장 기록에 파일 유형이 비어 있는 첨부(구형 업로드·외부 이관)를 열면 서버 오류가 났습니다. 유형을 내용으로 추정하지 않으며, 브라우저의 유형 추측도 함께 차단합니다.
  • 사이트맵 응답이 세션 쿠키를 싣지 않습니다. 검색 엔진이 받는 공개 캐시 응답에 쿠키가 실리면 중간 캐시가 그 응답을 저장하지 않거나 잘못 재사용할 수 있었습니다.
  • API 경로의 「찾을 수 없음」·「접근 거부」·「일시 중단」 오류가 요청 형태와 무관하게 언제나 JSON 으로 응답합니다. 종전에는 이미지 태그처럼 브라우저가 직접 여는 요청에 HTML 오류 페이지가 나갔습니다. 재시도 간격 안내(Retry-After)는 그대로 전달됩니다.
  • 압축 협상(Accept-Encoding)의 가중치 해석을 규격에 맞췄습니다. 규격 밖 형태의 가중치는 무시하고, 같은 압축 방식의 두 이름(gzip·x-gzip) 중 하나라도 거부(q=0)하면 압축하지 않습니다.
  • 코어 업데이트에서 서버에 PHP zip 확장이 없을 때의 안내가 직접 설치와 공유 호스팅(호스팅 업체에 활성화 요청)을 함께 알립니다. 명령줄을 쓸 수 없는 공유 호스팅 운영자도 다음 행동을 알 수 있습니다.
  • 설치 진행 화면의 확장 작업 목록을 실제 설치 순서대로 그립니다. 모듈, 플러그인, 템플릿을 종류별로 나눠 보이던 묶음을 「확장 기능」 한 묶음으로 합쳐, 다른 종류에 의존하는 확장을 함께 설치할 때도 진행 표시가 위에서 아래로 차례로 채워집니다.

첫 화면 속도

  • 첫 화면을 열 때 템플릿 설정을 페이지에 함께 실어 보내고 화면 구성 요청을 앞당겨, 첫 화면이 더 빨리 뜹니다.

이미지 썸네일

  • 파일 서빙 헬퍼 streamedFileResponse()·streamedFileResponseFromMeta() 에 private 인자를 더했습니다. 켜면 production 은 private, max-age={n}, 그 밖의 환경은 private, no-cache 이고 304 도 같은 값입니다. 기존 호출은 그대로입니다.
  • 재설치에서 업로드 삭제를 고르면 이미지 썸네일도 함께 지웁니다.
  • 썸네일 규격 표(upload.thumbnail_presets)는 탭 저장으로만 바꿀 수 있습니다. 단건 저장(PUT /api/admin/settings/upload.thumbnail_presets)은 행 검증과 고정 규격 보충을 건너뛰므로 거부합니다.

방문자 통계

  • 캐시 드라이버가 Redis 처럼 여러 서버가 함께 쓰는 저장소(Redis·Memcached·데이터베이스)면, 같은 방문자에게서 동시에 들어온 수집 요청(탭 여러 개, 연이은 화면 이동, 서버 기록과 첫 비콘)을 차례로 저장합니다. 지금까지는 이런 요청이 데이터베이스에서 서로 막혀(교착) 한쪽을 되돌리고 다시 저장했는데, 이제 서로 막히지 않아 다시 저장하는 일이 없고 몰릴 때 응답도 빨라집니다. 다른 방문자끼리는 지금처럼 기다리지 않습니다. 파일 캐시는 서버마다 따로라 종전 방식(막히면 최대 3번 다시 시도)을 그대로 쓰며, 차례를 2초 안에 받지 못하거나 캐시 저장소에 문제가 생겨도 종전 방식으로 저장해 수집이 멈추지 않습니다.

환경설정 드라이버

  • 스토리지, 캐시, 세션, 큐, 로그 드라이버 저장과 연결 시험이 고정 목록 대신 드라이버 카탈로그(코어 + 플러그인 등록)로 판정합니다. 플러그인이 등록한 드라이버를 골라도 저장이 막히지 않습니다. 예전부터 받던 코어 값(캐시 memcached 등)은 그대로 받습니다.
  • 설정 저장 응답에 warnings(저장은 했지만 알려야 할 저장소 조합)가 실립니다.

확장 GitHub 설치·업데이트

  • 확장, 언어팩, 코어 업데이트 명령을 답할 수 없는 실행(cron, CI, --no-interaction, 예약 작업)에서 돌리면 서명 없는 패키지는 --allow-unsigned 없이 실패합니다. --force 와 --yes 는 이 확인을 대신하지 않습니다. 명령줄의 거절 문장에는 관리자 화면의 「미서명으로 계속」 단추 안내가 섞이지 않고 --allow-unsigned 안내만 나옵니다. 이런 명령을 예약해 두었다면 --allow-unsigned 를 붙이세요.
  • GitHub 에서 확장을 받을 때 태그 릴리스만 받습니다. 릴리스가 없는 저장소의 main, master 브랜치를 대신 받던 동작을 없앴고, 릴리스가 없으면 「태그 릴리스가 없습니다」로 실패합니다. 릴리스에 서명 파일(.sig.json)이 함께 올라와 있으면 그 ZIP 을 받아 검증합니다.

PHP 의존성

  • PHP 의존성 패키지를 최신 안정 버전으로 갱신했습니다 (Laravel 12.73.0, Reverb 1.14, Sanctum 4.5, Scout 11.11, Monolog 3.13, Guzzle 7.16.3 등 — 메이저 상승 없음). 오류 화면과 컴포넌트 속성의 스크립트 삽입(XSS), 기간 한정 서명 링크의 만료 판정 우회, 모델 대량 할당 보호 우회, 빈 입력칸을 이용한 파일 검증 우회, 존재·중복 검사 규칙의 조건 누락, 요청 주소의 호스트 해석, 로그 줄의 자리표시자 치환에 대한 상류 보안 수정이 함께 들어옵니다. Composer 를 실행할 수 없는 환경을 위한 코어 vendor-bundle.zip 도 같은 구성으로 다시 만들었습니다. 코어 업데이트가 vendor/ 를 새 구성으로 교체합니다.
  • 실시간 알림 서버(Reverb)는 한 연결이 구독할 수 있는 채널을 1,000개로 제한하고 164자를 넘는 채널 이름을 거절합니다. 그누보드7 이 쓰는 채널은 이 범위 안이라 동작은 같습니다.

Deprecated

  • TemplateService::deleteTemplate() 는 폐지 예정입니다(코어 안에 호출처가 없습니다). 템플릿 제거는 TemplateManager::uninstallTemplate() 를 씁니다. 공개 훅 core.templates.before_delete·after_delete 와 함께 다음 메이저에서 지웁니다.
  • 콜백 없이 부르는 G7Core.componentEvent.off(name) 과 componentEvent.clear() 는 폐지 예정입니다. 다른 화면·확장의 구독까지 지우므로 지금은 경고를 내고 종전대로 지웁니다. 구독할 때 받은 해제 함수나 off(name, callback) 을 쓰세요(engine-v1.94.0).
  • G7Core.websocket.unsubscribe() 에 채널:이벤트(번호 없는 키)를 넘기는 사용은 폐지 예정입니다. 지금은 그 채널·이벤트의 구독을 모두 끊고 경고를 냅니다. subscribe() 가 돌려준 키를 넘기세요(engine-v1.94.0).
  • 레이아웃에서 Tailwind 반응형 접두 클래스(sm:·md:·lg:·xl:·2xl:)와 폭에 따라 모양이 바뀌는 의미 클래스(관리자 filter-row·grid-2col-responsive·page-title 등과 확장의 같은 이름 사본)를 쓰는 방식은 폐지 예정입니다. 번들 레이아웃·부품은 더 쓰지 않고 정적 검사가 새 사용을 막습니다. 사이트에서 직접 고친 레이아웃과 사이트 자체 확장이 그대로 보이도록 지난 출시본 빌드 CSS 에 있던 반응형 접두 클래스(관리자 템플릿 705개 — 이커머스 모듈 CSS 가 싣던 3개 포함, 사용자 템플릿 693개)와 의미 클래스 정의는 빌드 CSS 에 이번 버전까지 남겨 두며, 다음 출시 이후 뺍니다. 직접 고친 레이아웃은 responsive 구간 값으로 옮깁니다(docs/frontend/responsive-layout.md).

Removed

  • 환경설정의 「점검 모드」 저장값(general.maintenance_mode)을 없앴습니다. 이 값은 어디에서도 읽지 않았고, 점검 모드는 php artisan down·php artisan up 이 맡습니다. 남은 저장값은 7.2.0 업그레이드가 지웁니다.

Fixed

  • 관리자 본인인증 정책 수정·삭제·항목 초기화, 스케줄 실행 이력 삭제, 레이아웃 버전 조회·복원 API 의 번호 자리에 숫자가 아닌 값을 보내면 404 대신 500 서버 오류가 나고 오류 로그가 쌓이던 문제를 고쳤습니다. 이제 404 로 답합니다.
  • 검색엔진 봇 화면의 홈과 검색 결과에서 상품 카드 링크가 쇼핑몰 경로 없이 /products/… 로 나가 404 이던 문제를 고쳤습니다. seo-config.json 의 fields 링크 base_url 이 $prop:이름(그 컴포넌트가 받은 prop, 사람 화면과 같은 값)을 받고, $global:이름 은 렌더 문맥의 _global 값을 먼저 읽습니다. 화면마다 meta.seo.vars 를 두지 않아도 되며, 앞 화면의 meta.seo.vars 가 다음 렌더에 남지 않습니다.
  • 7.1.5 변경 내역에 부팅 측정 사용법을 php artisan g7:bench --axis=boot --uri=… 로 잘못 적었습니다. --uri 옵션은 없으며, 측정할 대상은 --profile=… 로 고릅니다.

레이아웃·확장 업데이트

  • 확장 파일을 교체하는 동안 들어온 요청이 옛 확장 선언으로 훅 정보를 다시 만들어, 교체 쪽이 새 선언으로 만든 훅 정보를 덮던 경합을 고쳤습니다(지운 리스너가 되살아나 다음 갱신 전까지 실행됨). 이제 옛 선언을 쥔 프로세스는 훅 정보를 쓰지 않고 다음 요청이 새 선언으로 만듭니다.
  • 모듈·플러그인 새 판이 훅 리스너 클래스를 지운 판이면, 업데이트가 파일을 교체한 뒤 훅 정보를 다시 만들기 전 몇 초 사이에 들어온 요청이 지워진 파일을 찾다 오류 화면(500)을 내던 문제를 고쳤습니다. 새 판에서 지워지는 클래스 파일은 훅 정보를 새 판 기준으로 다시 만들고, 진행 중이던 요청이 모두 끝날 만큼 시간이 지난 뒤 예약 작업 「업데이트 잔존물 정리」가 지웁니다(GitHub·ZIP·번들 업데이트, 같은 판 강제 재설치 --force, extension:reset-files-from-bundled 모두).
  • 확장 업데이트가 DB 판을 새 판으로 적은 뒤(업그레이드 스텝·레이아웃 갱신 도중) 프로세스가 죽으면, 다음 module|plugin|template:update(--force 없이)가 「업데이트 없음」으로 끝나 남은 스텝·레이아웃 갱신이 영영 돌지 않던 문제를 고쳤습니다. 이제 그 서버에 끝나지 않은 업데이트 기록이 남아 있으면 판과 --force 이어받기 명령을 알리고 종료 코드 1 로 끝납니다.
  • 템플릿 업데이트가 실패해 상태를 되돌린 뒤 상태 캐시를 비우지 않아, 템플릿이 정상인데 그 화면이 캐시 만료까지 빠질 수 있던 문제를 고쳤습니다.
  • 운영자가 지운 화면과 같은 이름으로 새 화면을 만들면 다음 템플릿 갱신이 그 화면을 템플릿 출신으로 보고 지우던 문제를 고쳤습니다.
  • 운영자 수정 유지(keep)로 갱신·업데이트할 때 겹친 곳만 있어 본문이 그대로인 화면·조각에도 버전 이력을 남겨, [버전 기록]에 같은 내용의 판이 두 줄씩 쌓이던 문제를 고쳤습니다. 본문이 바뀐 병합에만 버전을 남기고, 겹친 곳은 업데이트 결과와 활동 로그로 알립니다.
  • 대시보드 호환성 알림에서 이미 없는 확장을 [다시 활성화]하면 「확장(:identifier) 을 찾을 수 없습니다.」처럼 자리표시자가 그대로 보이던 문제를 고쳤습니다. 이제 찾지 못한 확장 식별자를 보입니다.

환경설정·첨부

  • php artisan settings:migrate-to-json 을 한 번 실행하면(터미널 없이 실행해도, 확인 질문 없이) 사이트 이름·사이트 주소·관리자 이메일·메일 발신자·드라이버·업로드·보안 설정이 모두 기본값으로 덮이던 문제를 고쳤습니다. 옮길 이전 설정이 없고 설정 파일이 이미 있으면 아무것도 바꾸지 않고 그 사실을 알립니다. 기본값으로 되돌리기는 --force 와 확인(대화형 「예」 또는 --yes)이 함께 있을 때만 하며, 확인에 답할 수 없는 실행은 바꾸지 않고 실패로 끝납니다. 이전 설정을 옮기거나 되돌리기 전에 기존 설정 파일 사본을 storage/app/settings/backups/ 에 남깁니다.
  • 업로드 탭의 「미참조 첨부 자동 정리」를 켜면 보존기간이 지난 뒤 SEO 탭의 기본 공유 이미지가 지워지던 문제를 고쳤습니다. 정리에서 보호하는 첨부를 설정 선언에서 모두 찾도록 바꿔 기본 공유 이미지·파비콘·템플릿 설정 첨부(템플릿을 지웠어도 남겨 둔 설정 포함)를 보호합니다.
  • 환경설정 일반 탭에서 사이트 이름·로고를 바꿔도 검색엔진용 화면에는 캐시 유효기간이 끝날 때까지 옛 값이 나가던 문제를 고쳤습니다. 일반 탭 저장과 템플릿 설정 저장도 검색엔진용 화면 캐시를 비웁니다.
  • 환경설정을 저장한 직후 관리자 화면 상단 로고가 새로고침 전까지 사라지던 문제를 고쳤습니다.
  • 코어 업데이트가 운영자가 직접 넣은 public/favicon.ico 를 매번 빈 파일로 덮어쓰던 문제를 고쳤습니다. 이제 내용이 있는 운영자 파일은 그대로 두고, 빈 파일(이전 기본값)만 새 기본 아이콘으로 바꿉니다. 7.1.x 에서 올리는 이번 업데이트는 이전 판이 파일을 적용해 운영자 파일이 한 번 새 기본 아이콘으로 덮이지만, 업데이트가 마무리하며 업데이트 전 백업에서 그 파일을 되살립니다. 백업 없이(--no-backup) 올렸다면 되살릴 원본이 없으니 파일을 다시 올려 주세요.

템플릿 엔진

  • 레이아웃 scripts[] 에 조건({{...}})을 단 스크립트가 조건이 참이어도 로드되지 않던 문제를 고쳤습니다.
  • 화면을 옮길 때 나오는 기본 전환 스피너가 다크 모드에서도 밝은 회색 배경으로 그려지던 문제를 고쳤습니다.
  • 같은 화면의 다른 항목(클레임, 게시글, 상품 수정 등)으로 옮길 때 응답이 늦으면, 새 화면의 링크와 속성이 최대 30초 동안 앞 항목을 가리키던 문제를 고쳤습니다(engine-v1.95.0).
  • 레이아웃 편집기의 오류 처리 행에서 「설정 안 함」을 고르거나 [덮기] 뒤 동작을 고르지 않고 저장하면, 그 오류가 나도 아무 일도 하지 않고 상위 레이아웃의 기본 처리(예: 로그인 화면으로 이동)와 데이터 소스의 오류 처리까지 막히던 문제를 고쳤습니다(engine-v1.95.0). 레이아웃 저장 요청과 버전 복원도 동작이 빈 항목을 지우므로, 고치기 전에 저장한 버전을 복원해도 같은 문제가 되살아나지 않습니다.
  • 레이아웃 편집기에서 세로로 병합한 칸이 있는 표에 열을 넣거나, 행을 지우거나 옮기면 표 칸이 어긋나던 문제를 고쳤습니다. 머리글과 본문을 가로지르는 세로 병합은 막습니다(engine-v1.95.0).
  • 레이아웃 편집기 페이지 설정의 오류 처리에서 템플릿 설정의 처리를 이 페이지에서 바꾸는 [덮기] 단추가 나오지 않고, 레이아웃이 따로 정한 오류 코드가 목록에 보이지 않던 문제를 고쳤습니다(engine-v1.95.0).
  • 확장 개발자용: 개발자 도구(DevTools)의 Sequence 탭과 Stale Closure 탭이 비어 나오던 문제, 스타일 이슈에 id 가 없던 문제, Actions 탭과 Named Actions 참조 이력 탭에 필터 글자를 넣으면 화면이 깨지던 문제, 라이프사이클 추적이 id 없는 컴포넌트를 한 칸에 덮어 마운트 목록이 틀리던 문제, computed 의존성 종류를 계약 밖 값(_local)으로 기록하던 문제를 고쳤습니다.
  • 목록처럼 반복해서 그리는 요소 자체에 화면 폭별 설정(반응형 클래스, 이미지 규격, 문구, 표시 조건)을 둔 경우, 창 크기만 바꾸면 이전 폭의 설정이 남아 있던 문제를 고쳤습니다. 이제 창 크기를 바꾸는 즉시 해당 폭의 설정이 적용되고, 같은 폭 구간 안에서 창 크기를 바꿀 때는 목록을 다시 그리지 않습니다. (engine-v1.95.0) 확장이 만든 표와 카드 컴포넌트 안 칸에 둔 화면 폭별 설정도 창 크기를 바꾸면 바로 따라갑니다.
  • 서버가 잠깐 오류를 내는 순간 새로고침하면 로그인돼 있던 관리자나 회원이 로그인 화면으로 가던 문제를 고쳤습니다. 이제 확인이 늦어지면 화면 위쪽에 로그인 상태를 확인하는 중이라는 안내를 띄우고 잠시 다시 확인하며, 그래도 서버가 답하지 않으면 그 안내를 이어서 보여 주다가 로그인 화면 대신 잠시 뒤 다시 시도하라는 안내와 새로고침 단추를 보여 주고 로그인 상태는 그대로 둡니다(engine-v1.95.0).
  • 상품 수정처럼 입력을 잠시 모아 저장하는 폼에서 값을 친 직후 다른 화면으로 옮기면, 드물게 새 화면 칸에 앞 화면에서 친 값이 남던 문제를 고쳤습니다(engine-v1.95.0).
  • 언어를 바꾸면 키보드 포커스가 화면 맨 앞으로 빠져 다시 찾아가야 하던 문제를 고쳤습니다. 이제 언어를 바꾼 단추나 칸에 포커스가 그대로 남습니다(engine-v1.95.0).
  • 오류 화면이 준비되지 않은 오류(예: 잘못된 요청)가 나면 화면이 그대로 멈춰 보이던 문제를 고쳤습니다. 이제 기본 오류 안내와 새로고침 단추를 보여 줍니다(engine-v1.95.0).
  • 상태를 바꾼 직후 화면 데이터를 다시 불러오면 바뀌기 전 값으로 요청되던 문제를 고쳤습니다(engine-v1.95.0).
  • 마이페이지에서 이동해 들어온 클레임 신청과 신청 상세 화면이 상품이나 원 주문 정보 없이 비어 보이던 문제를 고쳤습니다(engine-v1.95.0).
  • 서버 요청이 몰려 요청 제한(429)에 걸린 순간 로그인 상태 확인이 실패해 로그아웃되던 문제를 고쳤습니다. 이제 잠시 뒤 다시 확인하고 로그인을 유지합니다(engine-v1.95.0).
  • 느린 서버에서 화면 구성(레이아웃) 요청이 15초를 넘으면 정상 응답도 끊고 「페이지 로딩 실패」를 보이던 문제를 고쳤습니다. 이제 다른 요청과 같은 30초까지 기다립니다(engine-v1.95.0).
  • 레이아웃 편집기에서 요소의 표시 조건만 바꾸면 미리보기에 바로 반영되지 않던 문제를 고쳤습니다(engine-v1.95.0).
  • 레이아웃 편집기를 창 12801440 에서 열면 미리보기 때문에 가로 스크롤이 생기던 문제를 고쳤습니다. 이제 창 10241920 에서 미리보기는 남는 폭에 맞춰 줄고, 툴바는 좁으면 두 줄로 감깁니다. 줌을 내리면 선택 상자와 손잡이가 요소와 어긋나던 문제도 함께 고쳤습니다(engine-v1.95.0).
  • 내 정보 수정 화면에 들어가 비밀번호 확인 칸에 바로 입력하면, 입력 도중 회원 정보가 도착하는 순간 친 글자가 지워지고 [확인]에 「비밀번호가 일치하지 않습니다.」가 뜨던 문제를 고쳤습니다. 화면 데이터가 늦게 도착하거나 다시 받아지는 다른 폼(주문서의 받는 분·주소 칸 등)에서도 그 순간 친 글자가 지워지지 않습니다. 7.0.0-beta.2 부터 있던 문제입니다.
  • 저장·삭제 같은 서버 요청이 실패했는데 서버가 안내 문구를 주지 않으면(빈 응답의 500, 항목별 오류만 있는 422, 게이트웨이 오류 화면 등) 한국어 화면에도 API call failed: … 영어 알림이 뜨던 문제를 고쳤습니다. 이제 현재 언어로 「요청을 처리하지 못했습니다. 잠시 뒤 다시 시도해 주세요.」를 띄웁니다(core.errors.api_request_failed, engine-v1.94.0). 서버가 안내 문구를 주면 종전대로 그 문구를 씁니다.
  • 같은 채널·이벤트를 두 화면·확장이 실시간(WebSocket) 구독하면 두 번째 구독이 소식을 받지 못하고, 한쪽이 구독을 끊으면 다른 쪽도 끊기던 문제를 고쳤습니다(engine-v1.94.0).
  • 언어를 바꾼 뒤 같은 이름의 핸들러를 템플릿 대신 플러그인 것이 쓰던 문제를 고쳤습니다. 언어 전환 뒤에도 처음 접속할 때와 같은 순서(모듈 → 플러그인 → 템플릿)로 다시 등록합니다(engine-v1.94.0).
  • 화면의 한 부분이 「컴포넌트 로드 실패」로 깨진 뒤 같은 화면에서 탭을 옮기거나(예: 히어로섹션 관리의 위치 탭) 같은 종류의 다른 항목으로 옮겨도, 새로고침하기 전까지 그 박스가 그대로 남던 문제를 고쳤습니다. 이제 탭이나 주소가 바뀌면 그 부분을 다시 그려 정상 데이터면 바로 보입니다. 옮긴 곳의 데이터도 깨져 있으면 박스가 다시 뜨고, 같은 탭을 다시 눌러도 되풀이해 그리지 않습니다. 정상으로 보이던 다른 부분은 다시 그리지 않습니다. 7.0.0-beta.1 부터 있던 문제입니다.

사이트맵

  • 사이트맵의 상품 주소가 화면과 다른 상품 번호(/shop/products/{id})로 나가던 것을 화면과 같은 상품 코드 주소로 고쳤습니다.
  • 사이트맵을 만들 때마다(환경설정 SEO 의 [지금 생성], 상품 저장처럼 사이트맵을 다시 만드는 동작 포함) 오류 로그가 한 건씩 남던 문제를 고쳤습니다. 코어가 모든 템플릿에 넣는 미리보기 주소를 사이트맵 후보에서 화면 구성을 읽기 전에 빼고, 검색 엔진 봇이 미리보기 주소를 열 때도 검색 엔진용 화면을 만들려다 오류를 남기지 않습니다. 사이트맵에 실리는 주소는 그대로이고, 화면 구성을 읽지 못한 일반 화면은 종전처럼 오류로 기록합니다.

스케줄 관리

  • 스케줄 목록에서 검색어 검색이 동작하지 않던 문제, 모듈 필터에 「전체」만 나오고 걸러지지 않던 문제, 일괄 「실행」 선택이 아무 동작도 하지 않던 문제(선택 제거), 필터를 바꿀 때마다 바로 다시 조회되고 초기화가 다른 상태까지 지우던 문제(검색 버튼·Enter 로 조회), 화면 머리의 새로고침 버튼이 동작하지 않던 문제를 수정했습니다.

알림 발송 로그·알림 정의

  • 확장을 업데이트하면 운영자가 알림 설정에서 바꾼 발송 수단이 확장의 기본값으로 되돌아가던 문제를 수정했습니다
  • 알림 발송 로그에서 검색 대상을 「수신자」나 「제목」으로 골라도 전체 항목에서 검색되던 문제를 수정했습니다. 상태·확장 유형을 여러 개 골랐을 때 첫 번째 값만 적용되던 문제와, 목록의 수신자·발신자를 눌러 그 사람의 발송 이력만 보려 해도 걸러지지 않던 문제도 함께 수정했습니다.
  • 알림 발송 로그 조회 조건이 잘못됐을 때 오류 문구에 내부 키 대신 항목 이름(검색 대상·상태 등)이 보이도록 했습니다.
  • 환경설정 > 알림 정의 목록이 서버가 받지 않는 검색 대상 값을 함께 보내던 쓰이지 않는 조회 조건을 정리했습니다.

관리자 로그인·최고관리자 판정

  • 관리자 로그인 화면에 관리자가 아닌 회원이 맞는 비밀번호로 들어오면, 휴면이 풀리고 로그인 완료 처리(장바구니 병합 등)와 2단계 인증 메일 발송까지 한 뒤에야 거절하던 문제를 고쳤습니다. 이제 그 전에 거절하므로 휴면 상태가 그대로 남고 메일도 가지 않습니다(안내 문구는 「관리자 권한이 필요합니다」).
  • 관리자 환경설정 > 보안 > [키 재생성] 이 비밀번호 확인 뒤 마지막 단계에서 「해당 역할이 없습니다.」 로 늘 거절되던 문제를 고쳤습니다. 서버가 설치에 없는 역할을 검사하고 있었습니다. 이제 최고관리자 계정이면 재생성되고, 최고관리자가 아닌 관리자에게는 「최고관리자만 할 수 있는 작업입니다.」 를 보여 줍니다.
  • 관리자 로그인의 인증번호 재발송이 관리자가 아닌 회원의 인증 요청을 받으면 인증번호를 다시 보낸 뒤에 거절하던 순서를 고쳤습니다. 이제 보내기 전에 거절하고, 원래 받은 인증번호도 그대로 쓸 수 있습니다.
  • 방문 통계의 「관리자 제외」 가 관리자 역할 없이 최고관리자 표지만 가진 계정의 방문을 일반 회원 방문으로 세던 문제를 고쳤습니다. 설치에 없는 역할 이름으로 최고관리자를 판정하고 있었습니다.

회원 가입

  • 본인인증 정책으로 가입 전이나 가입 직후 메일 인증번호를 확인하고 가입한 회원이 관리자 회원 상세에 「이메일 인증: 미인증」으로 보이던 문제를 고쳤습니다. 이제 메일로 그 이메일을 확인한 가입은 이메일 인증으로 기록됩니다(휴대폰 같은 다른 수단으로 확인한 가입은 기록하지 않습니다).

회원 로그인 유지

  • 사용자 화면에서 로그인 토큰 갱신(POST /api/user/auth/refresh)과 같은 묶음의 내 정보 조회·로그아웃(/api/user/auth/user, logout, logout-all-devices)이 모든 회원에게 「해당 권한이 없습니다」(403)로 거절되던 문제를 고쳤습니다. 이 경로들이 요구하던 역할 권한을 코어가 선언한 적이 없어 어떤 회원도 가질 수 없었습니다 — 7.1.5 에서 갱신 주소를 바로잡은 뒤에도 갱신이 늘 실패해, 토큰이 만료될 때 다시 로그인해야 했습니다. 이제 로그인한 본인이면 쓸 수 있습니다(비로그인은 401). 업데이트 뒤 따로 할 일은 없습니다.

확장 캐시

  • 모듈·플러그인을 업데이트하는 동안 다시 만들어진 본인인증 정책 색인이 업데이트가 끝난 뒤에도 남아, 캐시 수명(기본 1시간) 동안 그 확장의 본인인증 정책이 걸리지 않던 문제를 고쳤습니다. 이제 확장 상태가 바뀌는 모든 경우(설치, 제거, 활성화, 비활성화, 업데이트 완료와 실패 되돌림)에 색인을 비웁니다. hook 범위 정책을 판정하다 색인을 읽지 못하면 정책 표로 직접 판정합니다.
  • 모듈·플러그인을 비활성화하거나 제거해도 그 확장이 캐시에 바로 저장(put·putMany)한 값이 남던 문제를 고쳤습니다. 캐시 비우기가 키 목록에 적힌 값만 지우는데, 바로 저장한 값은 키 목록에 적히지 않았습니다(예: SSO 플러그인을 다시 설치하면 IdP 연속 실패 알림이 이전 IdP 의 알림 억제 기록에 막힘). 이제 바로 저장한 값도 키 목록에 적고, 키 목록 항목에 만료 시각을 두어 지난 항목을 정리하며, 키 목록을 64조각으로 나눠 키가 많은 확장(게시판 조회수 중복 방지)에서도 저장 한 번이 한 조각만 고칩니다. 코어 캐시는 비우기 호출처가 없어 전과 같습니다.

화면 엔진

  • 관리자 목록 표의 칸 안에서 레이아웃 계산값이 늘 비어 보이던 문제를 고쳤습니다. 이커머스 상품 목록 판매가 칸의 다른 통화 금액 줄이 나오지 않던 것이 이제 나오고, 표 안 버튼의 사용 가능 여부처럼 계산값으로 정하던 표시가 맞게 그려집니다. 표의 펼친 행 안도 같습니다.
  • 확인 문구를 조건에 따라 묻는 버튼에서, 묻지 않아야 할 때 빈 확인 창이 뜨던 문제를 고쳤습니다. 확인 문구가 빈 값으로 정해지면 창 없이 바로 실행합니다.

확장 제거

  • 모듈·플러그인을 「데이터까지 삭제」로 제거해도 그 확장이 만든 역할이 남던 문제를 고쳤습니다. 다른 확장이 모든 역할에 붙이는 권한(예: 이커머스의 회원 권한)이 그 역할에도 붙어 있으면 지우지 않았습니다. 이제 데이터까지 삭제할 때는 그 확장의 역할을 권한·메뉴·회원 연결과 함께 지웁니다. 데이터를 남기는 제거는 전과 같이 역할을 그대로 둡니다.
  • 켜진 모듈, 플러그인, 템플릿을 제거하면 먼저 비활성화(직전과 완료 훅 포함)를 거칩니다. 의존 확장이나 마지막 활성 템플릿 검사에 막히면 끄지 않고, 제거가 실패하면 꺼진 채 남습니다. 큐 워커 재시작 신호는 이제 세 확장 종류 모두 설치, 활성화, 업데이트, 제거 때 보냅니다. template:uninstall 도 관리자 화면처럼 유형의 마지막 활성 템플릿은 지우지 않고 종료 코드 1 로 끝나며(--force 로도 건너뛰지 않음), template:deactivate 는 마지막 활성 템플릿을 기본으로 끄지 않고 --force 를 주면 종전처럼 끄고 경고합니다.
  • DB 에는 설치돼 있는데 활성 디렉토리만 사라진 모듈, 플러그인, 템플릿을 되살릴 길이 없던 문제를 고쳤습니다(업데이트는 「찾을 수 없습니다」, 설치는 「이미 설치되어 있습니다」). 이제 번들 소스(--source=bundled)나 기본 소스로 업데이트하면 원본을 복사해 활성 디렉토리를 되살린 뒤 업데이트하고, 활성 상태는 그대로입니다.

확장 개발

  • 확장 개발자용: 레이아웃 시험 도구 createLayoutTest 가 고정물의 state 로 initialState 를 덮어써 초기 상태를 줘도 효과가 없던 문제와, 초기값이 null 인 상태를 병합할 때 TypeError 로 멈추던 문제를 고쳤습니다. 이제 실제 화면과 같은 규칙으로 초기 상태를 만듭니다.
  • 레이아웃 확장의 확장점이 모달 고정 하단(footer)과 제목 앞뒤 붙임 안에서 채워지지 않고, 오버레이가 모달 창(본문, 고정 하단, 제목 붙임)의 노드를 겨누지 못하던 문제를 고쳤습니다.
  • 확장 개발자용: 확장 테스트가 개발 사이트에 설치된 예전 확장 사본의 외부 패키지를 먼저 읽거나, 테스트 중 확장 오토로드를 다시 등록하면 설치본 코드로 바뀌어, 번들 사본에서 바꾼 내용이 테스트에 반영되지 않던 문제를 고쳤습니다. 이제 확장 테스트는 번들 사본을 계속 씁니다.
  • 확장 개발자용: IP 접근 제한이 기본으로 빼 주는 확장 웹훅 경로가 단수형 webhook 만 덮어, 복수형 webhooks 경로로 통보를 받는 확장 웹훅은 운영자가 IP 규칙을 켜면 403 으로 막혔습니다. 이제 plugins/*/webhooks/*, api/plugins/*/webhooks/* 도 기본으로 빠지므로 이 경로의 웹훅은 제외 경로 훅을 따로 등록하지 않아도 통보를 받습니다. 관리자 영역은 전과 같이 뺄 수 없습니다.
  • 확장 개발자용: php artisan api:docgen 으로 기존 API 문서를 다시 만들면 자동 생성 블록 밖에 직접 쓴 서술(문서 머리말과 요약, 엔드포인트 앞 소제목과 설명)이 지워지거나 기본 문구로 바뀌고, 직접 더한 표 행과 허용값이 자리를 잃던 문제를 고쳤습니다. 이제 다시 만들어도 직접 쓴 서술은 그대로 남습니다.

코어 업데이트

  • 7.1.x 에서 코어를 업데이트할 때 번들 확장 일괄 업데이트가 메모리 부족으로 중간에 멈춰 사용자 템플릿과 언어팩이 옛 판으로 남고, 결과가 「성공 0, 실패 1」로만 나오던 문제를 고쳤습니다. 이제 확장과 언어팩을 하나씩 따로 처리해 끝까지 진행하고, 실제 성공 수, 실패 수와 함께 업데이트하지 못한 항목과 다시 실행할 명령을 보여 줍니다.
  • 템플릿 업데이트가 화면(레이아웃) 갱신 도중 중단되면 템플릿 버전은 새 버전으로 표시되는데 화면은 옛 모양으로 남고, 「업데이트 확인」으로도 다시 업데이트할 수 없던 문제를 고쳤습니다. 이제 화면 갱신을 마친 뒤에 새 버전을 기록하므로, 중단되면 옛 버전으로 남아 「업데이트 확인」 뒤 다시 업데이트할 수 있습니다.
  • 확인 질문에 답할 수 없는 실행에서 진행 확인이 필요한 명령이 멈출 때(7.1.6 부터 종료 코드 1) 일반 경고 대신 작업하지 않은 사유와 그 명령에 맞는 진행 방법(--yes, 명령에 따라 --force)을 출력합니다. 대상은 core:update, module:·plugin:·template: 의 update·uninstall, language-pack:uninstall, analytics:anonymize, analytics:purge, analytics:purge-extension, hotfix:rollback-stale-files --prune, settings:migrate-to-json 입니다. 방문자 통계 삭제(analytics:purge, analytics:purge-extension)는 되돌릴 수 없어 --confirm 만으로는 확인을 대신하지 않으며, 확인 없이 지우려면 --yes 를 함께 붙입니다.
  • 서버 관리자(root) 권한으로 코어·확장·언어팩을 업데이트하거나 설치하면, 그 작업이 처음 만든 폴더·파일이 root 소유로 남아 웹 서버가 읽거나 쓰지 못하던 문제를 고쳤습니다(관리자 화면의 설정 저장이나 다음 업데이트가 실패할 수 있었습니다). 이제 root 로 실행한 업데이트·설치 명령은 끝날 때 사이트 폴더에 남은 root 소유 항목을 바로 위 폴더의 소유자·그룹으로 되돌리고, 웹 서버가 쓸 수 있게 그룹 권한을 맞춥니다. 서버 명령을 쓸 수 없는 호스팅과 관리자 화면 업데이트는 root 파일을 만들지 않으므로 해당하지 않습니다.

설치 마법사

  • 기존 설치가 감지된 DB 에 [강제 진행]으로 다시 설치할 때, 앞 설치가 남긴 모듈·플러그인 폴더가 있으면 그 확장 설치가 「기본 데이터 생성(…)에 실패해 설치를 취소했습니다: … is not instantiable」로 매번 실패하던 문제를 고쳤습니다. 관리자 화면에서 폴더만 남아 있던 확장을 설치할 때도 같았습니다. 이번 설치에서 아직 설치 전인 다른 플러그인(예: 히어로섹션) 폴더가 남아 있어도 모듈 활성화가 같은 오류로 한 번씩 실패하던 경우도 고쳤습니다 — 다시 설치할 때(테이블을 지우는 경우와 새 DB 에 설치하는 경우 모두) 앞 설치의 확장 캐시를 함께 비웁니다.
  • 터미널 설치(php g7-install)가 오래 걸리는 단계(템플릿 활성화 등) 뒤에 다른 설치 작업이 없는데도 「다른 설치 작업이 잠금을 넘겨받아 이 설치를 멈춥니다」로 끝나던 문제, 그렇게 멈춘 설치를 --resume 으로 이어 갈 때 이미 끝난 활성화를 실패로 읽어 같은 자리에서 계속 멈추던 문제를 고쳤습니다.
  • 웹 설치가 중간에 끊긴 뒤 설치를 다시 시작하거나 중단하려 해도 응답이 없던 문제(서버를 다시 시작해야 풀리던 상태 파일 잠금)를 고쳤습니다.
  • 웹 설치 마법사를 「호환성 모드(폴링)」로 진행하면 설치가 끝난 직후 사이트와 관리자 화면이 「데이터베이스 계정 설정 오류」로 열리지 않던 문제를 고쳤습니다. 설치 마지막 단계의 설정 정리가 끝난 뒤에 최종 설정을 반영하고, 설정 캐시를 반영된 값으로 다시 만듭니다.
  • 터미널 설치(g7-install)가 마지막 설정 반영 뒤 설정 캐시를 웹 설치와 같은 방식으로 다룹니다. 반영 전에 캐시를 지우고 반영 뒤 늘 새로 만들며, 만들지 못하면 캐시 없이 끝냅니다. 전에는 캐시를 다시 만들지 못하면 설치 미완료 값이 든 캐시가 남을 수 있었습니다.

관리자 메뉴

  • 확장이 만든 역할(이커머스 관리자, SSO 운영자 등)만 가진 운영자의 관리자 왼쪽 메뉴가 「접근 가능한 메뉴가 없습니다」로 비던 문제를 고쳤습니다. 확장을 설치하거나 업데이트하면 그 역할이 가진 권한으로 열 수 있는 확장 메뉴가 그 역할에 붙습니다. 이미 운영 중인 사이트는 7.2.0 업데이트 때 채워집니다. 운영자가 역할 관리나 메뉴 관리에서 그 역할에서 뺀 메뉴는 다시 붙지 않습니다.

다국어

  • 코어 선언 재동기화(core:resync-declarations)나 언어팩 판이 함께 오르지 않는 코어 업데이트가 코어 메뉴(하위 메뉴 포함)·권한·역할의 언어팩 이름(예: 일본어)을 지워, 일본어 관리자 메뉴가 영어로 보이던 문제를 고쳤습니다. 재동기화가 켜진 언어팩의 번역을 함께 맞추며, 운영자가 고친 메뉴·역할 이름은 종전처럼 그대로 둡니다.
  • 코어 언어팩(예: 일본어)을 껐다 켜면 확장 메뉴·권한·역할·알림의 그 언어 이름까지 지워져, 확장 언어팩이 켜져 있는데도 관리자 메뉴가 원문(영어 등)으로 보이던 문제를 고쳤습니다. 코어 언어팩을 끌 때는 코어 항목의 번역만 걷습니다. 이미 지워진 사이트는 해당 확장 언어팩을 껐다 켜면 되살아납니다.
  • 의존하는 모듈·플러그인이 꺼져 있거나 설치되지 않았을 때의 안내가 「"…"이(가)」처럼 조사를 괄호로 남겨 보이던 한국어 문구를 고쳤습니다.
  • DB 에는 켜진 채 남았지만 파일이 지워진 모듈이나 플러그인이 있으면, 언어팩 설치, 업데이트, 켜기가 그 확장의 시더 실패로 「일부 항목 실패」와 종료 코드 1 로 끝나던 문제를 고쳤습니다. 그런 확장의 시더는 건너뜁니다.
  • 설치 마법사의 영어 안내에 남아 있던 괄호 복수 표기(「the server is missing the PHP extension(s)」, 「development package(s)」, 「leftover file(s)」, 확장 선택 요약의 「module(s)」 등)와 템플릿 제거 명령의 「version(s) deleted」 를 자연스러운 문장으로 고쳤습니다. 7.1.5·7.1.6 의 정리는 코어 안내만 다뤘습니다.

코어 업데이트·예약 작업

  • 코어 업데이트가 중간에 끊겼을 때(서버 시간 제한·강제 종료 등) 내려받아 풀어 둔 새 버전 폴더가 지워지지 않고 계속 쌓이던 문제를 수정했습니다. 릴리스 한 벌 크기의 폴더가 남는데도 정리 대상이 아니었습니다. 이제 사흘이 지난 폴더는 다른 임시 산출물과 함께 자동 정리되며, 진행 중인 업데이트의 폴더는 건드리지 않습니다.

서버 명령이 제한된 호스팅

  • Composer 실행 같은 서버 명령이 차단된 호스팅에서, 그 명령을 부르는 지점이 사유 없이 오류로 끝나던 문제를 수정했습니다. 이제 사용할 수 없다는 사실을 먼저 확인하고 다른 방식(번들 의존성)으로 넘어가거나, 넘어갈 수 없으면 사유를 안내합니다.
  • 일부 PHP 함수가 차단된 호스팅에서 설치 화면이나 사이트가 백지로 나오던 문제를 수정했습니다.

파일 서빙과 캐시

  • hook 범위 본인인증 정책 core.attachment.before_download_action 이 코어 첨부 이미지의 화면 표시와 썸네일에는 적용되지 않던 문제를 고쳤습니다. 이 액션 훅이 이미지 표시 요청에서도 요청당 한 번 발화하므로, 이 훅을 구독하는 확장은 이미지 표시 요청에서도 호출됩니다. 켜진 정책이 없는 훅은 캐시된 정책 색인으로 데이터베이스 조회 없이 통과합니다.
  • 코어 첨부(/api/attachment/{hash})에서 이미지가 아닌 파일을 내려받을 때 필터 훅 core.attachment.before_download 가 한 요청에 두 번 돌던 문제를 고쳤습니다. 이제 이미지 표시, 내려받기, 썸네일, 조건부 요청(304) 모두 이 필터와 액션 훅 core.attachment.before_download_action 이 요청당 한 번만 돕니다. 이 필터로 내려받기 횟수를 세던 확장은 한 번에 2씩 오르던 값이 1씩 오르게 됩니다. 이미지가 아닌 파일은 같은 첨부를 한 요청에 두 번 찾고 권한도 두 번 확인하던 것을 한 번으로 줄였습니다. 확장 개발자 참고: 코어 첨부 서비스의 getFileInfo() 는 이미지가 아닌 파일에 내려받기(첨부 방식) 응답을 돌려주고, 공개 첨부 주소는 그 경로에서 getDownloadInfo() 를 따로 부르지 않습니다. 필터가 행의 MIME 을 바꿔도 인라인과 내려받기 중 어느 쪽으로 낼지를 필터를 지난 행 하나로 정해, 서비스와 컨트롤러의 판정이 갈리지 않습니다. 확장 개발자 참고: getFileInfo() 가 inline 키를 함께 돌려줍니다.
  • 사용자가 올린 이미지·첨부 파일을 브라우저가 다시 확인하는 요청에 매번 전체 파일을 다시 보내던 문제를 수정했습니다. 게시판·페이지·쇼핑몰·에디터 이미지 등 파일을 내어주는 경로 전반에서 「변경 없음」 응답이 제대로 나가며, 그 응답의 캐시 정보가 최초 응답과 같게 유지됩니다.
  • 확장을 업데이트해도 방문자 브라우저가 확장 화면 파일을 최대 1년간 옛 판으로 쓰던 문제를 수정했습니다. 주소에 버전이 없는 파일에도 「바뀌지 않는 파일」 캐시 표시가 붙고 있었습니다. 이제 버전이 실린 주소에만 그 표시를 붙이고, 확장 화면 파일 주소에는 그 확장의 버전을 함께 싣습니다.
  • 첨부 파일 서빙에서 축소된 이미지의 기록 크기가 실제와 달라 전송이 잘리던 문제, 이름에 따옴표나 한글이 든 파일을 내려받을 때 저장 이름이 원문과 달라지던 문제, 파일 저장 위치를 옮긴 사이트에서 미리보기·다운로드가 옛 위치를 찾아 실패하던 문제를 수정했습니다.
  • 브라우저가 파일 형식을 추측하지 않도록 하는 헤더를 첨부·이미지 응답뿐 아니라 사이트가 내어주는 모든 파일 응답(확장 자산 묶음·템플릿과 확장의 CSS·공개 저장소 대체 서빙 등)에 붙였습니다. 템플릿과 확장의 CSS 도 브라우저의 재확인 요청에 「변경 없음」으로 답하고, 운영 환경에서 주소에 버전이 없는 CSS 는 「바뀌지 않는 파일」로 표시하지 않습니다. 업로드된 SVG·HTML 파일이 사이트 주소에서 스크립트로 실행될 수 있던 여지를 막습니다.
  • 브라우저가 압축을 명시적으로 거부했을 때도 압축된 응답을 보내던 문제, 레이아웃 첨부 파일이 주소에 버전 표시만 붙이면 교체 후에도 하루 동안 옛 파일로 남던 문제를 수정했습니다. 페이지 첨부 파일 다운로드도 다른 파일 응답과 같은 캐시 규칙을 따릅니다.
  • 이름에 큰따옴표가 들어간 파일을 올리면 저장된 이름과 내려받은 파일 이름에 %22 가 붙던 문제를 수정했습니다(예: 견적 "최종".pdf 가 견적 %22최종%22.pdf 로 저장되던 현상). 첨부, 본문 미디어, 확장 설치 파일, 언어팩, 레이아웃 첨부처럼 파일을 올리는 모든 곳에 적용되며, 새로 올리는 파일부터 원래 이름으로 저장되고 이미 올린 파일의 이름은 바뀌지 않습니다.
  • 권한이 걸린 코어 첨부의 원본이 공유 캐시(CDN·프록시)에 저장될 수 있던 문제를 고쳤습니다(Cache-Control: private). 권한이 없는 공개 첨부의 캐시는 그대로입니다.

화면과 응답

  • 설치 화면의 「에셋 파일 서빙 방식」 판정 사유가 그 항목 카드 밖에 떠 있어 어느 항목의 설명인지 알기 어렵던 문제를 수정했습니다. 이제 카드 안에 표시됩니다. 함께, 좁은 화면에서 디렉토리 권한 목록의 경로가 잘리고 오른쪽 열이 화면 밖으로 밀리던 문제를 수정했습니다.
  • 관리자 화면의 작은 단추(btn-sm)가 기본 단추와 함께 쓰일 때 기본 크기 여백으로 그려지던 문제를 고쳤습니다. 이 정의를 복사해 쓰는 게시판, 이커머스, 페이지, GDPR, 비즈뿌리오, 토스페이먼츠 화면도 함께 고쳤습니다.
  • 방문 통계 개요의 인기 페이지, 유입 경로, 국가 카드에서 768px 이상일 때 눌러도 아무 일이 없던 「목록 펼치기」 단추를 숨겼습니다.
  • 관리자 카드 목록(CardGrid)이 총 건수를 끝까지 세지 않아 마지막 페이지를 모르는 목록에서 다음 페이지로 갈 수 없던 문제를 고쳤습니다(게시판 관리 목록). 함께, 레이아웃 편집기 속성 칸이 카드 수를 부품이 읽지 않는 이름으로 적던 것과 Container 의 효과 없는 배치 항목을 바로잡았습니다.

이미지 썸네일

  • 공개 프로필 API 가 회원 아바타 주소를 늘 null 로 내던 문제를 고쳤습니다.
  • 관리자 헤더가 회원 사진이 있어도 늘 대신 그림을 보이던 문제를 고쳤습니다.

방문자 통계

  • 처음 보는 페이지(새 글 등)에 여러 방문자가 거의 동시에 들어오면 그중 일부 방문 기록이 버려지고, 관리자 > 방문자 통계 수집 진단의 「최근 적재 실패」에 「DB 오류(Duplicate entry …)」가 쌓이던 문제를 고쳤습니다. 같은 페이지 이름을 먼저 저장한 요청이 있으면 그 이름을 다시 읽어 함께 씁니다.

창 하단 단추의 결과 알림

  • 창 하단(footer)처럼 컴포넌트 속성 안에 놓인 단추가 요청 결과 값을 넣어 띄우는 알림이 그 값을 비운 채 보이던 문제를 고쳤습니다(engine-v1.96.1). 연동 확장 안내, 알림 템플릿 저장 경고 수, 게시판 일괄 적용 건수 같은 알림이 해당합니다. 알림 문구를 화면을 그릴 때 미리 번역하지 않고 단추를 눌러 실행할 때 번역합니다.

환경설정 드라이버·저장소

  • 공개 자산 스토리지에 CloudFront 처럼 플러그인이 부팅 뒤에 정의하는 디스크를 고르면, 매 요청 「사용 안 함(스트리밍)」으로 되돌아가던 문제를 고쳤습니다.
  • 모듈·플러그인이 아직 적재되지 않은 문맥(콘솔 초기, 큐 작업)에서 확장 저장소가 다른 디스크(local)를 쓰던 문제를 고쳤습니다.