플러그인 옵션
Mindlogic Plugin은 다양한 설정 옵션을 통해 맞춤화가 가능합니다. 이 문서에서는
MLCPluginOptions 인터페이스에서 사용할 수 있는 모든 옵션을 자세히
설명합니다.시작하기
플러그인 설정은
MLCPlugin.init() 함수에 옵션 객체를 전달하여 이루어집니다:모든 옵션은 선택사항입니다. 기본값을 사용하려면 해당 옵션을 생략하면 됩니다.
옵션 카테고리
옵션은 역할에 따라 다음 카테고리로 나뉩니다. 각 옵션에 대한 자세한 설명은 해당 카테고리 문서에서 확인할 수 있습니다.
- 레이아웃 및 위치 —
divId,position,chatWindow,movePlugin - 스타일링 —
customImage,stylesheetUrl,styles - 동작 제어 —
initialOpen,hideButton,showInitialGuideModal,hideCloseButton - 이벤트 콜백 —
onMessageSend,onRefresh,onHide,onOpen
옵션 요약
아래 표는 사용 가능한 모든 옵션의 요약입니다.
| 속성명 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| divId | string | "mlc-root" | Plugin이 마운트될 HTML 엘리먼트 ID |
| position | object | { right: 10, bottom: 10 } | 뷰포트 내 Plugin의 초기 위치 |
| initialOpen | boolean | false | 초기화 시 Plugin의 열림 상태 |
| chatWindow | object | - | 채팅 창의 초기 크기 및 위치 |
| movePlugin | boolean | false | Plugin 이동 및 크기 조절 가능 여부 |
| customImage | object | - | Plugin 트리거 버튼의 커스텀 이미지 |
| hideButton | boolean | false | 트리거 버튼 숨김 여부 |
| showInitialGuideModal | boolean | true | 첫 접속 시 가이드 모달 표시 여부 |
| hideCloseButton | boolean | false | 닫기 버튼 숨김 여부 |
| stylesheetUrl | string | - | 외부 스타일시트 URL |
| styles | string | - | 인라인 커스텀 CSS |
| onMessageSend | function | - | 메시지 전송 시 콜백 |
| onRefresh | function | - | 세션 새로고침 시 콜백 |
| onHide | function | - | 채팅창 닫기 시 콜백 |
| onOpen | function | - | 채팅창 열기 시 콜백 |
플러그인 설정 예제
아래는 여러 옵션을 설정하는 예제입니다:
javascript
플러그인 설정, 이렇게 확인해보세요!
✅ 모든 스크립트가 올바른 순서로 로드되었나요?
✅ 플러그인 컨테이너 요소가 페이지에 제대로 삽입되었나요?
✅ 커스텀 스타일이 의도한 대로 적용되었나요?
✅ 데스크톱과 모바일 환경 모두에서 테스트해보셨나요?
문제가 발생하면 브라우저 개발자 도구의 콘솔을 확인하여 디버깅 정보를 확인해보세요.
마지막 수정 날짜: Mar 09, 2026