Omeka Classic Geolocation 지도 팝업창 출력 정보 커스텀 방법

이승일

오메카 클래식의 지도 플러그인 Geolocation에서 지도 마커 클릭 시 나타나는 팝업창 정보를 수정하는 방법입니다.
수정이 필요한 파일은 browse.kml.php 입니다.
파일 경로는 /plugins/Geolocation/views/shared/map/ 입니다.
팝업창에서 출력되는 기본 정보는 DC: Title, DC: Description, 해당 아이템의 썸네일 이미지입니다.

browse.kml.php 파일은 KML 마크업을 사용합니다.
KML은 구글 지도 또는 구글 어스의 지리 데이터 정보를 출력하기 위해 사용되는 XML 기반의 마크업 언어입니다.
이 파일에서 xml은 요소 표시 설정을, php는 오메카의 아이템 정보를 불러오는 역할을 합니다.

KML 데이터의 주요 요소 중 오메카 Geolocation 플러그인에 사용된 요소는 다음과 같습니다.
<Style> : 팝업창에 출력시킬 요소 설정
<Placemarks> : 위치 표시
<name> : 위치 표시 레이블
<description> : 설명

팝업창 출력 정보 설정은 아래와 같이 수정할 수 있습니다.
1. <Style> 요소
화면 상에 출력을 원하는 요소만 작성합니다.

노출을 원하지 않는 요소는 주석 처리해서 해당 코드가 실행되지 않도록 비활성화합니다.

만약 썸네일 출력을 원치 않는 경우에는 해당 라인을 주석 처리하면 됩니다.
여기에선 링크 타이틀 요소만 주석 처리했고 썸네일과 메타 출력을 위한 요소만 사용했습니다.

2. <description>
이 요소는 아래와 같이 중복해서 사용할 수 있습니다.
여기서는 원하는 메타 정보들을 출력시키기 위해 사용합니다.
팝업창에 표시하고 싶은 기본 메타(Dublin Colre)와 커스텀 메타(Item Type Metadata)를 형식에 맞게 작성합니다.
<name> 요소는 기본적으로 제목을 출력시키면서 링크 설정이 걸려 있는 요소인데 여기서는 표시부에서 제외하고 <description> 요소만 출력되도록 설정했습니다. 물론 <name> 요소는 들어가 있지만 위의 <Style> 요소에서 출력 설정을 제외시켰기 때문에 화면 상에 링크 제목이 출력되지는 않습니다.
표시를 원하는 메타항목의 레이블과 속성값은 echo 함수에서 HTML 스크립트와 CSS를 적용하여 모양과 크기, 줄간격 등을 조정할 수 있습니다.

수정이 끝나면 파일을 저장하고 웹브라우저의 페이지를 리프레쉬합니다.
설정한 메타 정보들이 정상적으로 출력되는지 확인합니다.
수정 전과 수정 후 출력 결과는 아래와 같습니다.

[수정 전] 프론트엔드 출력 결과


[수정 후] 프론트엔드 출력 결과

수정 결과를 보면 지도 마커 클릭 시 팝업창에 제목, 창작자, 촬영장소, 촬영날짜, 주제, Statement 같은 메타 정보가 출력되는 것을 확인할 수 있습니다.

구글의 KML 데이터 관련 궁금한 사항은 아래 링크를 참고해 주세요.

https://developers.google.com/kml/documentation/kml_tut?hl=ko