English

Summary

• This program (map component) is developed by XE Public Project.
• map component is an editor component of XpressEngine or Rhymix.
• This software supports various maps APIs (OpenStreetMap, Google, Kakao, Naver Business Platform (NBP) maps API).
  • The default map is OpenStreetMap without API key.
  • To display OpenStreetMap, this software contains Leaflet as a library.
  • Google, Kakao, NBP maps API requires API key(s) to display them.
• Easy to use
  • one click marker creation and deletion
  • drag the marker to move
  • double-click the map on the WYSIWYG editor to modify it.

License

• GPLv3

Installation directory

• ./modules/editor/components/map_components

How to install map component

1. Copy map component files to the right (see above) directory
2. Click editor menu ( /index.php?module=admin&act=dispEditorAdminIndex ) on the admin page of XpressEngine or RhymiX
3. See the map item on the bottom of the page as an editor component, and check to activate it.

한국어

특징

• XE Public 프로젝트를 통해 개발되고 있는 컴포넌트 입니다.
• 다양한 지도 API를 지원합니다. (네이버 비즈니스 플랫폼 (NBP) 지도, 카카오 지도, 구글 지도, 오프스트리트맵 API 지원)
  • 아무 설정도 하지 않았을 때 기본 지도는 오픈스트리트맵 입니다.
  • 이 소프트웨어는 오픈스트리트 지도를 나타내기 위해서 Leaflet 라이브러리를 포함합니다.
  • 구글, 카카오, NBP 지도를 이용하려면 API 키가 필요합니다.
• 쉬운 사용법
  • 클릭 한번으로 마커 생성과 삭제 가능
  • 생성된 마커를 드래그해서 위치 이동 가능
  • 위지윅 에디터 상에 나타난 지도를 더블클릭해서 지도 수정 가능

사용권

• GPLv3

설치 위치

• ./modules/editor/components/map_components

설치 방법

1. 지도 에디터 컴포넌트 파일을 복사 합니다.(쉬운설치의 경우 쉬운 설치를 완료합니다.)
2. 관리자 페이지 왼쪽 메뉴 하단에 아래쪽 화살표를 클릭하고, 고급 > 에디터( /index.php?module=admin&act=dispEditorAdminIndex )에 접속합니다.
3. 맨 하단 '에디터 컴포넌트' 중 '지도' 가 생성된 것을 확인하고 오른쪽 '사용' 체크박스에 체크합니다.
4. 네이버나 카카오 지도를 사용하시려면, '지도' 항목의 제목인 [지도] 글자를 클릭합니다.
5. 지도 API Key 항목에 사용하고 싶은 지도의 API 키 ― 네이버 또는 카카오 지도 API 키 ― 를 입력합니다.

• 네이버의 경우 Secret Key와 Client-Id, 카카오의 경우 REST API 키와 Javascript 키를 모두 입력하셔야 정상적으로 이용하실 수 있습니다.

사용 방법

1. 에디터의 확장 컴포넌트에 나타난 지도 컴포넌트를 클릭하면 새 창에 지도 컴포넌트가 나타납니다.
2. 상단에 [지도]라는 제목을 한번 클릭해봅니다.
3. 나타난 안내 화면을 읽습니다.
4. 안내 화면의 문구대로 따라합니다. 오른쪽 지도를 클릭 해보고, 나타난 마커를 한번 클릭해봅니다.
5. 왼쪽 검색 창도 이용해봅니다.
6. 지도 편집을 완료했다면, 좌측 하단 [지도 넣기] 버튼을 이용해서 지도를 본문에 입력합니다.
7. 지도를 수정해야 한다면, 위지윅 에디터 상에 삽입된 지도를 더블클릭합니다.
8. 지도 크기를 수정해야 한다면, 위지윅 에디터 상에 삽입된 지도를 한번 클릭하고 모서리에 나타난 점을 이용해서 크기를 변경합니다.(IE 만 지원)

바뀐 점

• 네이버 지도 API가 네이버 비즈니스 플랫폼 (NBP) 지도 API로 이관된 것을 반영하였습니다. ( @misol ) 네이버 비즈니스 플랫폼 지도 API와 관련하여서는 https://www.ncloud.com/product/applicationService/maps 를 참고하십시오.
• 주요 공헌자인 @misol 이 바쁜 생활을 하고 있어서, 업데이트가 빠르지 않았습니다. 이 컴포넌트는 3가지 API를 동시에 지원하고 있어서 각 API 중 하나에 문제가 생기면, 다른 API로 잠시 사용해주시길 바라고, 많은 공헌 부탁 드립니다.

쉬어가는 소리