XE 공식 자료실

Postcodify 오픈소스 도로명주소 검색 프로그램을 XE와 연동하는 모듈입니다. XE의 krzip 모듈을 대체합니다. (모듈명이 코어에 하드코딩되어 있어서 모듈명 중복이 불가피합니다.)

편리하고 강력한 검색 기능을 제공하며, 지도 연결 등 다양한 설정이 가능합니다. 2015년 8월 시행되는 새우편번호(기초구역번호)에도 완벽하게 대비할 수 있습니다.

버전 2.0에서는 최근 Postcodify에 추가된 팝업 레이어 기능을 활용하고, 한 페이지에 여러 개의 주소 입력란을 넣을 수 있도록 하였으며, 반환 데이터 포맷을 정리하고, 우편번호 개편에 대비한 옵션을 추가하였습니다.

버전 2.1에서는 모바일 및 반응형 레이아웃 지원을 강화하였습니다.

버전 2.2에서는 몇 가지 버그를 수정하고, 공식 krzip 모듈과의 호환성을 강화하고, SSL 사용을 확대하여 보안을 강화하였습니다.

버전 2.3에서는 검색 스크립트를 비동기적으로 불러오도록 하여 페이지 로딩 속도를 향상시키고, 사용자 편의를 위해 UI 처리 방식을 일부 조정하였습니다.

설치 방법:

1. 기존에 사용하던 krzip 모듈을 삭제하고, 관리 모듈에서 캐시를 재생성합니다.
2. 이 모듈의 krzip 폴더를 XE의 모듈 폴더로 복사합니다.
3. 회원가입 또는 회원정보 변경 페이지에서 평소처럼 우편번호 검색을 하시면 됩니다.
4. 모듈 설정 화면에서 검색서버의 주소, 지도 링크, 팝업창 사용, 지번주소 표시 여부 등을 선택할 수 있습니다.

데이터 포맷 관련 주의사항:

기존 모듈은 주소데이터 포맷이 도로명주소 표기 형식에 맞지 않고 우편번호가 별도의 필드로 구분되지 않는 문제가 있었고, 이 모듈의 예전(1.0~1.2) 버전도 기존 모듈의 필드 순서를 따르다 보니 우편번호 필드가 마지막에 붙어서 이용하기도 불편하고 확장성을 방해하는 문제가 있었습니다.

그래서 버전 2.0부터는 반환하는 주소데이터 포맷을 변경하였으니 기존의 주소데이터를 다른 모듈이나 쇼핑몰 프로그램 등과 연동하시던 분들은 README에서 설명하는 포맷을 참고하셔서 충분히 테스트해 보시기 바랍니다. 기존의 주소데이터를 새 포맷으로 일괄 변환하기를 원하시는 분은 이 모듈에서 제공하는 convertDataFormat() 메소드를 사용하셔도 됩니다.

이후 더이상의 포맷 변경은 없을 예정이나, 기본 제공하는 4개 필드 외에 다른 필드가 추가될 가능성은 있습니다.