Google CSE 모듈을 이용해서 해당 사이트의 구글 검색 결과를 임베이드해보자

Google CSE는 Google Custom Search Engine의 약자로 그 기능 중 일부는,
구글 검색한 결과를 해당 사이트 내부의 페이지에 커스터마이징, 임베이드가 가능케 한다.
사용 가능하기까지 다소 주의 사항이 필요하니 기록해 둔다.

말보다는 직접 예를 보여주는 것이 좋을 듯 하다.
Google CSE 예제

이러한 기능을 드루팔에서 구현해 주는 모듈이
http://drupal.org/project/google_cse
이다.

모듈을 설치/활성화 후에, 관리자 권한으로
admin/settings/google_cse
에 가 보면 Google Custom Search Engine ID: 를 입력하게 돼 있다.

이 정보를 얻기 위해서는 구글 애드센스 계정이 필요하다.
구글 애드센스 검색 설정에 가서 "검색 창"을 하나 만든다.

* 주의) 검색할 사이트의 Encoding 정보는 반드시 UTF-8로 설정하자. (드루팔 사이트니까)
* 주의) 검색 결과를 표시할 사이트는 해당 사이트 자신으로 지정하자. (그래야 임베이드 됨)
* 주의) 검색 결과를 표시할 사이트의 URL는 http://사이트명/search/google 으로 해야 한다.
* 주의) 취득할 애드센스 검색 코드는 "검색 박스" 이다. "검색 결과"는 관계없다(이는 본 모듈 안쓸 경우의 예).

취득한 애드센스 검색 코드에 있는 Google Custom Search Engine ID를 얻어
admin/settings/google_cse 화면에 설정하면 된다.
예를 들어 partner-pub-****숫자정보**** 형태의 문자열이다.

* 주의) 이때 얻는 구글 애드센스 코드 내부에 있는

부분은, 드루팔 사이트의 블럭에 써 넣을 때,

와 같이 수정하는 것이 좋겠다. 하지만 규약 위반이 없는지 신중하게 판단하자.
q를 query로 수정하는 이유는, 드루팔 내부의 파라미터와 충돌,
패스 분석을 제대로 못하고 404 현상을 유발하기 때문이다. (더 공부가 필요)

* 주의) 본 모듈과 비슷한 이름의 모듈이 AdSense 하위에 존재하나 다른 것이다.
* 주의) 위 팁의 결과물을 익명 유저들도 접할 수 있도록 하려면, 관리 > 유저 > 권한 설정 admin/user/permissions 에서 google_cse 모듈의 search Google CSE 항목을 권한별로 체크/저장할 필요가 있다.
* 주의) 본 모듈의 검색 주소가 /search로 돼 있지만, 드루팔 Search 모듈은 불필요하다.
즉 본 모듈은 드루팔의 표준검색 모듈에 의존하지 않는다.