1. 파일 구성
설치 패키지(attendance-skin-v1.5.0.zip)의 파일 목록과 역할입니다.| 파일 경로 | 역할 |
| boards/skins/attendance/list.php | 달력형 출석 현황, 개근왕, 오늘 출석 목록, 포인트 안내 모달 |
| boards/skins/attendance/view.php | 개인 출석 달력, 연속/최장 출석 통계, 날짜 클릭 메시지 |
| boards/skins/attendance/write.php | 출석 도장 찍기 폼 (한 줄 메시지 입력) |
| boards/skins/attendance/assets/style.css | 전체 UI 스타일 |
| boards/skins/attendance/skin.json | 스킨 메타 정보 |
| extend/middle/10_attendance_point.php | dx_after_write 훅 — 포인트 지급 및 만근 체크 |
| 📂 설치 방법 1. ZIP 압축 해제 후 아래 두 폴더를 서버에 복사합니다. • boards/skins/attendance/ → 서버의 boards/skins/attendance/ 에 복사 • extend/middle/10_attendance_point.php → 서버의 extend/middle/ 에 복사 2. 관리자 → 게시판 관리 → 게시판 추가 • 스킨: attendance 선택 후 저장 3. 설치 완료! 첫 접근 시 dx_attendance 테이블이 자동 생성됩니다. |
2. 데이터베이스
스킨은 DXCMS 코어 테이블 외에 dx_attendance 테이블 1개만 추가로 사용합니다.별도 DB 작업 없이 스킨 첫 접근 시 자동으로 생성됩니다.
dx_attendance 테이블
| 컬럼 | 타입 | 설명 |
| id | BIGINT | AUTO_INCREMENT, PK |
| member_id | INT | 회원 ID (외래키) |
| board_id | INT | 게시판 ID |
| post_id | BIGINT | 출석 게시글 ID |
| attend_date | DATE | 출석 날짜 (YYYY-MM-DD) |
| message | VARCHAR(255) | 출석 한 줄 메시지 (선택) |
| created_at | DATETIME | 출석 등록 시각 |
| 🔑 UNIQUE KEY UNIQUE KEY uk_att (member_id, board_id, attend_date) → 동일 회원이 같은 게시판에 같은 날 중복 출석을 DB 레벨에서 차단합니다. * 포인트 지급 로직은 extend/middle/10_attendance_point.php 의 dx_after_write 훅에서 처리됩니다. * 포인트 이력은 DXCMS 기존 point_log 테이블에 함께 기록됩니다. |
3. 포인트 지급 시스템
| 구분 | 설명 | 지급 포인트 | 중복 지급 |
| 📌 일일 출석 | 매일 1회 출석 도장 찍기 | +10P | 하루 1회 |
| 🏆 월 만근 보너스 | 해당 월 전일 출석 완료 시 | +100P | 월 1회 |
일일 출석 (+10P)
출석 도장 찍기 버튼 → write.php → dx_after_write 훅 → 포인트 지급 순서로 처리됩니다.
- 하루 1회만 인정 (UNIQUE KEY로 중복 방지)
- DxPoint::add(member_id, 'attend', 10, 'post', post_id, 메모) 호출
- 포인트 타입: attend
월 만근 보너스 (+100P)
해당 월 마지막 날 출석 시 자동으로 만근 여부를 체크합니다.
- 체크 조건: 오늘이 해당 월 마지막 날 (date('t') === date('j'))
- 이번 달 출석 횟수 = 이번 달 전체 일수 일 때 만근 판정
- point_log 에서 attend_perfect 타입 + 해당 연월 기록 확인 → 중복 지급 방지
- DxPoint::add(member_id, 'attend_perfect', 100, ...) 호출
- 포인트 타입: attend_perfect
| 💡 포인트 타입 커스터마이징 extend/middle/10_attendance_point.php 파일에서 아래 값을 직접 수정할 수 있습니다. • 일일 출석 포인트: DxPoint::add(..., 10, ...) 에서 10 변경 • 만근 보너스 포인트: DxPoint::add(..., 100, ...) 에서 100 변경 |
4. 화면 구성
4-1. 목록 페이지 (list.php)
- 헤더: 이번 달 출석 통계 + 포인트 안내 모달 버튼
- 출석 버튼: 오늘 미출석 시 [출석 도장 찍기] 버튼 표시, 출석 완료 시 [오늘 출석 완료!] 뱃지
- 개근왕: 이번 달 출석 횟수 상위 5명 pill 형태 표시, 만근 시 뱃지 노출
- 달력: 이전/다음 월 이동, 날짜 셀에 출석자 아바타 표시 (최대 5명 + 나머지 +N)
- 오늘 출석 목록: 오늘 출석한 회원 이름 + 메시지 + 도장 아이콘
- 포인트 안내 모달: 일일 +10P / 만근 +100P 안내, 유의사항 포함
4-2. 출석 찍기 페이지 (write.php)
- 오늘 날짜 표시
- 한 줄 메시지 입력 (선택, 최대 100자)
- 제출 시 글 제목: YYYY년 MM월 DD일 닉네임 출석
- 이미 출석한 경우 목록으로 자동 리다이렉트
4-3. 개인 달력 페이지 (view.php)
- 프로필 카드: 아바타, 닉네임, 총 출석 / 현재 연속 / 최장 연속 / 이번 달 통계
- 만근 달성 시 배너 표시 (해당 월)
- 개인 달력: 출석한 날 🏷️ 도장 아이콘, 날짜 클릭 → 해당일 메시지 패널 슬라이드
- 오늘 메시지: 오늘 출석 시 메시지 1건 표시
5. 권한 및 설정
게시판 레벨 설정
관리자 → 게시판 관리에서 아래 항목을 설정합니다.
| 설정 항목 | 권장 값 | 설명 |
| 스킨 | attendance | attendance 스킨 선택 |
| 글쓰기 권한 | 회원만 (레벨 1) | 비로그인 출석 방지 |
| 읽기 권한 | 모두 (레벨 0) | 달력은 누구나 볼 수 있음 |
| 댓글 사용 | 비활성 | 출석 게시판 특성상 불필요 |
| 추천 사용 | 선택 | 선택 사항 |
6. 자주 묻는 질문 (FAQ)
Q. 출석을 했는데 포인트가 지급되지 않아요.
A. 다음 항목을 확인해 주세요.
- extend/middle/10_attendance_point.php 파일이 서버에 정확히 업로드 되었는지 확인
- class_exists('DxPoint') — DxPoint 클래스가 존재하는지 확인 (DXCMS v8.1.0 이상 필요)
- 게시판 스킨이 attendance 로 설정되어 있는지 확인
- PHP 에러 로그 확인 (Windows IIS: D:\www_dxcms\php_error.log)
Q. dx_attendance 테이블이 생성되지 않아요.
A. 다음 항목을 확인해 주세요.
- DB 계정에 CREATE TABLE 권한이 있는지 확인
- list.php 상단의 _att_ensure_table() 함수가 정상 실행되는지 PHP 로그 확인
- 직접 생성이 필요한 경우: 설명서 2장의 테이블 구조를 참고하여 수동 생성
Q. 만근 보너스가 중복 지급되었어요.
A. point_log 테이블에서 아래 조건으로 중복 레코드를 확인하고 삭제해 주세요.
SELECT * FROM dx_point_log WHERE type='attend_perfect' AND member_id=?;
Q. 출석 메시지가 저장되지 않아요.
A. write.php 폼의 content textarea 가 정상적으로 값을 전달하는지 확인해 주세요.
- 브라우저 개발자 도구 → Network → write/ 요청 → Payload에 content 값이 있는지 확인
- DXCMS content 필드는 빈 값 제출 시 에러 — 공백 1자 이상이 전달되어야 함
Q. 달력 이전/다음 달 이동이 안돼요.
A. URL 파라미터 year, month 로 이동합니다. 예: /attendance/list?year=2026&month=5
