그누보드5에서 여러 사전을 통합하여 검색할 수 있는 강력한 플러그인입니다.
국어사전, 일반상식백과사전, 경제신조어사전, 비주얼딕셔너리를 하나의 인터페이스로
통합하여 제공합니다. 반응형 디자인으로 PC, 태블릿, 모바일 모든 환경에서
완벽하게 작동하며, 게시판 스킨이나 메인화면에 간편하게 위젯 형태로 추가할 수
있습니다.

[주요 기능]

1. 통합 사전 검색
   - 국어사전: 국립국어원 표준국어대사전 API 연동
   - 일반상식백과사전: 네이버 지식백과 API 연동
   - 경제신조어사전: 네이버 검색 API 연동
   - 비주얼딕셔너리: 네이버 이미지 검색 API 연동

2. 사용자 친화적 인터페이스
   - 깔끔하고 현대적인 디자인
   - 반응형 레이아웃 (PC, 태블릿, 모바일 완벽 지원)
   - 직관적인 검색 폼과 결과 표시
   - 게시판 스킨에 자연스럽게 통합 가능

3. 관리자 기능
   - 간편한 API 키 설정
   - 플러그인 활성화/비활성화
   - 관리자 페이지에서 통합 관리

4. 성능 최적화
   - API 응답 캐싱 기능
   - 검색 결과 제한 설정 가능
   - 효율적인 API 호출 관리

[필수 요구사항]

- 그누보드5 최신 버전
- PHP 5.6 이상
- cURL 확장 모듈
- JSON 확장 모듈
- 네이버 API 키 (일반상식백과사전, 경제신조어사전, 비주얼딕셔너리 사용 시)
- 국립국어원 표준국어대사전 API 키 (국어사전 사용 시)

[API 키 발급 방법]

1. 국립국어원 표준국어대사전 API
   - 사이트: https://stdict.korean.go.kr/openApi/openApiInfo.do
   - API 사용 신청 후 발급받은 키를 관리자 페이지에 입력

2. 네이버 API (Client ID, Client Secret)
   - 사이트: https://developers.naver.com/apps/#/register
   - 애플리케이션 등록 후 Client ID와 Client Secret 발급
   - 무료 사용량: 일일 25,000건
   - 유료 사용량: 월 100만건 이상 가능

[설치 방법]

1단계: 파일 업로드
   - adm 과 plugin/dictionary 폴더 전체를 그누보드 루트의 plugin 폴더에 업로드합니다.
   - FTP 또는 파일 관리자를 사용하여 업로드하세요.
   - 폴더 구조가 올바르게 유지되는지 확인하세요.

2단계: 파일 권한 설정
   - plugin/dictionary 폴더: 755 권한
   - plugin/dictionary/config.php 파일: 644 또는 666 권한 (쓰기 가능해야 함)
   - data/cache 폴더: 755 권한 (쓰기 가능해야 함)

3단계: 설치 스크립트 실행
   - 브라우저에서 다음 URL에 접속합니다:
     http://your-site.com/plugin/dictionary/install.php
   - 관리자로 로그인되어 있어야 합니다.
   - 설치 스크립트가 자동으로 필요한 디렉토리와 파일 권한을 확인하고 조정합니다.
   - (선택사항) 데이터베이스 테이블을 생성하려면 "데이터베이스 테이블 생성하기" 링크를 클릭합니다.

4단계: 플러그인 활성화 및 API 키 설정
   - 관리자 페이지에 로그인합니다.
   - 관리자 메뉴에서 "게시판관리" > "사전 설정"으로 이동합니다.
   - 또는 직접 다음 URL로 이동:
     http://your-site.com/adm/dictionary_config.php
   - "플러그인 활성화" 체크박스를 선택합니다.
   - 각 사전의 API 키를 입력합니다:
     * 국어사전 API 키: 국립국어원 표준국어대사전에서 발급받은 키
     * 네이버 Client ID: 네이버 개발자 센터에서 발급받은 Client ID
     * 네이버 Client Secret: 네이버 개발자 센터에서 발급받은 Client Secret
   - "설정 저장" 버튼을 클릭합니다.

5단계: 게시판에 위젯 추가
   - 게시판 스킨 파일 (예: list.skin.php, view.skin.php)에 다음 코드를 추가합니다:

   <?php
   // 플러그인 로드
   if (file_exists(G5_PLUGIN_PATH.'/dictionary/plugin.php')) {
       include_once(G5_PLUGIN_PATH.'/dictionary/plugin.php');
       
       // 스타일시트 로드
       add_stylesheet('<link rel="stylesheet" href="'.DICTIONARY_PLUGIN_URL.'/css/dictionary.css">', 0);
       
       // 검색 위젯 출력
       include_once(G5_PLUGIN_PATH.'/dictionary/tpl/search_widget.php');
   }
   ?>

   - 또는 메인화면이나 사이드바에 추가할 수도 있습니다.

   - http://도메인주소/plugin/dictionary/search.php 로도 바로 사용하셔도 됩니다.

