자료 정보
버전 내역
상세 설명
한줄광고 모듈 (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)
- 한줄광고 위젯 (실제 광고 출력을 위해 별도 설치 필요)
설치 방법
- 이 저장소를 클론하거나 압축 파일을 다운로드합니다.
- 폴더명이
plusad인지 확인한 뒤, 라이믹스가 설치된 경로의modules/디렉터리 아래에 복사합니다.(라이믹스 루트)/modules/plusad/ - 관리자 대시보드에서 DB 생성 및 업데이트를 진행합니다.
- 한줄광고 위젯을 별도로 설치한 뒤, 위젯을 원하는 위치에 추가합니다.
관리자 설정
관리자 페이지 → 설치된 모듈 → 한줄광고 모듈 메뉴에서 아래 항목을 설정할 수 있습니다.
| 설정 항목 | 설명 | 기본값 |
|---|---|---|
| 광고 진행시간 | 허용할 광고 진행 시간 목록 (시간 단위, 쉼표로 구분) | 1,3,6,12,24 |
| 시간당 소모포인트 | 광고 등록 시 시간당 차감할 포인트 | 10 |
| 굵기효과 소모포인트 | Bold 효과 적용 시 추가로 차감할 포인트 | 100 |
| 색상효과 소모포인트 | 색상 효과 적용 시 추가로 차감할 포인트 | 300 |
광고 등록 방법 (사용자)
- 광고 등록 권한이 있는 회원으로 로그인합니다.
- 한줄광고 모듈 페이지에서 광고 등록 버튼을 클릭합니다.
- 광고 내용, 링크 주소(선택), 진행 시간, 굵기·색상 효과를 선택합니다.
- 소모될 포인트가 충분한 경우 광고가 등록됩니다.
사용자 피드백 13
좋은 모듈과 위젯 감사합니다.
제가 초보 라이믹스 유저라 그런데 좀 멍청한 질문일 수도 있겠지만
혹시 관리자는 포인트가 없으면 한줄광고 등록이 안되는 건가요?
네. 추후 포인트 미사용시 체크하지 않도록 개선해보겠습니다.
감사합니다.
모듈과 위젯 설치하고 내광고등록 > 광고등록 페이지에서 광고내용입력난이 보일질 않아서 이것 저것 확인 해보니 사용자 브라우저에 애드블럭같은 프로드램이 기본 설정되어 있을 경우 광고내용입력난이 보이질 않는것 같습니다.
이외의 항목도 확인 중에 있긴 한데 사용자 브라우저에 애드블럭이 설치되어 있을 경우 영향을 받는것 같아서 댓글 남깁니다.
클래스명에 ad가 들어가다보니 그렇습니다.
plusad.controller.php 에 최대광고 시간이 128시간으로 제한되어있어
광고 세부 설정 >> 광고 진행시간 설정
에서 시간을 설정해도 128시간 초과 되면 "광고 허용시간을 초과하였습니다." 라는 메세지가 뜹니다.
90번째 줄
if ($args->time > 128)
의 숫자를 변경해서 해결하면됩니다.
감사합니다! 해당부분 업데이트 예정입니다(개인적으로 수정해서 적용하던걸 올린거다보니 하드코딩된게 남아있었네요)
허용 도메인 리스트 부분을 비워두면 그 어떤 도메인도 광고 허용이 안되는건가요?
허용 도메인 리스트 부분을 비워두면 그 어떤 도메인도 광고 허용이 안되는건가요?
모든 도메인이 허용됩니다.
감사합니다! *.* 이걸 했더니 모든 도메인 허용이 되네요.
무료라서 염치없지만
모바일 레이아웃도 지원해주실 계획이 있으신지 궁금해요
등록 불가능한 주소입니다.
계속 뜨는데... 원래그런가요?
등록 가능 주소가 비어있으면 적용되지 않습니다. 만약 해당 입력란을 비웠는데도 불구하고 적용된다면 버그입니다.