HeuJung
455d009a83
코어 composer update 69 패키지(Laravel 12.69.1 · Reverb 1.11.1 · Scout 11.6.1 · Monolog 3.11 · Symfony 7.4.18 등, 메이저 상향은 보류). 번들 확장 16개 lock content-hash 재동기(신규 2), 코어·이커머스 vendor-bundle.zip 재빌드(g7_version 7.0.11). vendor-bundle:build-all --check 가 미설치 확장을 「소스 경로 없음」으로 건너뛰어 _bundled 의 stale 번들이 점검을 통과하던 결함을 수정 — 판정 파일을 빌드·해시와 같은 규칙(_bundled 우선, 활성 폴백)으로 고르고 회귀 테스트 2건 추가. 회귀 점검: 변경 로그 대조 9축 + PHPUnit 4배치 + Chrome MCP 매트릭스 11축 통과.
그누보드7 마케팅 동의 플러그인
그누보드7 플러그인 · sirsoft-marketing 이메일 구독, 마케팅 동의, 제3자 제공 동의 등을 관리하는 플러그인
소개 · 주요 기능 · 동작 방식 · 요구 사항 · 설치 · 관리자 설정 · 사용 방법 · 다른 확장과의 연동 · 문서 · 트러블슈팅 · 변경 이력 · 라이선스
소개
회원에게 마케팅 정보 수신 동의를 받고 그 이력을 남기는 플러그인입니다. 이메일·SMS 같은 수신 채널을 관리자 화면에서 원하는 만큼 추가할 수 있고, 제3자 제공 동의·정보 공개 동의처럼 채널이 아닌 법정 동의 항목도 함께 다룹니다.
동의 항목은 회원가입 폼과 마이페이지, 관리자의 회원 상세·수정 화면에 자동으로 나타납니다. 이 플러그인은 자기 화면을 갖지 않고 기존 화면에 항목을 얹는 방식이라, 도입해도 회원 관리 흐름이 달라지지 않습니다.
동의와 철회는 모두 기록됩니다 — 언제, 어느 경로로, 어느 IP 에서 이루어졌는지가 남습니다. 동의 여부만 남기면 나중에 "동의를 받았다" 는 사실을 증명할 수 없기 때문입니다.
의도적으로 하지 않는 것: 실제 발송. 이 플러그인은 "누가 무엇에 동의했는가" 까지만 답하고, 그 동의를 근거로 메일이나 문자를 보내는 것은 발송 담당 확장의 몫입니다.
주요 기능
| 영역 | 설명 |
|---|---|
| 수신 채널 관리 | 이메일·SMS 등 수신 채널을 관리자 화면에서 추가·수정·사용중지 |
| 법정 동의 항목 | 마케팅 활용 동의·제3자 제공 동의·정보 공개 동의를 각각 켜고 끔 |
| 약관 연결 | 동의 항목마다 약관 페이지를 지정해 회원이 내용을 확인하고 동의 |
| 가입 시 수집 | 회원가입 폼에 동의 항목이 자동으로 나타남 |
| 마이페이지 관리 | 회원이 언제든 스스로 동의·철회 |
| 관리자 조회·수정 | 회원 상세·수정 화면에서 동의 상태 확인과 변경 |
| 동의 이력 | 동의·철회 행위마다 시각·경로·IP 기록, 동의 횟수 누적 |
| 연동 지점 | 동의·철회 시점에 다른 확장이 반응할 수 있는 확장점 제공 |
동작 방식
flowchart LR
R[회원가입 폼] -->|동의 항목 주입| P[이 플러그인]
M[마이페이지] -->|동의/철회| P
A[관리자 회원 화면] -->|조회·변경| P
P --> S[(현재 동의 상태)]
P --> H[(동의 이력)]
P -.동의/철회 알림.-> X[발송·연동 확장]
이 플러그인은 회원 화면들을 고치지 않고 그 화면에 항목만 얹습니다. 어느 경로로 동의가 바뀌든 현재 상태와 이력이 함께 기록되고, 그 변화를 다른 확장이 받아 수신 목록에 반영할 수 있습니다.
수신 채널을 새로 추가하는 것은 설정 변경만으로 끝납니다. 프로그램을 다시 배포하거나 데이터베이스를 고칠 필요가 없습니다.
요구 사항
| 항목 | 값 |
|---|---|
| 그누보드7 코어 | >=7.0.0 |
| PHP | ^8.2 |
| 의존 모듈 | sirsoft-page >=1.0.0 |
설치
# 번들 설치 (코어에 동봉된 소스에서 설치)
php artisan plugin:install sirsoft-marketing
# 활성화
php artisan plugin:activate sirsoft-marketing
# 업데이트 (번들 소스 기준 강제 반영)
php artisan plugin:update sirsoft-marketing --force
저장소: https://github.com/gnuboard/g7-plugin-sirsoft-marketing
관리자 설정
| 키 | 의미 | 기본값 |
|---|---|---|
marketing_consent_enabled |
마케팅 동의 사용 | true |
marketing_consent_terms_slug |
마케팅 동의 약관 페이지 Slug | marketing-terms |
channels |
채널 목록 | [] |
third_party_consent_enabled |
제3자 제공 동의 사용 | true |
third_party_consent_terms_slug |
제3자 제공 동의 약관 페이지 Slug | - |
info_disclosure_enabled |
정보 공개 동의 사용 | true |
info_disclosure_terms_slug |
정보 공개 동의 약관 페이지 Slug | - |
개발자용 상세(타입·검증·저장 위치)는 설정 스키마 를 보세요.
설정은 관리자의 플러그인 목록에서 이 플러그인의 설정으로 들어가 조정합니다.
| 항목 | 언제 바꾸는가 | 바꾸면 달라지는 것 |
|---|---|---|
| 마케팅 동의 사용 | 마케팅 수신 동의를 받지 않을 때 | 끄면 가입 폼·마이페이지에서 마케팅 동의 항목이 사라집니다 |
| 마케팅 동의 약관 페이지 | 약관 문서를 만든 뒤 | 동의 항목 옆 "내용 보기" 가 가리키는 페이지 (기본 marketing-terms) |
| 채널 목록 | 수신 수단을 늘리거나 줄일 때 | 이메일·SMS 등 개별 수신 채널. 여기서 추가하면 즉시 가입 폼과 마이페이지에 나타납니다 |
| 제3자 제공 동의 사용 / 약관 페이지 | 개인정보를 제휴사에 제공할 때 | 해당 동의 항목의 노출 여부와 약관 링크 |
| 정보 공개 동의 사용 / 약관 페이지 | 회원 정보를 공개 영역에 노출할 때 | 해당 동의 항목의 노출 여부와 약관 링크 |
약관 페이지는 페이지 모듈에서 만든 문서를 가리킵니다. 슬러그만 지정하면 되고, 문서가 없으면 링크가 열리지 않으므로 약관을 먼저 작성합니다.
채널을 사용중지로 바꾸면 새 가입자에게는 보이지 않지만, 이미 동의한 회원의 기록은 남습니다 — 나중에 다시 켰을 때 그 회원이 다시 동의할 필요가 없도록 하기 위해서입니다.
사용 방법
도입: 페이지 모듈로 마케팅 수신 동의 약관 문서를 먼저 만듭니다(예: 슬러그
marketing-terms). 그다음 이 플러그인의 설정에서 약관 페이지 슬러그를 지정하고, 수신 채널을
필요한 만큼 추가합니다. 저장하면 회원가입 폼과 마이페이지에 동의 항목이 바로 나타납니다.
수신 채널 늘리기: 예를 들어 이메일만 받다가 카카오 알림톡을 추가하려면, 설정의 채널 목록에 항목을 하나 더하고 표시할 이름과 약관 페이지를 지정합니다. 기존 회원은 새 항목에 대해 미동의 상태로 시작하며, 마이페이지에서 개별적으로 동의할 수 있습니다.
동의 현황 확인: 관리자의 회원 상세 화면에서 그 회원의 항목별 동의 상태를 볼 수 있습니다. 운영자가 대신 변경할 수도 있지만, 그 변경도 이력에 "관리자에 의한 변경" 으로 남습니다.
다른 확장과의 연동
이 확장이 의존하는 확장
| 확장 | 유형 | 버전 제약 | 번들 |
|---|---|---|---|
sirsoft-page |
모듈 | >=1.0.0 |
✅ |
이 확장에 의존하는 확장 (이 확장을 비활성화하면 함께 영향을 받습니다)
없음.
문서
| 문서 | 내용 | 상태 |
|---|---|---|
| docs/README.md | 문서 통합 목차와 실측 집계 | ✅ |
| docs/architecture.md | 설계 의도·계층 지도·디렉토리 맵 | ✅ |
| docs/extension-points.md | 발행/구독 훅·미들웨어·채널·스케줄 | ✅ |
| docs/data-model.md | 모델·소유 테이블·마이그레이션·Enum | ✅ |
| docs/settings.md | 설정 스키마·권한·메뉴·라우트·의존 관계 | ✅ |
| docs/frontend.md | 레이아웃·액션 핸들러·전역 진입점·에셋 | ✅ |
| docs/editor-spec.md | 레이아웃 편집기에 선언한 팔레트·컨트롤·샘플 데이터 | ✅ |
| docs/api/ | API 레퍼런스 (엔드포인트별 파라미터·응답 필드) | ✅ |
| CHANGELOG.md | 변경 이력 | ✅ |
트러블슈팅
| 증상 | 원인 | 조치 |
|---|---|---|
| 가입 폼에 동의 항목이 보이지 않음 | 해당 동의 항목이 꺼져 있거나 채널이 하나도 없음 | 설정에서 사용 여부를 확인하고 채널을 하나 이상 추가합니다 |
| 동의 항목의 "내용 보기" 를 눌러도 약관이 열리지 않음 | 지정한 슬러그의 페이지가 없거나 미발행 | 페이지 모듈에서 그 슬러그의 문서를 만들고 발행합니다 |
| 템플릿을 바꾸거나 업데이트한 뒤 동의 항목이 사라짐 | 새 화면에 항목이 들어갈 자리가 없음 | 해당 템플릿이 회원 화면의 확장 자리를 제공하는지 확인합니다 |
| 채널을 지웠는데 이미 동의한 회원 기록이 남아 있음 | 기록은 의도적으로 보존됨 | 정상 동작입니다. 채널을 다시 켜면 그 회원은 다시 동의할 필요가 없습니다 |
| 동의했는데 마케팅 메일이 오지 않음 | 이 플러그인은 동의만 관리하고 발송은 하지 않음 | 발송을 담당하는 확장의 설정과 발송 대상 조건을 확인합니다 |
| 회원을 지웠는데 동의 이력이 남아 있는지 확인하고 싶음 | 회원 삭제 시 함께 정리됨 | 정상 동작입니다. 삭제된 회원의 동의 기록은 삭제 흐름에서 함께 정리됩니다 |
변경 이력
라이선스
MIT