플러그인 목록
플러그인 목록은 관리자가 원격 서버에 등록된 플러그인과 현재 로컬에 설치된 플러그인을 확인하고, 설치, 업데이트, 삭제, 버전 비교를 할 수 있는 화면입니다.
iBoard에 새로운 기능을 추가하거나, 서버 플러그인을 설치하거나, 로컬 플러그인을 다시 등록하거나, 현재 설치된 플러그인 버전과 최신 버전을 비교할 때 사용합니다.
화면 개요
플러그인 목록 화면은 크게 Server Plugins와 Local Plugins 두 영역으로 나뉩니다. Server Plugins는 원격 플러그인 서버에 등록된 플러그인이고, Local Plugins는 현재 iBoard 설치 환경의 로컬 플러그인 폴더에 존재하는 플러그인입니다.
| 영역 | 설명 |
|---|---|
| Server Plugins | 원격 플러그인 서버에 등록된 플러그인을 표시합니다. 상태에 따라 설치 또는 삭제 작업을 할 수 있습니다. |
| Local Plugins | 현재 로컬 플러그인 폴더에 설치되어 있는 플러그인을 표시합니다. |
| Current Version | 현재 시스템에 설치된 iBoard 및 플러그인 버전을 보여줍니다. |
| Latest Version | 원격 플러그인 서버에 등록된 최신 버전 정보를 보여줍니다. |
| Install | 선택한 플러그인을 현재 iBoard 시스템에 설치하거나 적용합니다. |
| Delete | 시스템 설정에 따라 선택한 플러그인 항목 또는 플러그인을 삭제합니다. |
Server Plugins
Server Plugins 영역에는 원격 플러그인 서버에 등록된 플러그인들이 표시됩니다. 각 플러그인은 이미지, 플러그인 이름, 버전 정보, 작업 버튼을 가진 카드 형태로 표시됩니다.
서버 플러그인 카드
| 카드 항목 | 설명 |
|---|---|
| 미리보기 이미지 | 플러그인의 썸네일 또는 대표 이미지를 표시합니다. |
| Plugin Name | 원격 서버에 등록된 플러그인 이름입니다. |
| Current Version | 현재 시스템에 설치된 iBoard 및 플러그인 버전을 보여줍니다. |
| Latest Version | 원격 서버에서 제공하는 최신 iBoard 및 플러그인 버전을 보여줍니다. |
| Install | 플러그인을 현재 iBoard 시스템으로 다운로드하거나 설치합니다. |
| Delete | 시스템 설정과 권한에 따라 플러그인 항목 또는 플러그인을 삭제합니다. |
Local Plugins
Local Plugins 영역에는 현재 로컬 플러그인 폴더에 설치된 플러그인이 표시됩니다. 이미 iBoard 시스템에서 사용할 수 있는 상태일 수도 있고, 다시 설치 또는 등록이 필요할 수도 있습니다.
로컬 플러그인 카드
| 카드 항목 | 설명 |
|---|---|
| Plugin Name | 로컬에 설치된 플러그인 이름입니다. |
| Local Version | 로컬 iBoard 버전, 플러그인 버전, 플러그인 날짜를 표시합니다. |
| Install | 로컬 플러그인을 iBoard 시스템에 설치하거나 등록합니다. |
버전 정보
플러그인 카드에는 보통 iBoard 버전과 Plugin 버전이 함께 표시됩니다. 이 정보는 현재 iBoard 시스템과 플러그인 패키지의 호환성을 확인하는 데 사용됩니다.
| 버전 항목 | 설명 |
|---|---|
| iBoard | 플러그인이 지원하거나 요구하는 iBoard 플랫폼 버전입니다. |
| Plugin | 플러그인 패키지 버전입니다. |
| Date | 플러그인 배포일 또는 로컬 플러그인 빌드 날짜입니다. |
| Current Version | 현재 로컬 시스템에 설치된 버전입니다. |
| Latest Version | 원격 플러그인 서버에서 제공하는 최신 버전입니다. |
서버 플러그인 설치 방법
Server Plugins 영역의 Install 버튼을 사용하면 원격 플러그인 서버의 플러그인을 설치할 수 있습니다.
- Admin > Site > Plugin 메뉴로 이동합니다.
- Server Plugins 영역에서 사용 가능한 플러그인을 확인합니다.
- Current Version과 Latest Version을 비교합니다.
- Install 버튼을 클릭합니다.
- 플러그인 패키지 다운로드와 설치가 완료될 때까지 기다립니다.
- 필요하면 페이지를 새로고침합니다.
- 플러그인이 Local Plugins 영역에 표시되는지 확인합니다.
플러그인 설치는 패키지 구성에 따라 파일, 컨트롤러, 뷰, 스크립트, 스타일, 설정 데이터를 추가할 수 있습니다.
로컬 플러그인 설치 방법
Local Plugins 영역의 Install 버튼은 플러그인이 이미 로컬 플러그인 폴더에 있지만, iBoard 시스템에 설치, 등록, 적용이 필요한 경우 사용합니다.
- Local Plugins 영역에서 플러그인을 찾습니다.
- 로컬 iBoard 버전과 플러그인 버전을 확인합니다.
- Install 버튼을 클릭합니다.
- 설치 과정이 완료될 때까지 기다립니다.
- 플러그인 메뉴 또는 기능이 사용 가능한지 확인합니다.
플러그인 삭제 방법
Delete 버튼은 시스템 설정에 따라 선택한 플러그인 또는 플러그인 항목을 삭제합니다. 플러그인을 삭제하기 전에는 해당 플러그인에 의존하는 페이지, 메뉴, 숏코드, API, 기능이 없는지 확인해야 합니다.
- 삭제할 플러그인을 찾습니다.
- 현재 사용 중인 플러그인이 아닌지 확인합니다.
- 필요하면 플러그인 파일을 백업합니다.
- Delete 버튼을 클릭합니다.
- 확인 메시지가 나오면 삭제를 확정합니다.
- 새로고침 후 플러그인이 제거되었는지 확인합니다.
사용 중인 플러그인을 삭제하면 해당 플러그인에 의존하는 메뉴, 페이지, 라우트, 기능이 동작하지 않을 수 있습니다.
자주 사용하는 작업
| 작업 | 권장 방법 |
|---|---|
| iBoard에 새 기능 추가 | Server Plugins에서 필요한 플러그인을 설치합니다. |
| 서버에 복사된 플러그인 등록 | Local Plugins 영역에서 Install을 사용합니다. |
| 플러그인 호환성 확인 | 설치 전에 iBoard와 Plugin 버전을 비교합니다. |
| 사용하지 않는 플러그인 제거 | 백업 후 사용 중이 아닌지 확인하고 삭제합니다. |
| 배포 후 플러그인 재설치 | Local Plugins의 Install 버튼으로 로컬 플러그인 파일을 다시 등록합니다. |
주의사항
- 플러그인 설치와 삭제는 신뢰할 수 있는 관리자만 수행해야 합니다.
- 플러그인은 라우팅, 메뉴, 데이터베이스 기능, 뷰, 프론트엔드 동작에 영향을 줄 수 있습니다.
- 설치 전 반드시 버전 호환성을 확인하세요.
- 플러그인을 삭제하거나 재설치하기 전 로컬 플러그인 파일을 백업하세요.
- 플러그인 설치 후 관련 메뉴와 기능을 즉시 테스트하세요.
- 플러그인이 데이터베이스 변경을 포함하는 경우 DB 사용자 권한을 확인하세요.
권장 플러그인 관리 순서
- 플러그인 이름과 버전 정보를 확인합니다.
- 해당 플러그인이 이미 로컬에 설치되어 있는지 확인합니다.
- 기존 플러그인이 있다면 파일을 백업합니다.
- 플러그인을 설치하거나 업데이트합니다.
- 관리자 메뉴를 새로고침합니다.
- 플러그인 기능을 열어 기본 동작을 테스트합니다.
- 플러그인이 정상 로드되지 않으면 오류 로그를 확인합니다.
권장 백업 방법
설치 또는 삭제 전 권장 순서:
1. 로컬 플러그인 폴더를 백업합니다.
2. 플러그인이 사용하는 데이터베이스 테이블 또는 설정을 백업합니다.
3. 현재 iBoard 버전과 플러그인 버전을 기록합니다.
4. 플러그인을 설치, 업데이트 또는 삭제합니다.
5. 관련 페이지와 메뉴를 테스트합니다.문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|---|---|
| Server Plugins 목록이 비어 있음 | 원격 플러그인 서버에 접근할 수 없거나 서버 API가 데이터를 반환하지 않을 수 있습니다. | 인터넷 연결, 원격 플러그인 서버 설정, 서버 응답을 확인합니다. |
| Install 버튼이 실패함 | 서버가 플러그인 폴더에 쓸 권한이 없을 수 있습니다. | IIS와 폴더 쓰기 권한을 확인합니다. |
| 설치했지만 메뉴가 보이지 않음 | 플러그인이 정상 등록되지 않았거나 메뉴 캐시 새로고침이 필요할 수 있습니다. | 로컬 플러그인을 다시 설치하고 관리자 페이지를 새로고침하며 플러그인 설정을 확인합니다. |
| 플러그인 페이지에서 오류 발생 | 플러그인 파일이 누락되었거나 호환되지 않거나 필요한 DB 객체가 없을 수 있습니다. | 플러그인 파일, iBoard 버전 호환성, 필요한 DB 스크립트를 확인합니다. |
| Delete가 동작하지 않음 | 애플리케이션이 플러그인 파일을 삭제할 권한이 없을 수 있습니다. | 폴더 권한을 확인하고 다른 프로세스가 파일을 잠그고 있지 않은지 확인합니다. |
관리 권장 사항
- 신뢰할 수 있는 출처의 플러그인만 설치하세요.
- 플러그인 버전을 문서화해 두세요.
- 운영 환경에 적용하기 전 개발 환경에서 먼저 테스트하세요.
- 활성 페이지나 메뉴와 연결된 플러그인은 삭제하지 마세요.
- 설치 전 플러그인 권한과 데이터베이스 요구사항을 확인하세요.
- 업데이트 또는 삭제 전 플러그인 파일을 백업하세요.
플러그인은 iBoard 기능을 확장합니다. 페이지, 메뉴, 라우팅, 데이터베이스 동작에 영향을 줄 수 있으므로 설치와 삭제는 신중하게 진행해야 합니다.