[사용 방법]

1. 검색 위젯 사용
   - 게시판이나 메인화면에 추가된 검색 위젯에서 검색어를 입력합니다.
   - 검색할 사전 종류를 선택합니다 (국어사전, 일반상식백과사전, 경제신조어사전, 비주얼딕셔너리).
   - 검색 버튼을 클릭하면 전용 검색 결과 페이지로 이동합니다.

2. 검색 결과 확인
   - 검색 결과는 전용 페이지에서 깔끔하게 표시됩니다.
   - 국어사전: 단어, 발음, 품사, 뜻풀이, 예문 등이 표시됩니다.
   - 일반상식백과사전: 백과사전 정보가 표시됩니다.
   - 경제신조어사전: 경제 관련 용어와 설명이 표시됩니다.
   - 비주얼딕셔너리: 관련 이미지와 설명이 함께 표시됩니다.

[파일 구조]

plugin/dictionary/
├── plugin.php              # 플러그인 메인 파일
├── config.php              # 설정 파일 (API 키 저장)
├── ajax.php                # AJAX 처리 파일
├── search.php              # 검색 결과 페이지
├── install.php             # 설치 스크립트
├── includes/               # API 클래스들
│   ├── DictionaryAPI.class.php      # 기본 API 클래스
│   ├── KoreanDictionary.class.php    # 국어사전 API
│   ├── Encyclopedia.class.php        # 일반상식백과사전 API
│   ├── EconomicTerms.class.php       # 경제신조어사전 API
│   └── VisualDictionary.class.php   # 비주얼딕셔너리 API
├── tpl/                    # 템플릿 파일
│   └── search_widget.php   # 검색 위젯 템플릿
└── css/                    # 스타일시트
    └── dictionary.css      # 플러그인 스타일

[문제 해결]

1. 설치 스크립트가 실행되지 않는 경우
   - 파일 경로가 올바른지 확인하세요.
   - PHP 오류 로그를 확인하세요.
   - 파일 권한을 확인하세요 (폴더: 755, 파일: 644).

2. 플러그인이 작동하지 않는 경우
   - config.php 파일에서 DICTIONARY_PLUGIN_ACTIVE가 true로 설정되어 있는지 확인하세요.
   - 브라우저 개발자 도구의 콘솔에서 JavaScript 오류를 확인하세요.
   - 서버 오류 로그를 확인하세요.

3. API 호출이 실패하는 경우
   - API 키가 올바르게 설정되었는지 확인하세요.
   - 서버에서 외부 API 호출이 가능한지 확인하세요 (방화벽 설정 등).
   - PHP의 cURL 확장 모듈이 설치되어 있는지 확인하세요.
   - 네이버 API의 경우 일일 사용량 제한을 확인하세요.

4. 설정 저장이 안 되는 경우
   - config.php 파일의 권한을 644 또는 666으로 설정하세요.
   - install.php를 다시 실행하여 자동으로 권한을 조정할 수 있습니다.

5. 검색 결과가 표시되지 않는 경우
   - API 키가 올바르게 설정되었는지 확인하세요.
   - 네트워크 연결 상태를 확인하세요.
   - 브라우저 개발자 도구의 네트워크 탭에서 API 호출 상태를 확인하세요.

[주의사항]

- 네이버 API는 일일 사용량 제한이 있습니다 (무료: 25,000건/일).
- API 키는 안전하게 관리하세요. config.php 파일의 접근 권한을 제한하세요.
- 캐시 기능을 활용하여 API 호출을 최소화하세요.
- PHP 5.6 이상이 필요합니다.
- 그누보드5 최신 버전과의 호환성을 권장합니다.

[업데이트 내역]

버전 1.0.0
- 초기 릴리스
- 국어사전, 일반상식백과사전, 경제신조어사전, 비주얼딕셔너리 지원
- 네이버 API 통합
- 반응형 디자인 적용
- 관리자 설정 페이지 제공
- 자동 설치 스크립트 포함

[지원 및 문의]

플러그인 사용 중 문제가 발생하거나 질문이 있으시면 판매자에게 문의해주세요.
설치 및 설정 관련 도움이 필요하시면 언제든지 연락주시기 바랍니다.