HeuJung
cfc2caba1b
공개 (@Tuwasduliebst 제보) 대응. - ckeditor5: 미참조 이미지 정리 엔진 신설 — 참조 판정(hash + 파일명 2토큰, filter_reference_sources 훅으로 확장 콘텐츠 등록) + 정리 커맨드(기본 꺼짐 옵트인, 3중 게이트) + 업로드 관리 화면(권한 분리·참조 배지·개별/선택 삭제) + 기설치본 설정 백필 upgrade step - board: 임시 첨부 GC(상시) + 소프트삭제 첨부 영구 정리(옵트인) + 설정 UI, 저장 payload 누락(F4)·빈 temp 디렉토리 잔존(F5) 수정 - ecommerce: 임시 상품 이미지 GC + 카테고리 삭제 시 이미지 파일 미삭제(S4) 수정 - page: 임시 첨부 GC - 코어: 고아 첨부 정리 커맨드(옵트인, site_logo 보호) + 사이트 로고 교체 시 구 로고 재편입 차단(S6) + DB 백업 미구현 501 정직화(B3) + 플러그인 관리자 메뉴 설치·업데이트 자동 동기화(F1·F7) - 동반: 플러그인 설정 검증 오류 필드명 라벨화(F3), Toggle 노드 type 정정 수평 전개(marketing 1.0.2 bump·gdpr·ecommerce), ja 언어팩 4종, API 문서, hooks.md, 시나리오 매니페스트 8종, Playwright E2E 4종
1319 lines
62 KiB
PHP
1319 lines
62 KiB
PHP
<?php
|
|
|
|
namespace Modules\Sirsoft\Board;
|
|
|
|
use App\Extension\AbstractModule;
|
|
use App\Models\Role;
|
|
use App\Seo\Concerns\LocalizesSeoValues;
|
|
use Illuminate\Database\Seeder;
|
|
use Illuminate\Support\Facades\Schema;
|
|
use Modules\Sirsoft\Board\Database\Seeders\BoardTypeSeeder;
|
|
use Modules\Sirsoft\Board\Listeners\ActivityLogDescriptionResolver;
|
|
use Modules\Sirsoft\Board\Listeners\BoardActivityLogListener;
|
|
use Modules\Sirsoft\Board\Listeners\BoardCommentsCountSyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\BoardNotificationChannelListener;
|
|
use Modules\Sirsoft\Board\Listeners\BoardNotificationDataListener;
|
|
use Modules\Sirsoft\Board\Listeners\BoardPostsCountSyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\Ckeditor5ReferenceSourcesListener;
|
|
use Modules\Sirsoft\Board\Listeners\CommentReplySyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\EcommerceInquiryHookListener;
|
|
use Modules\Sirsoft\Board\Listeners\PostAttachmentCountSyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\PostCountSyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\PostReplySyncListener;
|
|
use Modules\Sirsoft\Board\Listeners\SearchPostsListener;
|
|
use Modules\Sirsoft\Board\Listeners\SeoBoardCacheListener;
|
|
use Modules\Sirsoft\Board\Listeners\SeoBoardSettingsCacheListener;
|
|
use Modules\Sirsoft\Board\Listeners\UserNotificationSettingsListener;
|
|
use Modules\Sirsoft\Board\Models\Board;
|
|
|
|
class Module extends AbstractModule
|
|
{
|
|
use LocalizesSeoValues;
|
|
|
|
/**
|
|
* 모듈 제거 시 동적으로 생성된 게시판별 역할을 정리합니다.
|
|
*
|
|
* 게시판 생성 시 동적으로 생성된 sirsoft-board.{slug}.manager/step 역할은
|
|
* getRoles()에 포함되지 않으므로, ModuleManager::removeModuleRoles()에서 처리되지 않습니다.
|
|
* 따라서 uninstall()에서 직접 정리합니다.
|
|
*
|
|
* @return bool 제거 성공 여부
|
|
*/
|
|
public function uninstall(): bool
|
|
{
|
|
// 게시판별 동적 역할 정리 (sirsoft-board.*.manager, sirsoft-board.*.step)
|
|
// chunkById(키셋 순회) 필수 — each() 는 OFFSET 기반 청크(기본 1000건)라
|
|
// 콜백이 순회 대상을 삭제하면 다음 페이지의 OFFSET 이 줄어든 결과 집합을 지나쳐
|
|
// 1000건을 넘는 역할이 그대로 남는다.
|
|
Role::where('extension_type', 'module')
|
|
->where('extension_identifier', 'sirsoft-board')
|
|
->chunkById(100, function ($roles) {
|
|
foreach ($roles as $role) {
|
|
$role->permissions()->detach();
|
|
$role->users()->detach();
|
|
$role->delete();
|
|
}
|
|
});
|
|
|
|
return parent::uninstall();
|
|
}
|
|
|
|
/**
|
|
* 모듈 스케줄 목록 반환
|
|
*
|
|
* 대시보드 게시물 현황 집계를 매시간 실행합니다.
|
|
*
|
|
* @return array<int, array<string, string>> 스케줄 정의 목록
|
|
*/
|
|
public function getSchedules(): array
|
|
{
|
|
return [
|
|
[
|
|
'command' => 'sirsoft-board:aggregate-stats',
|
|
'schedule' => 'hourly',
|
|
'description' => '대시보드 게시물 현황 집계',
|
|
],
|
|
[
|
|
'command' => 'sirsoft-board:prune-attachments --scheduled',
|
|
'schedule' => 'daily',
|
|
'description' => '방치된 임시 첨부 정리 + 보존기간 경과 삭제 첨부 영구 정리',
|
|
// 임시 첨부 정리 파트는 상시 동작해야 하므로 스케줄 자체는 항상 등록한다.
|
|
// 사용자 파일을 실제로 파기하는 영구 정리 파트만 커맨드 내부에서 게이트한다
|
|
// (attachment_settings.purge_enabled, false 폴백).
|
|
'enabled_config' => null,
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 모듈 권한 목록 반환 (계층형 구조, 다국어 지원)
|
|
*
|
|
* 구조: 모듈(1레벨) → 카테고리(2레벨) → 개별 권한(3레벨)
|
|
* identifier는 자동 생성됨: {module}.{category}.{action}
|
|
* 게시판별 권한(sirsoft-board.{slug}.*)은 게시판 생성 시 BoardPermissionService에서 동적으로 생성됨
|
|
*
|
|
* 모듈 레벨 권한만 정의:
|
|
* - sirsoft-board.boards.* (게시판 관리)
|
|
* - sirsoft-board.reports.* (신고 관리)
|
|
*/
|
|
public function getPermissions(): array
|
|
{
|
|
return [
|
|
'name' => [
|
|
'ko' => '게시판',
|
|
'en' => 'Board',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 모듈 권한',
|
|
'en' => 'Board module permissions',
|
|
],
|
|
'categories' => [
|
|
// 게시판 관리 권한 (type: admin)
|
|
[
|
|
'identifier' => 'boards',
|
|
'resource_route_key' => 'board',
|
|
'owner_key' => 'created_by',
|
|
'name' => [
|
|
'ko' => '게시판 관리',
|
|
'en' => 'Board Management',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 관리 권한',
|
|
'en' => 'Board management permissions',
|
|
],
|
|
'permissions' => [
|
|
[
|
|
'action' => 'read',
|
|
'name' => [
|
|
'ko' => '게시판 조회',
|
|
'en' => 'View Boards',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 목록 및 상세 조회',
|
|
'en' => 'View board list and details',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'manager'],
|
|
],
|
|
[
|
|
'action' => 'create',
|
|
'name' => [
|
|
'ko' => '게시판 생성',
|
|
'en' => 'Create Board',
|
|
],
|
|
'description' => [
|
|
'ko' => '새 게시판 생성',
|
|
'en' => 'Create new board',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'manager'],
|
|
],
|
|
[
|
|
'action' => 'update',
|
|
'name' => [
|
|
'ko' => '게시판 수정',
|
|
'en' => 'Update Board',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 설정 수정',
|
|
'en' => 'Update board settings',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'manager'],
|
|
],
|
|
[
|
|
'action' => 'delete',
|
|
'name' => [
|
|
'ko' => '게시판 삭제',
|
|
'en' => 'Delete Board',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 삭제',
|
|
'en' => 'Delete board',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
],
|
|
],
|
|
// 환경설정 권한 (type: admin)
|
|
[
|
|
'identifier' => 'settings',
|
|
'name' => [
|
|
'ko' => '환경설정',
|
|
'en' => 'Settings',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 환경설정 권한',
|
|
'en' => 'Board settings permissions',
|
|
],
|
|
'permissions' => [
|
|
[
|
|
'action' => 'read',
|
|
'name' => [
|
|
'ko' => '환경설정 조회',
|
|
'en' => 'View Settings',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 환경설정 조회',
|
|
'en' => 'View board settings',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
[
|
|
'action' => 'update',
|
|
'name' => [
|
|
'ko' => '환경설정 수정',
|
|
'en' => 'Update Settings',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 환경설정 수정',
|
|
'en' => 'Update board settings',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
],
|
|
],
|
|
// 본인인증 정책 관리 권한 (type: admin)
|
|
[
|
|
'identifier' => 'identity.policies',
|
|
'name' => [
|
|
'ko' => '게시판 본인인증 정책',
|
|
'en' => 'Board Identity Policies',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 컨텍스트의 본인인증 정책 관리 권한',
|
|
'en' => 'Manage identity verification policies in board context',
|
|
],
|
|
'permissions' => [
|
|
[
|
|
'action' => 'read',
|
|
'name' => [
|
|
'ko' => '본인인증 정책 조회',
|
|
'en' => 'View Identity Policies',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 본인인증 정책 조회',
|
|
'en' => 'View board identity policies',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
[
|
|
'action' => 'update',
|
|
'name' => [
|
|
'ko' => '본인인증 정책 수정',
|
|
'en' => 'Update Identity Policies',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 본인인증 정책 수정/추가/삭제',
|
|
'en' => 'Update, add, delete board identity policies',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
],
|
|
],
|
|
// 신고 관리 권한 (type: admin)
|
|
[
|
|
'identifier' => 'reports',
|
|
'resource_route_key' => 'report',
|
|
'owner_key' => 'reporter_id',
|
|
'name' => [
|
|
'ko' => '게시판 신고 관리',
|
|
'en' => 'Report Management',
|
|
],
|
|
'description' => [
|
|
'ko' => '게시판 신고 관리 권한',
|
|
'en' => 'Board report management permissions',
|
|
],
|
|
'permissions' => [
|
|
[
|
|
'action' => 'view',
|
|
'name' => [
|
|
'ko' => '신고 조회',
|
|
'en' => 'View Reports',
|
|
],
|
|
'description' => [
|
|
'ko' => '신고 목록 및 상세 조회',
|
|
'en' => 'View report list and details',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin', 'manager'],
|
|
],
|
|
[
|
|
'action' => 'manage',
|
|
'name' => [
|
|
'ko' => '신고 처리',
|
|
'en' => 'Manage Reports',
|
|
],
|
|
'description' => [
|
|
'ko' => '신고 상태 변경 및 처리',
|
|
'en' => 'Update report status and process',
|
|
],
|
|
'type' => 'admin',
|
|
'roles' => ['admin'],
|
|
],
|
|
],
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 모듈 설정 파일 목록 반환
|
|
*/
|
|
public function getConfig(): array
|
|
{
|
|
return [
|
|
'sirsoft-board' => $this->getModulePath().'/config/board.php',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 런타임 동적 권한 식별자 전수.
|
|
*
|
|
* BoardPermissionService 가 게시판 생성 시 아래 세 계층을 Permission 테이블에 기록한다:
|
|
* - {module} (모듈 루트)
|
|
* - {module}.{slug} (게시판 카테고리)
|
|
* - {module}.{slug}.{action} (action ∈ config board_permission_definitions)
|
|
*
|
|
* 모듈 루트는 getPermissions() 의 정적 식별자(moduleIdentifier) 와 동일하므로 생략.
|
|
* cleanup 시 이 목록에 포함된 식별자는 stale 로 판정되지 않는다.
|
|
*/
|
|
public function getDynamicPermissionIdentifiers(): array
|
|
{
|
|
if (! Schema::hasTable('boards')) {
|
|
return [];
|
|
}
|
|
|
|
$actions = array_keys((array) config('sirsoft-board.board_permission_definitions', []));
|
|
$module = $this->getIdentifier();
|
|
$ids = [];
|
|
foreach (Board::query()->select('slug')->get() as $board) {
|
|
$category = $module.'.'.$board->slug;
|
|
$ids[] = $category;
|
|
foreach ($actions as $action) {
|
|
$ids[] = $category.'.'.$action;
|
|
}
|
|
}
|
|
|
|
return $ids;
|
|
}
|
|
|
|
/**
|
|
* 런타임 동적 역할 식별자 전수.
|
|
*
|
|
* BoardService::createBoardRoles 가 게시판 생성 시 생성:
|
|
* - {module}.{slug}.manager
|
|
* - {module}.{slug}.step
|
|
*/
|
|
public function getDynamicRoleIdentifiers(): array
|
|
{
|
|
if (! Schema::hasTable('boards')) {
|
|
return [];
|
|
}
|
|
|
|
$module = $this->getIdentifier();
|
|
$ids = [];
|
|
foreach (Board::query()->select('slug')->get() as $board) {
|
|
$ids[] = $module.'.'.$board->slug.'.manager';
|
|
$ids[] = $module.'.'.$board->slug.'.step';
|
|
}
|
|
|
|
return $ids;
|
|
}
|
|
|
|
/**
|
|
* 런타임 동적 메뉴 slug 전수.
|
|
*
|
|
* BoardService 가 게시판 생성 시 `board-{slug}` 형식의 메뉴를 기록.
|
|
*/
|
|
public function getDynamicMenuSlugs(): array
|
|
{
|
|
if (! Schema::hasTable('boards')) {
|
|
return [];
|
|
}
|
|
|
|
$slugs = [];
|
|
foreach (Board::query()->select('slug')->get() as $board) {
|
|
$slugs[] = 'board-'.$board->slug;
|
|
}
|
|
|
|
return $slugs;
|
|
}
|
|
|
|
/**
|
|
* 모듈 설치 시 실행할 시더 목록 반환
|
|
*
|
|
* BoardTypeSeeder: 기본 게시판 유형(basic, gallery, card) 생성
|
|
* InstallSeeder: 기본 메일 템플릿 5종 생성
|
|
*
|
|
* 그 외 시더(DatabaseSeeder, BoardSampleSeeder, PostSampleSeeder, ReportSampleSeeder)는
|
|
* 테스트용 더미 데이터 시더이므로 설치 시 실행하지 않습니다.
|
|
* 테스트 데이터가 필요한 경우 수동으로 실행하세요:
|
|
* php artisan module:seed sirsoft-board
|
|
*
|
|
* @return array<class-string<Seeder>> 시더 클래스명 배열 (FQCN)
|
|
*/
|
|
public function getSeeders(): array
|
|
{
|
|
return [
|
|
BoardTypeSeeder::class,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 훅 리스너 목록 반환
|
|
*/
|
|
public function getHookListeners(): array
|
|
{
|
|
return [
|
|
UserNotificationSettingsListener::class,
|
|
SearchPostsListener::class,
|
|
BoardNotificationDataListener::class,
|
|
BoardNotificationChannelListener::class,
|
|
BoardActivityLogListener::class,
|
|
ActivityLogDescriptionResolver::class,
|
|
SeoBoardCacheListener::class,
|
|
SeoBoardSettingsCacheListener::class,
|
|
EcommerceInquiryHookListener::class,
|
|
PostCountSyncListener::class,
|
|
PostAttachmentCountSyncListener::class,
|
|
PostReplySyncListener::class,
|
|
CommentReplySyncListener::class,
|
|
BoardPostsCountSyncListener::class,
|
|
BoardCommentsCountSyncListener::class,
|
|
Ckeditor5ReferenceSourcesListener::class,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* SEO 변수 메타데이터 정의
|
|
*
|
|
* 게시판 모듈이 SEO 렌더링에 제공하는 변수를 page_type별로 선언합니다.
|
|
*
|
|
* @return array page_type별 변수 정의 배열
|
|
*/
|
|
public function seoVariables(): array
|
|
{
|
|
return [
|
|
'_common' => [
|
|
'site_name' => [
|
|
'description' => '사이트명',
|
|
'source' => 'core_setting',
|
|
'key' => 'general.site_name',
|
|
],
|
|
],
|
|
'boards' => [],
|
|
'board' => [
|
|
'board_name' => [
|
|
'description' => '게시판명',
|
|
'source' => 'data',
|
|
'required' => true,
|
|
],
|
|
'board_description' => [
|
|
'description' => '게시판 설명',
|
|
'source' => 'data',
|
|
],
|
|
],
|
|
'post' => [
|
|
'board_name' => [
|
|
'description' => '게시판명',
|
|
'source' => 'data',
|
|
'required' => true,
|
|
],
|
|
'post_title' => [
|
|
'description' => '게시글 제목',
|
|
'source' => 'data',
|
|
'required' => true,
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 페이지 타입별 OG 메타태그 기본값 선언
|
|
*
|
|
* 게시판 도메인에서 og:type=article, og:image, og:article:* 부속 태그를 직접 제공.
|
|
*
|
|
* @param string $pageType 페이지 타입
|
|
* @param array $context 데이터 컨텍스트
|
|
* @param array $routeParams 라우트 파라미터
|
|
* @return array OG 데이터
|
|
*/
|
|
public function seoOgDefaults(string $pageType, array $context, array $routeParams = []): array
|
|
{
|
|
if ($pageType === 'post') {
|
|
$post = data_get($context, 'post.data', []);
|
|
// 다국어 JSON array (MariaDB 환경) 자동 변환
|
|
$title = $this->resolveLocalizedValue($post['subject'] ?? $post['title'] ?? '');
|
|
|
|
$extra = [];
|
|
$publishedAt = (string) ($post['created_at'] ?? '');
|
|
if ($publishedAt !== '') {
|
|
$extra[] = ['property' => 'article:published_time', 'content' => $publishedAt];
|
|
}
|
|
$modifiedAt = (string) ($post['updated_at'] ?? '');
|
|
if ($modifiedAt !== '') {
|
|
$extra[] = ['property' => 'article:modified_time', 'content' => $modifiedAt];
|
|
}
|
|
$authorName = (string) (data_get($post, 'author.name') ?? data_get($post, 'user.name') ?? '');
|
|
if ($authorName !== '') {
|
|
$extra[] = ['property' => 'article:author', 'content' => $authorName];
|
|
}
|
|
$boardName = (string) (data_get($context, 'board.data.name') ?? '');
|
|
if ($boardName !== '') {
|
|
$extra[] = ['property' => 'article:section', 'content' => $boardName];
|
|
}
|
|
|
|
// PostResource toArray() 의 'thumbnail' 키 사용 (PostResource.php:183).
|
|
// 상대 경로(/api/...) 는 url() 로 절대 URL 변환 — Facebook/Threads/Slack 모두 절대 URL 필수.
|
|
$thumbnailRaw = (string) (data_get($post, 'thumbnail') ?? '');
|
|
$image = $thumbnailRaw !== ''
|
|
? (str_starts_with($thumbnailRaw, 'http') ? $thumbnailRaw : url($thumbnailRaw))
|
|
: '';
|
|
|
|
return array_filter([
|
|
'type' => 'article',
|
|
'image' => $image,
|
|
'image_alt' => $title,
|
|
'extra' => $extra,
|
|
], fn ($v) => $v !== null && $v !== '' && $v !== []);
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* 페이지 타입별 JSON-LD 구조화 데이터 선언
|
|
*
|
|
* 게시판 도메인 스키마(Article)를 모듈이 직접 owned.
|
|
*
|
|
* @param string $pageType 페이지 타입
|
|
* @param array $context 데이터 컨텍스트
|
|
* @param array $routeParams 라우트 파라미터
|
|
* @return array Schema.org Article 형식
|
|
*/
|
|
public function seoStructuredData(string $pageType, array $context, array $routeParams = []): array
|
|
{
|
|
if ($pageType !== 'post') {
|
|
return [];
|
|
}
|
|
|
|
$post = data_get($context, 'post.data', []);
|
|
if (empty($post)) {
|
|
return [];
|
|
}
|
|
|
|
// 다국어 JSON array 안전 변환
|
|
$headline = $this->resolveLocalizedValue($post['subject'] ?? $post['title'] ?? '');
|
|
if ($headline === '') {
|
|
return [];
|
|
}
|
|
|
|
$schema = [
|
|
'@type' => 'Article',
|
|
'headline' => $headline,
|
|
];
|
|
|
|
$description = $this->resolveLocalizedValue($post['summary'] ?? $post['excerpt'] ?? $post['content_text'] ?? '');
|
|
if ($description !== '') {
|
|
$schema['description'] = mb_substr(strip_tags($description), 0, 200);
|
|
}
|
|
|
|
// 썸네일 URL — thumbnail 키 우선 + 절대 URL 변환
|
|
$thumbnailRaw = (string) (data_get($post, 'thumbnail') ?? '');
|
|
if ($thumbnailRaw !== '') {
|
|
$schema['image'] = str_starts_with($thumbnailRaw, 'http') ? $thumbnailRaw : url($thumbnailRaw);
|
|
}
|
|
|
|
$publishedAt = (string) ($post['created_at'] ?? '');
|
|
if ($publishedAt !== '') {
|
|
$schema['datePublished'] = $publishedAt;
|
|
}
|
|
$modifiedAt = (string) ($post['updated_at'] ?? '');
|
|
if ($modifiedAt !== '') {
|
|
$schema['dateModified'] = $modifiedAt;
|
|
}
|
|
|
|
$authorName = (string) (data_get($post, 'author.name') ?? data_get($post, 'user.name') ?? '');
|
|
if ($authorName !== '') {
|
|
$schema['author'] = [
|
|
'@type' => 'Person',
|
|
'name' => $authorName,
|
|
];
|
|
}
|
|
|
|
$publisherName = (string) g7_core_settings('general.site_name', '');
|
|
if ($publisherName !== '') {
|
|
$schema['publisher'] = [
|
|
'@type' => 'Organization',
|
|
'name' => $publisherName,
|
|
];
|
|
}
|
|
|
|
return $schema;
|
|
}
|
|
|
|
/**
|
|
* OG 기본값 키별 데이터 출처(연결 칩) 메타 선언 — 편집기 전용
|
|
*
|
|
* seoOgDefaults() 가 resolve 해 반환하는 평문값이 **어느 게시글 데이터에서 왔는지**를 편집기
|
|
* [검색엔진] 탭이 "대표 이미지"·"게시글 제목" 같은 연결 칩으로 보여주고 교체할 수 있도록,
|
|
* 키별 데이터 경로(표현식)와 사용자용 라벨을 제공합니다. 단순 1:1 경로 키만 선언합니다.
|
|
*
|
|
* @param string $pageType 페이지 타입
|
|
* @return array<string, array{expr: string, label: array<string, string>}> 키별 데이터 경로 메타
|
|
*/
|
|
public function seoOgDefaultMeta(string $pageType): array
|
|
{
|
|
// label 은 번역 키 — 번들 언어팩(ja 등)이 같은 키를 번역하면 추가 언어에 자동 대응(편집기가 __() 해석).
|
|
if ($pageType === 'post') {
|
|
return [
|
|
'image' => ['expr' => '{{post.data.thumbnail}}', 'label' => 'sirsoft-board::seo.auto_value.post_image'],
|
|
'image_alt' => ['expr' => '{{post.data.subject}}', 'label' => 'sirsoft-board::seo.auto_value.post_title'],
|
|
];
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* 구조화 데이터 속성별 데이터 출처(연결 칩) 메타 선언 — 편집기 전용
|
|
*
|
|
* seoStructuredData() 의 Article 스키마를 점 경로 키로 평탄화한 기준으로 선언합니다. 파생값
|
|
* (description=strip_tags·datePublished·author.* 등)은 단순 경로가 아니라 제외합니다(평문 폴백).
|
|
*
|
|
* @param string $pageType 페이지 타입
|
|
* @return array<string, array{expr: string, label: array<string, string>}> 점 경로 키별 데이터 경로 메타
|
|
*/
|
|
public function seoStructuredDataMeta(string $pageType): array
|
|
{
|
|
if ($pageType !== 'post') {
|
|
return [];
|
|
}
|
|
|
|
return [
|
|
'headline' => ['expr' => '{{post.data.subject}}', 'label' => 'sirsoft-board::seo.auto_value.post_title'],
|
|
'image' => ['expr' => '{{post.data.thumbnail}}', 'label' => 'sirsoft-board::seo.auto_value.post_image'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 스토리지 디스크 설정 반환
|
|
*/
|
|
public function getStorageDisk(): string
|
|
{
|
|
return config('sirsoft-board.attachment.disk', 'modules');
|
|
}
|
|
|
|
/**
|
|
* 관리자 메뉴 정의
|
|
*/
|
|
public function getAdminMenus(): array
|
|
{
|
|
return [
|
|
[
|
|
'name' => [
|
|
'ko' => '게시판 관리',
|
|
'en' => 'Board Management',
|
|
],
|
|
'slug' => 'sirsoft-board',
|
|
'url' => null,
|
|
'icon' => 'fas fa-clipboard-list',
|
|
'order' => 30,
|
|
'children' => [
|
|
[
|
|
'name' => [
|
|
'ko' => '환경설정',
|
|
'en' => 'Settings',
|
|
],
|
|
'slug' => 'sirsoft-board-settings',
|
|
'url' => '/admin/boards/settings',
|
|
'icon' => 'fas fa-cog',
|
|
'order' => 1,
|
|
'permission' => 'sirsoft-board.settings.read',
|
|
],
|
|
[
|
|
'name' => [
|
|
'ko' => '게시판 목록',
|
|
'en' => 'Board List',
|
|
],
|
|
'slug' => 'sirsoft-board-list',
|
|
'url' => '/admin/boards',
|
|
'icon' => 'fas fa-list',
|
|
'order' => 2,
|
|
'permission' => 'sirsoft-board.boards.read',
|
|
],
|
|
[
|
|
'name' => [
|
|
'ko' => '게시판 신고현황',
|
|
'en' => 'Board Reports',
|
|
],
|
|
'slug' => 'sirsoft-board-reports',
|
|
'url' => '/admin/boards/reports',
|
|
'icon' => 'fas fa-flag',
|
|
'order' => 3,
|
|
'permission' => 'sirsoft-board.reports.view',
|
|
],
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 게시판 모듈이 선언하는 IDV 정책 목록.
|
|
*
|
|
* 코어 IDV 인프라가 install/update 시 IdentityPolicySyncHelper 를 통해 자동 동기화한다.
|
|
* 운영자가 S1d / 게시판 환경설정 > 본인인증 탭 에서 enabled / grace_minutes / provider_id /
|
|
* fail_mode 4 필드를 수정하면 user_overrides 에 기록되어 모듈 재설치 시에도 보존된다.
|
|
*
|
|
* @return array<int, array<string, mixed>>
|
|
*/
|
|
public function getIdentityPolicies(): array
|
|
{
|
|
return [
|
|
// 게시글 개별 삭제 (관리자 민감 작업)
|
|
[
|
|
'key' => 'sirsoft-board.post.delete',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.post.before_delete',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 5,
|
|
'enabled' => false,
|
|
'applies_to' => 'admin',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 게시글 블라인드 (관리자 민감 작업)
|
|
[
|
|
'key' => 'sirsoft-board.post.blind',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.post.before_blind',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 5,
|
|
'enabled' => false,
|
|
'applies_to' => 'admin',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 신고 일괄 처리 (관리자 민감 작업)
|
|
[
|
|
'key' => 'sirsoft-board.report.bulk_action',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.report.before_bulk_update_status',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 5,
|
|
'enabled' => false,
|
|
'applies_to' => 'admin',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 신고 삭제 (관리자 민감 작업)
|
|
[
|
|
'key' => 'sirsoft-board.report.delete',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.report.before_delete',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 0,
|
|
'enabled' => false,
|
|
'applies_to' => 'admin',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 자기 글 삭제 (사용자 본인 작업) — 계정 탈취 시 게시물 일괄 삭제 차단.
|
|
// post.delete 정책과 같은 훅(before_delete)을 공유하지만 applies_to=self 로 분기됨.
|
|
[
|
|
'key' => 'sirsoft-board.post.user_delete',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.post.before_delete',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 0,
|
|
'enabled' => false,
|
|
'applies_to' => 'self',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 자기 댓글 삭제 (사용자 본인 작업) — 빈도 높아 grace 길게
|
|
[
|
|
'key' => 'sirsoft-board.comment.user_delete',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.comment.before_delete',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 30,
|
|
'enabled' => false,
|
|
'applies_to' => 'self',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 신고 작성 (사용자 본인 작업) — 악성/장난 신고 방지
|
|
[
|
|
'key' => 'sirsoft-board.report.create',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.report.before_create',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 30,
|
|
'enabled' => false,
|
|
'applies_to' => 'self',
|
|
'fail_mode' => 'block',
|
|
],
|
|
// 첫 글 작성 (사용자 본인 작업) — 스팸봇 방지
|
|
[
|
|
'key' => 'sirsoft-board.post.user_create',
|
|
'scope' => 'hook',
|
|
'target' => 'sirsoft-board.post.before_create',
|
|
'purpose' => 'sensitive_action',
|
|
'grace_minutes' => 0,
|
|
'enabled' => false,
|
|
'applies_to' => 'self',
|
|
'fail_mode' => 'block',
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 게시판 모듈이 등록할 IDV purpose 목록.
|
|
*
|
|
* 게시판은 코어 sensitive_action 으로 충분하므로 신규 purpose 를 도입하지 않는다.
|
|
*
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
public function getIdentityPurposes(): array
|
|
{
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* 게시판 모듈이 등록할 IDV 메시지 정의.
|
|
*
|
|
* 현재 4개 정책 모두 purpose=sensitive_action 을 사용하므로 코어 fallback
|
|
* (`provider=g7:core.mail`, `scope_type=purpose`, `scope_value=sensitive_action`)
|
|
* 메시지로 충분하다. 게시판 도메인에 특화된 문구가 필요해지거나 사용자 측 정책
|
|
* (예: 자기 글 삭제, 신고 작성)이 추가되면 여기에 등록한다.
|
|
*
|
|
* @return array<int, array<string, mixed>>
|
|
*/
|
|
public function getIdentityMessages(): array
|
|
{
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* 게시판 모듈이 등록할 알림 정의.
|
|
*
|
|
* AbstractModule 계약에 따라 ModuleManager 가 activate/update 시 자동으로
|
|
* NotificationSyncHelper 를 통해 동기화하며, uninstall(deleteData=true) 시 정리합니다.
|
|
* 운영자가 관리자 UI 에서 수정한 필드는 user_overrides JSON 에 보존됩니다.
|
|
*
|
|
* `extension_type`/`extension_identifier` 는 Manager 가 자동 주입.
|
|
*
|
|
* @return array<int, array<string, mixed>>
|
|
*/
|
|
public function getNotificationDefinitions(): array
|
|
{
|
|
return [
|
|
$this->newCommentDefinition(),
|
|
$this->replyCommentDefinition(),
|
|
$this->postReplyDefinition(),
|
|
$this->postActionDefinition(),
|
|
$this->newPostAdminDefinition(),
|
|
$this->reportReceivedAdminDefinition(),
|
|
$this->reportActionDefinition(),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 성능 계측 프로파일 정의 (`g7:bench`).
|
|
*
|
|
* 게시글 목록의 `columns` 는 `PostRepository::paginate()` 가 select 하는 컬럼 집합입니다
|
|
* (본문 미리보기용 `SUBSTRING` 표현식은 지연 조인의 outer 에서만 적용되고 계측 대상인
|
|
* 건너뛰기 비용과 무관하므로 제외). 게시글 목록은 화면이 게시판 하나를 조회하므로 필터
|
|
* 없이 재면 인덱스 선택이 달라져 화면에서 일어나는 일과 다른 것을 재게 됩니다.
|
|
*
|
|
* @return array<string, array<string, mixed>> 프로파일 키 → 정의
|
|
*/
|
|
public function getBenchmarkProfiles(): array
|
|
{
|
|
return [
|
|
'board_posts' => [
|
|
'type' => 'list',
|
|
'label' => '게시글 목록',
|
|
'table' => 'board_posts',
|
|
'columns' => [
|
|
'id', 'board_id', 'user_id', 'parent_id', 'category',
|
|
'title', 'author_name', 'content_mode',
|
|
'is_notice', 'is_secret', 'status', 'depth',
|
|
'view_count', 'comments_count', 'replies_count', 'attachments_count',
|
|
'trigger_type', 'ip_address', 'created_at', 'updated_at', 'deleted_at',
|
|
],
|
|
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
|
// 실제 목록 쿼리(PostRepository::buildSortedPostList)는 공지와 답글을 빼고
|
|
// 원글만 페이지네이션한다. 필터를 board_id 만 걸면 등치 사슬이 is_notice 에서
|
|
// 끊겨 옵티마이저가 다른 인덱스를 골라, 제품이 실행하지 않는 실행 계획을 재게 된다.
|
|
'filters' => ['board_id' => 1, 'is_notice' => 0, 'parent_id' => null],
|
|
'seed_overrides' => ['board_id' => 1, 'is_notice' => 0, 'parent_id' => null],
|
|
'soft_delete' => true,
|
|
],
|
|
'board_posts_by_view_count' => [
|
|
'type' => 'list',
|
|
'label' => '게시글 목록 (조회순)',
|
|
'table' => 'board_posts',
|
|
'columns' => [
|
|
'id', 'board_id', 'user_id', 'parent_id', 'category',
|
|
'title', 'author_name', 'content_mode',
|
|
'is_notice', 'is_secret', 'status', 'depth',
|
|
'view_count', 'comments_count', 'replies_count', 'attachments_count',
|
|
'trigger_type', 'ip_address', 'created_at', 'updated_at', 'deleted_at',
|
|
],
|
|
// 조회수 정렬은 화면에서 실제로 도달 가능한 경로다 — 게시판 설정
|
|
// `order_by='view_count'` 와 목록 URL `?sort_by=view_count` 둘 다 있고,
|
|
// 저장소 정렬 화이트리스트에도 들어 있다. 작성일 정렬과 같은 술어에
|
|
// 정렬 축만 다르므로 별도 프로파일로 재야 인덱스 커버리지가 판정된다.
|
|
'order' => [['view_count', 'desc'], ['id', 'desc']],
|
|
'filters' => ['board_id' => 1, 'is_notice' => 0, 'parent_id' => null],
|
|
'seed_overrides' => ['board_id' => 1, 'is_notice' => 0, 'parent_id' => null],
|
|
'soft_delete' => true,
|
|
],
|
|
// 댓글은 계측 프로파일을 두지 않는다. 페이지네이션되는 댓글 목록은 회원 본인 댓글
|
|
// 목록뿐이고(CommentRepository), 그 쿼리에는 회원 스코프 · 삭제 게시글 제외
|
|
// (whereExists 서브쿼리) · 비활성 게시판 제외가 무조건 붙는다. 선언형 필터로
|
|
// 재현할 수 없는 술어라, 맨 테이블 스캔을 재면 어느 화면도 내지 않는 수치가 된다.
|
|
'reports' => [
|
|
'type' => 'list',
|
|
'label' => '신고 목록',
|
|
'table' => 'boards_reports',
|
|
'columns' => ['*'],
|
|
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
|
'soft_delete' => true,
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 새 댓글 알림 정의.
|
|
*/
|
|
private function newCommentDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'new_comment',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '새 댓글 알림', 'en' => 'New Comment Notification'],
|
|
'description' => ['ko' => '게시글에 새 댓글이 작성되면 게시글 작성자에게 발송', 'en' => 'Sent to post author when a new comment is posted'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.comment.after_create'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'comment_author', 'description' => '댓글 작성자'],
|
|
['key' => 'comment_content', 'description' => '댓글 내용 (200자)'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author', 'exclude_trigger_user' => true]],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] 게시글에 새 댓글이 등록되었습니다',
|
|
'en' => '[{board_name}] New comment on your post',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판의 게시글에 <strong>{comment_author}</strong>님이 댓글을 남겼습니다.</p>'
|
|
.'<blockquote style="border-left: 3px solid #cbd5e0; padding-left: 12px; color: #718096;">{comment_content}</blockquote>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p><strong>{comment_author}</strong> commented on your post in <strong>{board_name}</strong>.</p>'
|
|
.'<blockquote style="border-left: 3px solid #cbd5e0; padding-left: 12px; color: #718096;">{comment_content}</blockquote>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author', 'exclude_trigger_user' => true]],
|
|
'subject' => ['ko' => '게시글에 새 댓글이 달렸습니다', 'en' => 'New comment on your post'],
|
|
'body' => ['ko' => '{comment_author}님이 \'{board_name}\' 게시글 \'{post_title}\'에 댓글을 남겼습니다.', 'en' => '{comment_author} commented on your post \'{post_title}\' in \'{board_name}\'.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 대댓글 알림 정의.
|
|
*/
|
|
private function replyCommentDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'reply_comment',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '대댓글 알림', 'en' => 'Reply Comment Notification'],
|
|
'description' => ['ko' => '댓글에 대댓글이 작성되면 댓글 작성자에게 발송', 'en' => 'Sent to comment author when a reply is posted'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.comment.after_create'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'comment_author', 'description' => '답글 작성자'],
|
|
['key' => 'comment_content', 'description' => '답글 내용 (200자)'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'parent_comment_author', 'exclude_trigger_user' => true]],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] 댓글에 답글이 등록되었습니다',
|
|
'en' => '[{board_name}] Reply to your comment',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판에서 <strong>{comment_author}</strong>님이 댓글에 답글을 남겼습니다.</p>'
|
|
.'<blockquote style="border-left: 3px solid #cbd5e0; padding-left: 12px; color: #718096;">{comment_content}</blockquote>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p><strong>{comment_author}</strong> replied to your comment in <strong>{board_name}</strong>.</p>'
|
|
.'<blockquote style="border-left: 3px solid #cbd5e0; padding-left: 12px; color: #718096;">{comment_content}</blockquote>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'parent_comment_author', 'exclude_trigger_user' => true]],
|
|
'subject' => ['ko' => '댓글에 답글이 달렸습니다', 'en' => 'New reply to your comment'],
|
|
'body' => ['ko' => '{comment_author}님이 \'{board_name}\'의 댓글에 답글을 남겼습니다.', 'en' => '{comment_author} replied to your comment in \'{board_name}\'.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 답변글 알림 정의.
|
|
*/
|
|
private function postReplyDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'post_reply',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '답변글 알림', 'en' => 'Post Reply Notification'],
|
|
'description' => ['ko' => '게시글에 답변글이 작성되면 원글 작성자에게 발송', 'en' => 'Sent to original post author when a reply post is created'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.post.after_create'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'original_post_author', 'exclude_trigger_user' => true]],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] 게시글에 답변글이 등록되었습니다',
|
|
'en' => '[{board_name}] Reply to your post',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판의 게시글 "<strong>{post_title}</strong>"에 답변글이 등록되었습니다.</p>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p>A reply has been posted to your post "<strong>{post_title}</strong>" in <strong>{board_name}</strong>.</p>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'original_post_author', 'exclude_trigger_user' => true]],
|
|
'subject' => ['ko' => '게시글에 답변이 등록되었습니다', 'en' => 'A reply has been posted to your post'],
|
|
'body' => ['ko' => '\'{board_name}\'의 게시글 \'{post_title}\'에 답변이 등록되었습니다.', 'en' => 'A reply has been posted to your post \'{post_title}\' in \'{board_name}\'.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 게시글 처리 알림 정의.
|
|
*/
|
|
private function postActionDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'post_action',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '게시글/댓글 처리 알림', 'en' => 'Content Action Notification'],
|
|
'description' => ['ko' => '게시글/댓글 블라인드/삭제/복원 시 작성자에게 발송', 'en' => 'Sent to author on blind/delete/restore actions'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.post.after_blind', 'sirsoft-board.post.after_delete', 'sirsoft-board.post.after_restore', 'sirsoft-board.comment.after_blind', 'sirsoft-board.comment.after_delete', 'sirsoft-board.comment.after_restore'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'action_type', 'description' => '처리 유형 (블라인드/삭제/복원)'],
|
|
['key' => 'target_type', 'description' => '처리 대상 (게시글/댓글)'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author']],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] \'{post_title}\' {target_type}이(가) {action_type} 처리되었습니다',
|
|
'en' => '[{board_name}] Your {target_type} "{post_title}" has been {action_type}',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판의 "<strong>{post_title}</strong>" {target_type}이(가) 관리자에 의해 <strong>{action_type}</strong> 처리되었습니다.</p>'
|
|
.'<p>문의사항이 있으시면 관리자에게 연락해 주세요.</p>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p>Your {target_type} "<strong>{post_title}</strong>" in <strong>{board_name}</strong> has been <strong>{action_type}</strong> by an administrator.</p>'
|
|
.'<p>If you have any questions, please contact the administrator.</p>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author']],
|
|
'subject' => ['ko' => '{target_type}이(가) 처리되었습니다', 'en' => 'Your {target_type} has been actioned'],
|
|
'body' => ['ko' => '\'{board_name}\'의 \'{post_title}\' {target_type}이(가) {action_type} 처리되었습니다.', 'en' => 'Your {target_type} \'{post_title}\' in \'{board_name}\' has been {action_type}.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 관리자 새 게시글 알림 정의.
|
|
*/
|
|
private function newPostAdminDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'new_post_admin',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '새 게시글 관리자 알림', 'en' => 'New Post Admin Notification'],
|
|
'description' => ['ko' => '새 게시글 작성 시 관리자에게 발송', 'en' => 'Sent to admin when a new post is created'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.post.after_create'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름 (관리자)'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'post_author', 'description' => '게시글 작성자'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'board_managers', 'exclude_trigger_user' => true]],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] 새 게시글이 등록되었습니다',
|
|
'en' => '[{board_name}] New post has been created',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판에 <strong>{post_author}</strong>님이 새 게시글을 등록했습니다.</p>'
|
|
.'<p>게시글 제목: <strong>{post_title}</strong></p>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p><strong>{post_author}</strong> created a new post in <strong>{board_name}</strong>.</p>'
|
|
.'<p>Title: <strong>{post_title}</strong></p>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'board_managers', 'exclude_trigger_user' => true]],
|
|
'subject' => ['ko' => '새 게시글이 등록되었습니다', 'en' => 'New post registered'],
|
|
'body' => ['ko' => '{post_author}님이 \'{board_name}\'에 새 게시글 \'{post_title}\'을 등록했습니다.', 'en' => '{post_author} posted \'{post_title}\' in \'{board_name}\'.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 신고 접수 관리자 알림 정의.
|
|
*/
|
|
private function reportReceivedAdminDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'report_received_admin',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '신고 접수 관리자 알림', 'en' => 'Report Received Admin Notification'],
|
|
'description' => ['ko' => '신고 접수 시 관리자에게 발송', 'en' => 'Sent to admin when a report is received'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.report.after_create'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '신고 대상 게시글 제목'],
|
|
['key' => 'target_type', 'description' => '신고 대상 유형 (게시글/댓글)'],
|
|
['key' => 'reason_type', 'description' => '신고 사유'],
|
|
['key' => 'report_url', 'description' => '신고 관리 페이지 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'permission', 'value' => 'sirsoft-board.reports.manage', 'exclude_trigger_user' => true]],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] "{post_title}"에 대한 신고가 접수되었습니다',
|
|
'en' => '[{board_name}] A new report has been received for "{post_title}"',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판에서 <strong>{target_type}</strong> "<strong>{post_title}</strong>"에 대한 새 신고가 접수되었습니다.</p>'
|
|
.'<p>신고 사유: <strong>{reason_type}</strong></p>'
|
|
.$this->notificationButton('신고 관리 페이지로 이동', '{report_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p>A new report has been received for the <strong>{target_type}</strong> "<strong>{post_title}</strong>" in <strong>{board_name}</strong>.</p>'
|
|
.'<p>Reason: <strong>{reason_type}</strong></p>'
|
|
.$this->notificationButton('Go to Report Management', '{report_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'permission', 'value' => 'sirsoft-board.reports.manage', 'exclude_trigger_user' => true]],
|
|
'subject' => ['ko' => '신고가 접수되었습니다', 'en' => 'New report received'],
|
|
'body' => ['ko' => '\'{board_name}\'의 {target_type} \'{post_title}\'에 대한 신고({reason_type})가 접수되었습니다.', 'en' => 'A report ({reason_type}) on {target_type} \'{post_title}\' in \'{board_name}\' has been received.'],
|
|
'click_url' => '{report_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 신고 처리 결과 알림 정의.
|
|
*/
|
|
private function reportActionDefinition(): array
|
|
{
|
|
return [
|
|
'type' => 'report_action',
|
|
'hook_prefix' => 'sirsoft-board',
|
|
'name' => ['ko' => '신고 처리 결과 알림', 'en' => 'Report Action Notification'],
|
|
'description' => ['ko' => '신고 처리 완료 시 게시글 작성자에게 발송', 'en' => 'Sent to post author when a report action is taken'],
|
|
'channels' => ['mail', 'database'],
|
|
'hooks' => ['sirsoft-board.post.after_blind', 'sirsoft-board.post.after_delete', 'sirsoft-board.post.after_restore', 'sirsoft-board.comment.after_blind', 'sirsoft-board.comment.after_delete', 'sirsoft-board.comment.after_restore'],
|
|
'variables' => [
|
|
['key' => 'name', 'description' => '수신자 이름'],
|
|
['key' => 'app_name', 'description' => '사이트명'],
|
|
['key' => 'board_name', 'description' => '게시판 이름'],
|
|
['key' => 'post_title', 'description' => '게시글 제목'],
|
|
['key' => 'action_type', 'description' => '처리 유형 (블라인드/삭제/복원)'],
|
|
['key' => 'target_type', 'description' => '처리 대상 (게시글/댓글)'],
|
|
['key' => 'post_url', 'description' => '게시글 URL'],
|
|
['key' => 'site_url', 'description' => '사이트 URL'],
|
|
],
|
|
'templates' => [
|
|
[
|
|
'channel' => 'mail',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author']],
|
|
'subject' => [
|
|
'ko' => '[{board_name}] \'{post_title}\' {target_type}이(가) {action_type} 처리되었습니다',
|
|
'en' => '[{board_name}] Your {target_type} "{post_title}" has been {action_type}',
|
|
],
|
|
'body' => [
|
|
'ko' => '<h1>{name}님, 안녕하세요.</h1>'
|
|
.'<p><strong>{board_name}</strong> 게시판의 "<strong>{post_title}</strong>" {target_type}이(가) 신고 처리에 의해 <strong>{action_type}</strong> 처리되었습니다.</p>'
|
|
.'<p>문의사항이 있으시면 관리자에게 연락해 주세요.</p>'
|
|
.$this->notificationButton('게시글 보기', '{post_url}')
|
|
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
|
|
'en' => '<h1>Hello, {name}.</h1>'
|
|
.'<p>Your {target_type} "<strong>{post_title}</strong>" in <strong>{board_name}</strong> has been <strong>{action_type}</strong> due to reports.</p>'
|
|
.'<p>If you have any questions, please contact the administrator.</p>'
|
|
.$this->notificationButton('View Post', '{post_url}')
|
|
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
|
|
],
|
|
],
|
|
[
|
|
'channel' => 'database',
|
|
'recipients' => [['type' => 'related_user', 'relation' => 'post_author']],
|
|
'subject' => ['ko' => '신고 처리 결과 안내', 'en' => 'Report action result'],
|
|
'body' => ['ko' => '\'{board_name}\'의 \'{post_title}\' {target_type}이(가) {action_type} 처리되었습니다.', 'en' => 'Your {target_type} \'{post_title}\' in \'{board_name}\' has been {action_type}.'],
|
|
'click_url' => '{post_url}',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 이메일 호환 CTA 버튼 HTML 을 생성합니다.
|
|
*
|
|
* @param string $text 버튼 텍스트
|
|
* @param string $url 버튼 링크 URL
|
|
* @return string 인라인 스타일 버튼 HTML
|
|
*/
|
|
private function notificationButton(string $text, string $url): string
|
|
{
|
|
return '<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 24px 0;">'
|
|
.'<tr><td align="center">'
|
|
.'<a href="'.$url.'" style="display: inline-block; padding: 12px 32px; background-color: #2d3748; color: #ffffff; text-decoration: none; border-radius: 4px; font-weight: 600; font-size: 14px;">'
|
|
.$text
|
|
.'</a>'
|
|
.'</td></tr></table>';
|
|
}
|
|
}
|