HeuJung
8cf829f953
Modern PHP User Group 2026-09 정기모임 설치 리뷰에서 접수된 제보 2건. 설치 완료·실패·중단·필수파일 안내는 페이지 최상단에 뜨는데, 진행 로그를 보느라 화면이 아래에 머물러 있으면 안내가 눈에 들어오지 않았다. 네 경로 모두 DOM 변경이 끝난 뒤 결과 섹션으로 부드럽게 이동시킨다(모션 최소화 설정 시 즉시 이동). 미인증 3화면의 테마 버튼은 setTheme 을 params.theme 으로 불렀는데 핸들러는 action.target 만 읽는다. 엔진에 상호 폴백이 없어 클릭이 콘솔 경고 한 줄만 남기고 아무 일도 하지 않았다. 로그인 이후 화면은 핸들러를 거치지 않는 ThemeToggle 을 쓰기 때문에 정상이었고, 그래서 이 세 화면에서만 나타났다. 같은 계약 불일치가 편집기 액션 레시피(admin 9·basic 3)와 두 템플릿 문서에도 있어 함께 고쳤다. 편집기로 만든 액션은 생성 즉시 no-op 이 되는데 오류가 남지 않는다. 정적 검사 레지스트리가 오히려 틀린 계약(params.theme 필수)을 강제하고 있어 올바른 형태를 막고 있었으므로 두 미러를 함께 정정했다. 테마를 고치는 과정에서 별개 결함이 드러났다. GDPR 스토리지 인터셉터가 기능 쿠키 미동의 상태에서 필수 목록 밖 저장을 부팅마다 파기하는데, 화면 테마가 그 목록에서 빠져 있었다. 저장소의 setItem 호출을 기계 도출해 대조한 결과 같은 이유로 사라지던 항목이 13건 더 있었다 — 비회원 주문 조회, 결제창 복귀 기록, 본인인증 복귀 기록, 관리자 화면 상태, 자산 주소 형식 캐시. 전량 필수로 분류하고, 동의 안내 문구가 "다크모드는 기능 쿠키" 라고 말하던 부분을 사실에 맞게 정정했다(기설치본의 저장된 문구는 업그레이드 스텝이 정정하며, 운영자가 고친 문구는 건드리지 않는다). 재발 방지는 허용목록을 직접 import 하고 모집단을 디렉토리 순회로 도출하는 커버리지 테스트가 맡는다 — 손으로 열거하지 않으므로 새 저장 키가 등재를 빠뜨리면 붉어진다.
576 lines
25 KiB
PHP
576 lines
25 KiB
PHP
<?php
|
|
|
|
namespace Plugins\Sirsoft\Gdpr;
|
|
|
|
use App\Contracts\Repositories\RoleRepositoryInterface;
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Enums\MenuPermissionType;
|
|
use App\Extension\AbstractPlugin;
|
|
use App\Extension\Helpers\ExtensionMenuSyncHelper;
|
|
use App\Models\Menu;
|
|
use Plugins\Sirsoft\Gdpr\Http\Middleware\CookieConsentMiddleware;
|
|
use Plugins\Sirsoft\Gdpr\Listeners\GdprAuthConsentListener;
|
|
use Plugins\Sirsoft\Gdpr\Listeners\GdprAuthLogoutListener;
|
|
use Plugins\Sirsoft\Gdpr\Listeners\GdprUserDeleteListener;
|
|
use Plugins\Sirsoft\Gdpr\Listeners\GdprUserWithdrawListener;
|
|
|
|
/**
|
|
* GDPR (일반 데이터 보호 규정) 플러그인
|
|
*
|
|
* 쿠키 동의 배너, 동의 이력 저장, 마이페이지 동의 철회 등 GDPR 핵심 대응
|
|
* 기능을 제공합니다 (F-01/F-02/F-03/F-04).
|
|
*/
|
|
class Plugin extends AbstractPlugin
|
|
{
|
|
/**
|
|
* 기본 차단 도메인 카탈로그 (BE SSoT).
|
|
*
|
|
* 신규 설치 시 `blocked_domains` 기본값 + `GdprSettingsController` 응답
|
|
* `default_blocked_domains_preview` 의 데이터 출처입니다.
|
|
*
|
|
* SSoT 동기 의무: 본 상수는 클라이언트 코드 상수 `resources/js/blocker-domains.ts`
|
|
* 의 `DEFAULT_BLOCKED_DOMAINS` 와 동일하게 유지합니다. 한쪽 갱신 시 다른 쪽도
|
|
* 같은 PR 에서 갱신해야 하며, 어긋날 경우 신규 설치 사이트와 관리자 UI 추천
|
|
* 도메인이 불일치합니다.
|
|
*
|
|
* @var array<string, array<int, string>>
|
|
*/
|
|
public const DEFAULT_BLOCKED_DOMAINS_CATALOG = [
|
|
// Phase 2: 외부 functional 서비스 도메인 카탈로그 — 운영자가 admin UI 의 functional 차단 도메인
|
|
// TagInput 자동완성 추천으로 노출. 운영자가 사이트에 해당 도구 도입 시 클릭으로 등록.
|
|
// 외부 functional 도구는 회색 영역 (analytics/marketing 분류도 가능) — 운영자 판단 영역.
|
|
'functional' => [
|
|
// 고객지원 챗봇
|
|
'*.crisp.chat',
|
|
'client.crisp.chat',
|
|
'*.intercom.io',
|
|
'widget.intercom.io',
|
|
'*.tawk.to',
|
|
'embed.tawk.to',
|
|
// 다국어 자동 번역 위젯
|
|
'cdn.weglot.com',
|
|
'*.weglot.com',
|
|
// 사용자 설정 외부 서비스
|
|
'*.usercentrics.eu',
|
|
],
|
|
'analytics' => [
|
|
'google-analytics.com',
|
|
'*.google-analytics.com',
|
|
'googletagmanager.com',
|
|
'*.googletagmanager.com',
|
|
'ssl.google-analytics.com',
|
|
'*.hotjar.com',
|
|
'static.hotjar.com',
|
|
'*.mixpanel.com',
|
|
'cdn.mxpnl.com',
|
|
'*.amplitude.com',
|
|
'cdn.amplitude.com',
|
|
'*.segment.io',
|
|
'*.segment.com',
|
|
'wcs.naver.net',
|
|
'wcs.naver.com',
|
|
'*.beusable.net',
|
|
],
|
|
'marketing' => [
|
|
'facebook.net',
|
|
'connect.facebook.net',
|
|
'facebook.com',
|
|
'*.facebook.com',
|
|
'doubleclick.net',
|
|
'*.doubleclick.net',
|
|
'googleadservices.com',
|
|
'googlesyndication.com',
|
|
'ads.google.com',
|
|
'*.criteo.com',
|
|
'static.criteo.net',
|
|
'*.adnxs.com',
|
|
'*.taboola.com',
|
|
'cdn.taboola.com',
|
|
'*.outbrain.com',
|
|
'*.kakao.com',
|
|
'analytics.ad.daum.net',
|
|
'platform.twitter.com',
|
|
'*.twitter.com',
|
|
'platform.linkedin.com',
|
|
'*.linkedin.com',
|
|
],
|
|
];
|
|
|
|
/**
|
|
* 플러그인이 제공하는 훅 정보 반환
|
|
*
|
|
* @return array 훅 정의 배열 (action 2개)
|
|
*/
|
|
public function getHooks(): array
|
|
{
|
|
return [
|
|
[
|
|
'name' => 'sirsoft-gdpr.consent.granted',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => '동의 부여 시 발화',
|
|
'en' => 'Fired when consent is granted',
|
|
],
|
|
'parameters' => [
|
|
'consent' => 'Model - GdprUserConsent',
|
|
'source' => 'string - banner|preference_center|register|mypage',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-gdpr.consent.revoked',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => '동의 철회 시 발화',
|
|
'en' => 'Fired when consent is revoked',
|
|
],
|
|
'parameters' => [
|
|
'consent' => 'Model - GdprUserConsent',
|
|
'source' => 'string - 철회 발생 경로',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 관리자 메뉴 정의
|
|
*
|
|
* 코어 PluginManager 는 모듈과 달리 plugin 의 getAdminMenus() 를 자동 호출하지 않으므로
|
|
* 본 클래스의 activate()/deactivate()/uninstall() lifecycle hook 에서 직접 sync 한다.
|
|
* 멱등성: helper.syncMenu 가 upsert 패턴이라 재활성화 시에도 row 중복 없이 그대로 복원.
|
|
*
|
|
* @return array<int, array<string, mixed>>
|
|
*/
|
|
public function getAdminMenus(): array
|
|
{
|
|
// 단독 평면 메뉴 — 본인인증 이력(admin-identity-logs)과 일관된 형태.
|
|
// 「설정」은 코어「플러그인 관리 → 설정」 자동 경로 사용 (중복 제거)
|
|
return [
|
|
[
|
|
'name' => ['ko' => 'GDPR 동의 이력', 'en' => 'GDPR Consent Log'],
|
|
'slug' => 'sirsoft-gdpr-consent-log',
|
|
'url' => '/admin/plugins/sirsoft-gdpr/consent-log',
|
|
'icon' => 'fas fa-user-shield',
|
|
'order' => 50,
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인 활성화 — 관리자 메뉴 자동 등록 + privacy 역할 권한 부여.
|
|
*
|
|
* 모듈은 ModuleManager 가 getAdminMenus() 를 자동 처리하지만 플러그인은
|
|
* PluginManager 가 그 책임을 위임하므로 본 메서드에서 helper 를 직접 호출한다.
|
|
*
|
|
* helper.grantDefaultRoles 는 admin 역할에만 메뉴 권한을 부여하므로,
|
|
* sirsoft-gdpr.privacy 역할에는 별도로 role_menus 피벗에 부여한다.
|
|
*
|
|
* @return bool 활성화 성공 여부
|
|
*/
|
|
public function activate(): bool
|
|
{
|
|
$helper = app(ExtensionMenuSyncHelper::class);
|
|
|
|
foreach ($this->getAdminMenus() as $menuData) {
|
|
$menu = $helper->syncMenuRecursive(
|
|
$menuData,
|
|
ExtensionOwnerType::Plugin,
|
|
$this->getIdentifier(),
|
|
);
|
|
|
|
$this->grantPrivacyRoleToMenuTree($menu);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 플러그인 비활성화 — 관리자 메뉴 일괄 제거.
|
|
*
|
|
* cleanupStaleMenus 에 currentSlugs=[] 를 넘겨 본 플러그인 소속 메뉴 전체를 삭제한다.
|
|
* 자식 메뉴 + role_menus 피벗 정리는 helper 가 cascade 처리.
|
|
*
|
|
* @return bool 비활성화 성공 여부
|
|
*/
|
|
public function deactivate(): bool
|
|
{
|
|
app(ExtensionMenuSyncHelper::class)->cleanupStaleMenus(
|
|
ExtensionOwnerType::Plugin,
|
|
$this->getIdentifier(),
|
|
currentSlugs: [],
|
|
);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 플러그인 제거 — 메뉴 잔존 안전망 (정상 흐름은 deactivate 가 먼저 처리).
|
|
*
|
|
* @return bool 제거 성공 여부
|
|
*/
|
|
public function uninstall(): bool
|
|
{
|
|
$this->deactivate();
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 메뉴 트리에 sirsoft-gdpr.privacy 역할의 read 권한을 재귀 부여한다.
|
|
*
|
|
* helper.grantDefaultRoles 는 admin 역할만 자동 부여하므로 privacy 역할은 별도 처리 필요.
|
|
*
|
|
* @param Menu $menu 대상 메뉴 (자식 포함)
|
|
*/
|
|
private function grantPrivacyRoleToMenuTree(Menu $menu): void
|
|
{
|
|
$role = app(RoleRepositoryInterface::class)->findByIdentifier('sirsoft-gdpr.privacy');
|
|
|
|
if ($role === null) {
|
|
return;
|
|
}
|
|
|
|
$menu->roles()->syncWithoutDetaching([
|
|
$role->id => ['permission_type' => MenuPermissionType::Read->value],
|
|
]);
|
|
|
|
foreach ($menu->children as $child) {
|
|
$this->grantPrivacyRoleToMenuTree($child);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 플러그인 권한 목록 반환 (계층 구조)
|
|
*
|
|
* PluginManager가 1레벨(플러그인 노드) → 2레벨(카테고리) → 3레벨(개별 권한) 트리로 등록.
|
|
* 모든 권한은 admin·sirsoft-gdpr.privacy 두 역할에 매핑.
|
|
*
|
|
* 권한 분할 의도:
|
|
* - view: 동의 이력·설정 조회 (감사관/모니터링 read-only)
|
|
* - update: 쿠키 카테고리·정책 버전 등 설정 변경 (정책 설정자)
|
|
*
|
|
* @return array 권한 정의 배열 (categories 계층 구조)
|
|
*/
|
|
public function getPermissions(): array
|
|
{
|
|
return [
|
|
'name' => [
|
|
'ko' => 'GDPR (일반 데이터 보호 규정)',
|
|
'en' => 'GDPR (General Data Protection Regulation)',
|
|
],
|
|
'description' => [
|
|
'ko' => 'GDPR 플러그인이 제공하는 권한',
|
|
'en' => 'Permissions provided by the GDPR plugin',
|
|
],
|
|
'categories' => [
|
|
[
|
|
'identifier' => 'privacy',
|
|
'name' => ['ko' => '개인정보 보호', 'en' => 'Privacy'],
|
|
'description' => [
|
|
'ko' => 'GDPR 도메인 권한 (조회·설정)',
|
|
'en' => 'GDPR domain permissions (view, update settings)',
|
|
],
|
|
'permissions' => [
|
|
[
|
|
'action' => 'view',
|
|
'name' => ['ko' => '개인정보 조회', 'en' => 'View Privacy'],
|
|
'description' => [
|
|
'ko' => '동의 이력·GDPR 설정 조회 (감사·모니터링)',
|
|
'en' => 'View consent log and GDPR settings (audit / monitoring)',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'sirsoft-gdpr.privacy'],
|
|
],
|
|
[
|
|
'action' => 'update',
|
|
'name' => ['ko' => '개인정보 설정 변경', 'en' => 'Update Privacy Settings'],
|
|
'description' => [
|
|
'ko' => '쿠키 카테고리·정책 버전 등 GDPR 플러그인 설정 변경',
|
|
'en' => 'Modify GDPR plugin settings (cookie categories, policy version, etc.)',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'sirsoft-gdpr.privacy'],
|
|
],
|
|
],
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인 역할 목록 반환
|
|
*
|
|
* @return array 역할 정의 배열
|
|
*/
|
|
public function getRoles(): array
|
|
{
|
|
return [
|
|
[
|
|
'identifier' => 'sirsoft-gdpr.privacy',
|
|
'name' => ['ko' => '개인정보 운영자', 'en' => 'Privacy Operator'],
|
|
'description' => [
|
|
'ko' => 'GDPR 도메인 운영 권한 (설정·동의 이력 조회)',
|
|
'en' => 'Operational authority over GDPR domain (settings, consent log)',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인이 동적으로 생성한 테이블 목록 반환
|
|
*
|
|
* 언인스톨 시 PluginManager가 일괄 삭제 (FK 순서대로)
|
|
*
|
|
* @return array 테이블명 배열
|
|
*/
|
|
public function getDynamicTables(): array
|
|
{
|
|
return [
|
|
'gdpr_user_consent_histories',
|
|
'gdpr_user_consents',
|
|
'gdpr_policy_versions',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 설치·업데이트 시 실행할 시더 목록 반환
|
|
*
|
|
* 권한·역할은 PluginManager 가 getRoles()/getPermissions() 로 자동 등록·동기화하므로
|
|
* 별도 시더가 불필요하다.
|
|
*
|
|
* @return array 시더 클래스 배열
|
|
*/
|
|
public function getSeeders(): array
|
|
{
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* 이 플러그인이 등록할 HTTP 미들웨어 선언을 반환합니다.
|
|
*
|
|
* functional cookie 게이팅 미들웨어(CookieConsentMiddleware)를 코어 self-gate 방식으로
|
|
* 선언합니다. EDPB Guidelines 2/2023 §16(사전 차단) 충족을 위해 모든 web/api 응답을
|
|
* 대상으로 하므로 targets=['everything'](광역 타게팅) + timing=before_core(코어 전처리 전
|
|
* 응답 처리)로 지정합니다. 코어 ExtensionMiddlewareGate 가 요청 시점에 실행합니다.
|
|
*
|
|
* @return array<int, array{class: class-string, groups: array<int, string>, timing?: string, targets: array<int, string>}>
|
|
*/
|
|
public function getMiddleware(): array
|
|
{
|
|
return [
|
|
[
|
|
'class' => CookieConsentMiddleware::class,
|
|
'groups' => ['web', 'api'],
|
|
'timing' => 'before_core',
|
|
'targets' => ['everything'],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인 설정 값 반환 (기본값)
|
|
*
|
|
* @return array 설정 값 배열
|
|
*/
|
|
public function getConfigValues(): array
|
|
{
|
|
return [
|
|
// 정책 메타데이터 — cookie_policy_version 은 gdpr_policy_versions 테이블이 SSoT
|
|
// (마이그레이션 시 initial 행 자동 시드). 본 settings 에서는 보관하지 않음.
|
|
'privacy_policy_slug' => 'privacy',
|
|
'legal_entity_name' => '',
|
|
'data_storage_location' => '',
|
|
|
|
// 쿠키 배너 + 자동 차단 (F-01 / F-02) — banner_enabled 단일 토글로 통합 제어.
|
|
// ON 시 배너 노출 + 동의 전 외부 추적 자동 차단이 함께 시작됨. 마이페이지 동의 관리
|
|
// 카드는 이 토글과 무관 — GDPR Art.7(3) 철회 대칭성 보장을 위해 동의/철회 이력이
|
|
// 있는 회원에게 배너 노출 여부와 무관하게 항상 노출된다 (resources/extensions/mypage_privacy_tab.json 참조).
|
|
// 차단을 별도 토글로 제공하지 않는 이유: GDPR Art.6 "동의 전 처리 금지" 의 강제 메커니즘
|
|
// 인 차단을 운영자가 단독 OFF 할 수 있으면 위반 조합 (배너 ON + 차단 OFF) 가능 → CNIL
|
|
// Microsoft €60M / Amazon €35M / Google €100M 처벌 패턴과 동일. 단일 토글로 구조적 차단.
|
|
//
|
|
// 기본값 true: 플러그인 활성화 = 운영자의 GDPR 컴플라이언스 의사 표명. 시장 표준 CMP
|
|
// (OneTrust / Cookiebot / Iubenda / Klaro) 모두 "활성화 = 즉시 작동" 패턴. 운영자가
|
|
// 컴플라이언스 임시 비활성을 원할 때만 OFF.
|
|
'banner_enabled' => true,
|
|
'banner_position' => 'bottom_bar',
|
|
|
|
// F-02 도메인 기반 차단 — 카테고리별 운영자 입력.
|
|
// 게스트도 차단 동작해야 하므로 공개 응답에 노출 (defaults.json frontend_schema).
|
|
// 신규 설치 시 카탈로그 도메인이 채워져 있어 운영자가 토글 ON 만으로
|
|
// 즉시 GA·Meta 등 차단 시작 가능. 운영자는 칩 X 클릭으로 빼고 싶은 도메인
|
|
// 제거 가능. 카탈로그 갱신 동기화는 관리자 UI 의 "(+ 카탈로그에서 도메인
|
|
// 가져오기)" 링크가 클라이언트 측 Set 합집합으로 처리.
|
|
'blocked_domains' => self::DEFAULT_BLOCKED_DOMAINS_CATALOG,
|
|
|
|
'cookie_categories' => json_encode([
|
|
[
|
|
'key' => 'necessary',
|
|
'required' => true,
|
|
'label' => ['ko' => '필수 쿠키', 'en' => 'Strictly Necessary'],
|
|
'description' => [
|
|
// g7_locale·g7_color_scheme 은 ePrivacy Art.5(3) + WP29 Opinion 04/2012 §3.6 의 user-initiated preference
|
|
// 예외 (사용자가 화면에서 직접 고른 표시 환경) 로 strictly necessary 분류. 사용자 안내에 명시.
|
|
'ko' => '세션·CSRF·로그인 토큰, 장바구니 식별자, 사용자가 직접 고른 언어 설정과 화면 테마, 쿠키 동의 기록 등 사이트 운영에 반드시 필요한 항목입니다. 비활성화할 수 없습니다.',
|
|
'en' => 'Strictly necessary for site operation: session/CSRF/auth tokens, shopping basket identifier, user-selected language preference and display theme, cookie consent record. Cannot be disabled.',
|
|
],
|
|
],
|
|
[
|
|
// Phase 1: functional 카테고리 신설 — ICO/CNIL 4분류 체계 부합.
|
|
// 자체 functional 키 (표시 통화 등) + 외부 functional 도구 (Crisp, Intercom 등) 분류 영역.
|
|
// Phase 2 에서 실제 게이팅 (Storage.prototype 가로채기 + cookie 가로채기 + Set-Cookie 미들웨어) 구현 예정.
|
|
'key' => 'functional',
|
|
'required' => false,
|
|
'label' => ['ko' => '기능 쿠키', 'en' => 'Functional'],
|
|
'description' => [
|
|
'ko' => '사용자 선호도(표시 통화 등)를 기억하는 쿠키입니다. 거부 시 매 방문마다 기본값으로 표시됩니다.',
|
|
'en' => 'Cookies that remember user preferences such as display currency. If declined, defaults are used on every visit.',
|
|
],
|
|
],
|
|
[
|
|
'key' => 'analytics',
|
|
'required' => false,
|
|
'label' => ['ko' => '분석 쿠키', 'en' => 'Analytics'],
|
|
'description' => [
|
|
'ko' => '방문자가 사이트를 어떻게 이용하는지 익명으로 측정해 더 나은 서비스를 만드는 데 사용됩니다. (예: Google Analytics, Hotjar)',
|
|
'en' => 'Used to anonymously measure how visitors use the site so we can improve it. (e.g. Google Analytics, Hotjar)',
|
|
],
|
|
],
|
|
[
|
|
'key' => 'marketing',
|
|
'required' => false,
|
|
'label' => ['ko' => '마케팅 쿠키', 'en' => 'Marketing'],
|
|
'description' => [
|
|
'ko' => '관심사에 맞는 광고를 보여주거나, 광고가 얼마나 효과적이었는지 측정하는 데 사용됩니다. SNS 영상 임베드 등도 포함됩니다. (예: Facebook 픽셀, Google 광고, YouTube 영상)',
|
|
'en' => 'Used to show ads relevant to your interests, measure ad performance, and embed social media content. (e.g. Facebook Pixel, Google Ads, YouTube embeds)',
|
|
],
|
|
],
|
|
]),
|
|
|
|
// Phase 2 단순화: 운영자 등록 표 (functional_storage_keys / functional_cookies /
|
|
// functional_allow_user_initiated) 는 GDPR 원칙과 충돌하여 제거됨. 게이팅은
|
|
// strictly necessary allowlist (코드 상수) 외 모든 비-필수 저장을 동의 시까지 차단하는
|
|
// 4단계 단순화 규칙으로 처리. WP29 §3.6 user-initiated 면제는 항상 활성.
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인 설정 스키마 반환
|
|
*
|
|
* @return array 설정 스키마
|
|
*/
|
|
public function getSettingsSchema(): array
|
|
{
|
|
return [
|
|
// 정책 메타데이터 — cookie_policy_version 은 gdpr_policy_versions 테이블이 SSoT.
|
|
// 운영자는 직접 입력하지 않고, Material 변경 (카테고리 추가/삭제 등) 시 시스템이 자동 발행.
|
|
'privacy_policy_slug' => [
|
|
'type' => 'string',
|
|
'default' => 'privacy',
|
|
'label' => ['ko' => '개인정보처리방침 페이지 슬러그', 'en' => 'Privacy Policy Page Slug'],
|
|
'hint' => [
|
|
'ko' => 'sirsoft-page 모듈의 페이지 slug. 미설치 또는 페이지 부재 시 관련 링크는 자동 숨김됩니다.',
|
|
'en' => 'Slug of the sirsoft-page page. Links auto-hide when page is missing.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
'legal_entity_name' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'label' => ['ko' => '운영 주체명', 'en' => 'Legal Entity Name'],
|
|
'hint' => [
|
|
'ko' => '개인정보처리방침에 표시될 회사·서비스명. 예: "(주)홍길동컴퍼니"',
|
|
'en' => 'Company/service name shown in privacy policy.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
'data_storage_location' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'label' => ['ko' => '데이터 저장 위치', 'en' => 'Data Storage Location'],
|
|
'hint' => [
|
|
'ko' => '개인정보가 저장되는 물리적 위치. 예: "한국 (서울 IDC)", "AWS 서울 리전"',
|
|
'en' => 'Physical location where personal data is stored.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
|
|
// 쿠키 배너 + 자동 차단 단일 토글 (banner_enabled). 마이페이지 카드는 이 토글과 무관 (별도 절 참조).
|
|
// 기본값 true — 플러그인 활성화 = 운영자의 GDPR 컴플라이언스 의사 표명.
|
|
'banner_enabled' => [
|
|
'type' => 'boolean',
|
|
'default' => true,
|
|
'label' => ['ko' => '쿠키 배너 노출', 'en' => 'Show Cookie Banner'],
|
|
'hint' => [
|
|
'ko' => 'ON 시 쿠키 동의 배너 노출 + 동의 전 외부 추적 자동 차단이 함께 시작됩니다. 정책 슬러그·카테고리 설정 후 켜는 것을 권장. 마이페이지 동의 관리 카드는 이 토글과 무관하게 동의/철회 이력이 있는 회원에게 항상 노출됩니다.',
|
|
'en' => 'When ON, the cookie consent banner and pre-consent auto-blocking are activated together. The MyPage consent management card is independent of this toggle and always shows for members with consent/withdrawal history.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
'banner_position' => [
|
|
'type' => 'string',
|
|
'default' => 'bottom_bar',
|
|
'label' => ['ko' => '배너 위치', 'en' => 'Banner Position'],
|
|
'hint' => [
|
|
'ko' => 'bottom_bar(하단 바) / bottom_left_popup / bottom_right_popup / centered_modal',
|
|
'en' => 'Position of the cookie banner.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
'blocked_domains' => [
|
|
'type' => 'json',
|
|
'default' => json_encode(self::DEFAULT_BLOCKED_DOMAINS_CATALOG),
|
|
'label' => ['ko' => '추적 도메인 차단 목록', 'en' => 'Tracking Domain Block List'],
|
|
'hint' => [
|
|
'ko' => '카테고리별 차단 도메인 목록(JSON 객체). 신규 설치 시 카탈로그 도메인이 채워져 있으며 운영자가 추가·삭제 가능. FQDN 만 지원하며 *.example.com 와일드카드 가능.',
|
|
'en' => 'Per-category blocked domain list (JSON object). Pre-filled with the catalog on fresh install; operators can add/remove domains. FQDN only; supports *.example.com wildcard.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
'cookie_categories' => [
|
|
'type' => 'json',
|
|
'default' => '[]',
|
|
'label' => ['ko' => '쿠키 카테고리 정의', 'en' => 'Cookie Categories'],
|
|
'hint' => [
|
|
'ko' => '카테고리는 4종 고정(necessary/functional/analytics/marketing). 운영자 편집 입력 없음.',
|
|
'en' => 'The four categories are fixed (necessary/functional/analytics/marketing). No operator-editable inputs.',
|
|
],
|
|
'required' => false,
|
|
],
|
|
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 플러그인 메타데이터 반환
|
|
*
|
|
* @return array 메타데이터
|
|
*/
|
|
public function getMetadata(): array
|
|
{
|
|
return [
|
|
'author' => 'Sirsoft',
|
|
'license' => 'MIT',
|
|
'homepage' => 'https://sir.kr',
|
|
'keywords' => ['gdpr', 'privacy', 'consent', 'cookie', 'data-protection'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 훅 리스너 목록 반환
|
|
*
|
|
* PluginManager 가 활성화된 플러그인에 대해 자동으로
|
|
* HookListenerRegistrar::register() 호출.
|
|
*
|
|
* @return array 훅 리스너 클래스 배열
|
|
*/
|
|
public function getHookListeners(): array
|
|
{
|
|
return [
|
|
GdprUserWithdrawListener::class,
|
|
GdprUserDeleteListener::class,
|
|
GdprAuthLogoutListener::class,
|
|
GdprAuthConsentListener::class,
|
|
];
|
|
}
|
|
}
|