Postcodify 매뉴얼

업데이트 안내

jQuery 플러그인 업데이트

검색 도중 “도로명주소 검색 플러그인을 업데이트해 주시기 바랍니다.” 라는 메시지를 보고 찾아오셨다면 아래의 내용을 참고하여 jQuery 플러그인을 최신 버전으로 업데이트하고, 더이상 수동으로 업데이트하지 않아도 되도록 조치해 주시기 바랍니다.

Postcodify 최신 버전의 jQuery 플러그인을 사용하면 아래와 같은 유익이 있습니다.

  • 많은 버그를 수정하고 전체적인 안정화 및 최적화가 이루어졌습니다.
  • 무료 API 메인서버가 다운되거나 느려질 경우 자동으로 백업서버를 활용하는 기능이 추가되었습니다. 반면, 구 버전을 사용하면 메인서버가 다운될 경우 검색이 전혀 불가능하게 됩니다. 따라서 안정성을 원하신다면 반드시 업데이트해야 합니다.
  • 원하실 경우 지도 연결, 영문주소 검색 등 다양한 기능을 사용할 수 있습니다.

Postcodify는 하위 호환성을 아주 중요하게 여깁니다. 첫 버전부터 최신 버전까지 설정 문법과 CSS 클래스 등을 전혀 바꾸지 않았으므로, jQuery 플러그인을 업데이트하더라도 기존에 쓰시던 것과 100% 동일하게 계속 사용하실 수 있습니다.

jQuery 플러그인 (search.js 또는 search.min.js) 파일을 서버에 복사하여 쓰셨거나 다른 CDN에서 구 버전을 로딩하여 사용하셨다면 아래와 같이 공식 CDN으로 경로를 바꾸어 주십시오. 공식 CDN은 자동으로 업데이트가 이루어집니다.

<script src="//d1p7wdleee1q2z.cloudfront.net/post/search.min.js"></script>

HTTPS를 사용하며 인터넷 익스플로러 6.0 지원이 필요한 경우에는 아래의 한 줄을 더 추가해 주십시오. (관련 공지사항)

<!--[if IE 6]><script src="http://d1p7wdleee1q2z.cloudfront.net/post/search.min.js"></script><![endif]-->

더 자세한 정보는 무료 API 및 CDN 활용 안내 페이지를 참고하시기 바랍니다.

Postcodify는 오픈소스이므로 얼마든지 복사하여 쓰셔도 됩니다. 그러나 검색서버를 직접 구축하신 경우를 제외하면, jQuery 플러그인 파일을 서버에 복사하여 쓰거나 소스코드 전체를 웹 페이지 소스에 삽입하여 쓰는 일은 없도록 해 주시기 바랍니다. 호환성 유지를 위해 노력하고 있으나, 공식 CDN에서 직접 배포하는 파일 외에는 무료 API와의 호환성을 보장할 수 없습니다.

검색서버 업데이트

아래의 내용은 검색서버를 직접 구축하신 경우에만 해당됩니다.

터미널에서 git pull 명령을 실행하면 최신 버전의 Postcodify로 업데이트할 수 있습니다.

단, 버전에 따라 DB 구조에 차이가 있으므로 1.7 이하에서 1.8 이상으로 변경한 경우, 1.8 이하에서 2.0 이상으로 변경한 경우, 그리고 2.5 이하에서 3.0 이상으로 변경한 경우에는 반드시 인덱서를 다시 실행해야 합니다. 구 버전에서 생성한 DB를 새 버전에서 사용할 경우 에러가 발생할 수 있습니다.