PHPackages cms-orbit/comments - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. cms-orbit/comments ActiveLibrary[Utility & Helpers](/categories/utility) cms-orbit/comments ================== A comprehensive comment system for CMS-Orbit with reactions, ratings, and notifications 1.0.2(9mo ago)023MITPHPPHP ^8.3 Since Jul 14Pushed 8mo agoCompare [ Source](https://github.com/cms-orbit/comments)[ Packagist](https://packagist.org/packages/cms-orbit/comments)[ RSS](/packages/cms-orbit-comments/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (3)Versions (4)Used By (0) CMS-Orbit Comments Package ========================== [](#cms-orbit-comments-package) [![CMS-Orbit Comments](https://camo.githubusercontent.com/c46f282c90c2cd761eefd90804c7a6ac42f44dbc913d067205c5be89337f670f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f434d532d2d4f726269742d436f6d6d656e74732d626c75653f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/c46f282c90c2cd761eefd90804c7a6ac42f44dbc913d067205c5be89337f670f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f434d532d2d4f726269742d436f6d6d656e74732d626c75653f7374796c653d666f722d7468652d6261646765)[![Laravel](https://camo.githubusercontent.com/65b68ae59db7922043fd0797bdb3e83abacee5341d7ec52aecdaf6f6a8efc73f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e782d7265643f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/65b68ae59db7922043fd0797bdb3e83abacee5341d7ec52aecdaf6f6a8efc73f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e782d7265643f7374796c653d666f722d7468652d6261646765)[![Vue.js](https://camo.githubusercontent.com/ee9aef6601e45f8d20343239f500f71a9076f06159432d8ccae2e5622feeacb8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5675652e6a732d332e782d677265656e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/ee9aef6601e45f8d20343239f500f71a9076f06159432d8ccae2e5622feeacb8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5675652e6a732d332e782d677265656e3f7374796c653d666f722d7468652d6261646765)[![License](https://camo.githubusercontent.com/2792a6b590e1b7fbcc5f7c80df8da3149453c596df80f16fa86bd82c487bec8d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f773f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/2792a6b590e1b7fbcc5f7c80df8da3149453c596df80f16fa86bd82c487bec8d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f773f7374796c653d666f722d7468652d6261646765) **강력하고 유연한 댓글 시스템으로 웹사이트에 생동감을 더하세요!** --- 📋 목차 ---- [](#-목차) - [소개](#-%EC%86%8C%EA%B0%9C) - [주요 기능](#-%EC%A3%BC%EC%9A%94-%EA%B8%B0%EB%8A%A5) - [스크린샷](#-%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7) - [설치 및 설정](#-%EC%84%A4%EC%B9%98-%EB%B0%8F-%EC%84%A4%EC%A0%95) - [빠른 시작](#-%EB%B9%A0%EB%A5%B8-%EC%8B%9C%EC%9E%91) - [상세 가이드](#-%EC%83%81%EC%84%B8-%EA%B0%80%EC%9D%B4%EB%93%9C) - [API 문서](#-api-%EB%AC%B8%EC%84%9C) - [컴포넌트 레퍼런스](#-%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8-%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4) - [고급 기능](#-%EA%B3%A0%EA%B8%89-%EA%B8%B0%EB%8A%A5) - [문제 해결](#-%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0) - [기여하기](#-%EA%B8%B0%EC%97%AC%ED%95%98%EA%B8%B0) --- 🚀 소개 ---- [](#-소개) CMS-Orbit Comments Package는 Laravel 기반 웹사이트에 강력하고 유연한 댓글 시스템을 제공하는 패키지입니다. 다양한 모델에 댓글 기능을 쉽게 추가할 수 있으며, 평점 시스템, 반응 기능, 답글 시스템 등 풍부한 기능을 제공합니다. ### ✨ 특징 [](#-특징) - **🔧 모델별 독립 설정**: 각 모델마다 다른 댓글 정책 설정 가능 - **⭐ 평점 시스템**: 다중 카테고리 평점 지원 - **😊 반응 시스템**: 이모지 기반 반응 기능 - **💬 계층적 답글**: 무제한 깊이의 답글 시스템 - **👥 게스트 지원**: 로그인 없이도 댓글 작성 가능 - **🔒 보안 기능**: 스팸 방지, 비밀글, 검토 시스템 - **📱 반응형 디자인**: 모든 디바이스에서 완벽 지원 - **🌐 다국어 지원**: 완전한 국제화 지원 --- 🎯 주요 기능 ------- [](#-주요-기능) ### 📝 기본 댓글 기능 [](#-기본-댓글-기능) - ✅ **댓글 작성/수정/삭제**: 완전한 CRUD 기능 - ✅ **답글 시스템**: 계층적 댓글 구조 지원 - ✅ **페이지네이션**: 효율적인 댓글 로딩 - ✅ **실시간 업데이트**: 새 댓글 실시간 반영 ### ⭐ 평점 시스템 [](#-평점-시스템) - ✅ **다중 카테고리**: 전체, 서비스, 시설, 가치 등 - ✅ **반별 평점**: 0.5단위 세밀한 평점 - ✅ **평점 통계**: 평균, 분포, 요약 정보 - ✅ **커스텀 평점**: 모델별 맞춤 평점 카테고리 ### 😊 반응 시스템 [](#-반응-시스템) - ✅ **이모지 반응**: 👍❤️😂😮😢😠 등 다양한 반응 - ✅ **반응 통계**: 각 반응별 개수 표시 - ✅ **사용자별 반응**: 개인화된 반응 관리 ### 👥 사용자 관리 [](#-사용자-관리) - ✅ **게스트 댓글**: 로그인 없이 댓글 작성 - ✅ **사용자 인증**: 로그인 사용자 댓글 - ✅ **아바타 지원**: 사용자 프로필 이미지 - ✅ **권한 관리**: 역할 기반 접근 제어 ### 🔒 보안 및 관리 [](#-보안-및-관리) - ✅ **스팸 방지**: 허니팟, 요청 제한 - ✅ **검토 시스템**: 관리자 승인/거부 - ✅ **비밀글**: 특정 권한만 볼 수 있는 댓글 - ✅ **신고 기능**: 부적절한 댓글 신고 ### 📱 사용자 경험 [](#-사용자-경험) - ✅ **반응형 디자인**: 모든 디바이스 지원 - ✅ **접근성**: WCAG 가이드라인 준수 - ✅ **키보드 네비게이션**: 완전한 키보드 지원 - ✅ **로딩 상태**: 사용자 친화적 로딩 표시 --- 📸 스크린샷 ------ [](#-스크린샷) ### 댓글 작성 화면 [](#댓글-작성-화면) [![댓글 작성](write_comment.png)](write_comment.png) *사용자가 댓글을 작성하는 화면입니다. 평점 시스템과 반응 기능이 활성화되어 있습니다.* ### 스팸 방지 및 비밀글 기능 [](#스팸-방지-및-비밀글-기능) [![스팸 방지 및 비밀글](spam_secret_comment.png)](spam_secret_comment.png) *스팸 방지 기능과 비밀글 설정이 적용된 관리자 화면입니다.* --- 🛠 설치 및 설정 --------- [](#-설치-및-설정) ### 1. 패키지 설치 [](#1-패키지-설치) ``` composer require cms-orbit/comments ``` ### 2. 마이그레이션 실행 [](#2-마이그레이션-실행) ``` php artisan migrate ``` ### 3. 설정 파일 발행 [](#3-설정-파일-발행) ``` php artisan vendor:publish --tag=orbit-comments-config ``` ### 4. 환경 변수 설정 [](#4-환경-변수-설정) `.env` 파일에 다음 설정을 추가하세요: ``` # 댓글 시스템 기본 설정 COMMENTS_MODERATION_ENABLED=false COMMENTS_RATINGS_ENABLED=true COMMENTS_REACTIONS_ENABLED=true COMMENTS_GUEST_ENABLED=true # 보안 설정 COMMENTS_SPAM_PROTECTION_ENABLED=true COMMENTS_RATE_LIMIT_ENABLED=true COMMENTS_RATE_LIMIT_MAX_ATTEMPTS=5 COMMENTS_RATE_LIMIT_DECAY_MINUTES=1 # 표시 설정 COMMENTS_PER_PAGE=10 COMMENTS_MAX_DEPTH=5 COMMENTS_SHOW_AVATARS=true COMMENTS_SHOW_TIMESTAMPS=true ``` --- ⚡ 빠른 시작 ------- [](#-빠른-시작) ### 1. 모델에 HasComments Trait 추가 [](#1-모델에-hascomments-trait-추가) ```