한줄광고 모듈 (PlusAd)

포인트를 사용해 한줄 광고를 등록하고 이를 위젯으로 출력하는 라이믹스(Rhymix) 모듈입니다.

---

주요 기능

• 회원이 보유한 포인트를 소모하여 한줄 광고를 등록할 수 있습니다.
• 등록된 광고는 위젯을 통해 원하는 위치에 출력됩니다.
• 광고 진행 시간을 시간(hour) 단위로 설정할 수 있습니다.
• 광고 텍스트에 굵기(Bold) 효과 및 색상 효과를 적용할 수 있습니다 (추가 포인트 소모).
• 광고에 외부 링크(URL)를 첨부할 수 있습니다 (화이트리스트 방식으로 허용 도메인 제한 가능).
• 내 광고 목록 및 광고 수정·삭제 기능을 제공합니다.
• 관리자 페이지에서 광고 로그 확인 및 삭제, 권한 설정, 스킨 설정이 가능합니다.

---

변경 사항

[1.2.0] - 2026-04-10

추가

• 포인트 모듈 비활성화 여부 확인 기능 추가 (#5)
  • 포인트 모듈이 비활성화된 경우 포인트 잔액 무제한으로 처리
• 광고 등록 가능 시간 유효성 검사 동적 처리 추가 (#5)
• dispPlusadCancel 및 matchWhitelist 함수에 대한 PHPUnit 테스트 추가 (#4)
• GitHub Actions CI 파이프라인 추가 (PHP 7.4~8.5 매트릭스 테스트) (#4)

변경

• 경과 시간(elapsed percent) 계산 로직 및 조건 리팩터링
• 시간 표시 부분 최적화
• $allowed_times가 빈 값이 될 수 없도록 처리 수정
• 포인트 모듈 설정 확인 시 Point::getConfig() 사용으로 코드 개선

수정

• 취소 기능 관련 누락된 부분 추가 수정

---

[1.1.0] - 2026-03-20

추가

• 광고 취소 기능 추가 (#3)
  • 취소 허용 기준(경과 시간 비율) 및 수수료 설정 가능
  • 취소 시 잔여 포인트 환불 지원

변경

• procPlusadCancel → dispPlusadCancel로 함수명 변경

---

[1.0] - 2026-02-21

추가

• 관리자 설정에 허용 도메인 리스트 설정 항목 추가
• Rhymix 모듈에 맞게 저자 정보 추가

변경

• PHPDoc 추가 및 레거시 메서드를 getInstance()로 교체, 가독성 개선
• README 포인트 모듈 안내 수정 및 한줄광고 위젯 별도 설치 안내 추가 (#2)
• 설치 방법 및 관리자 설정 안내 문서 수정
• 라이선스 GPL로 변경 (Rhymix 모듈 규정 준수)
• 위젯 설치 안내 포맷 수정
• 광고 외부 링크 첨부 방식 설명 명확화
• conf/module.xml 코드 정리 (불필요한 주석 및 잔여 코드 제거)
• plusad.controller.php 리팩터링

---

요구 사항

• 라이믹스(Rhymix)
• 한줄광고 위젯 (실제 광고 출력을 위해 별도 설치 필요)

---

설치 방법

1. 이 저장소를 클론하거나 압축 파일을 다운로드합니다.
2. 폴더명이 plusad인지 확인한 뒤, 라이믹스가 설치된 경로의 modules/ 디렉터리 아래에 복사합니다.

   (라이믹스 루트)/modules/plusad/
   

3. 관리자 대시보드에서 DB 생성 및 업데이트를 진행합니다.
4. 한줄광고 위젯을 별도로 설치한 뒤, 위젯을 원하는 위치에 추가합니다.

---

관리자 설정

관리자 페이지 → 설치된 모듈 → 한줄광고 모듈 메뉴에서 아래 항목을 설정할 수 있습니다.

설정 항목	설명	기본값
광고 진행시간	허용할 광고 진행 시간 목록 (시간 단위, 쉼표로 구분)	1,3,6,12,24
시간당 소모포인트	광고 등록 시 시간당 차감할 포인트	10
굵기효과 소모포인트	Bold 효과 적용 시 추가로 차감할 포인트	100
색상효과 소모포인트	색상 효과 적용 시 추가로 차감할 포인트	300

---

광고 등록 방법 (사용자)

1. 광고 등록 권한이 있는 회원으로 로그인합니다.
2. 한줄광고 모듈 페이지에서 광고 등록 버튼을 클릭합니다.
3. 광고 내용, 링크 주소(선택), 진행 시간, 굵기·색상 효과를 선택합니다.
4. 소모될 포인트가 충분한 경우 광고가 등록됩니다.