 |
요약 | 페이지 로드 시 전체 포럼 위에 풀스크린 커버 이미지를 표시하는 Discourse 테마 컴포넌트입니다. |
 |
저장소 | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
설치 가이드 | 테마 또는 테마 컴포넌트 설치 방법 |
 |
Discourse 테마 초보이신가요? | Discourse 테마 사용 입문 가이드 |
이 테마 컴포넌트 설치
페이지 로드 시 전체 포럼 위에 풀스크린 커버 이미지를 표시하는 Discourse 테마 컴포넌트입니다.
원래 정부 기관(“이 사이트는 압수되었습니다”)을 위해 개발되었지만, 유지보수 공지, 스플래시 화면, 이벤트 공지 등 어떤 용도에도 사용할 수 있을 만큼 범용적입니다.
작동 방식
페이지 로드 시 이미지는 화면 중앙에 렌더링되며, 종횡비(object-fit: contain)를 유지하면서 뷰포트의 가능한 한 많은 부분을 채우도록 확장됩니다. 이미지 바깥쪽 나머지 영역은 설정 가능한 배경색으로 채워집니다.
오버레이는 다음 두 조건 중 어느 쪽이든 먼저 충족되면 사라집니다:
- 설정된 초(second) 수가 경과했거나,
- 사용자가 오버레이를 설정된 회수만큼 클릭했습니다.
해당 해제 방법을 비활성화하려면 값을 0으로 설정하세요.
설정
| 설정 | 유형 | 기본값 | 설명 |
|---|---|---|---|
cover_image |
업로드 | (없음) | 풀스크린으로 표시할 이미지 |
trigger_after |
문자열 | (없음) | 오버레이가 활성화되는 시점 (ISO-8601 UTC 날짜/시간), 예: 2026-04-01T08:00:00Z |
display_seconds |
정수 | 5 |
자동 해제까지의 초 단위 시간 (0 = 절대 해제 안 함) |
dismiss_on_clicks |
정수 | 3 |
해제에 필요한 클릭 횟수 (0 = 비활성화) |
background_color |
문자열 | #000000 |
이미지 바깥 영역의 CSS 색상 |
쿠키 동작 방식
방문자가 오버레이를 해제(타이머 또는 클릭)하면 tc_coverimage_seen이라는 이름의 쿠키가 설정되어 trigger_after 값이 기록됩니다. trigger_after가 새로운 값으로 변경될 때까지 오버레이는 다시 표시되지 않습니다 — 이는 모든 사용자의 확인 상태를 초기화하여 다음 페이지 이동 시 다시 표시되도록 합니다.
예시
trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0, dismiss_on_clicks: 1로 설정하면, 4월 1일 UTC 자정에 활성화되는 1회 클릭 스플래시가 되어 각 방문자는 한 번만 확인하게 됩니다.
물론 이 테마 컴포넌트는 정부 기관을 위해 개발된 것이 아니라, 이를 친절하게 오픈소스로 공개해 주신 @WorldIsMine을 위해 개발되었습니다 
