포털 검색 페이지 플러그인 (portal-search-page)

네이버/구글 스타일의 검색 결과 페이지를 제공하는 플러그인입니다. 로고+검색창 헤더 아래 통합검색 / 이미지 / 웹문서 / 사이트 / 뉴스 5개 탭으로 결과를 보여주며, 최고관리자는 검색창 옆 톱니바퀴 버튼으로 사이트·뉴스 소스를 등록·관리하고, 외부 사이트 운영자는 웹마스터 도구에서 직접 자신의 사이트를 등록·소유확인할 수 있습니다.

주요 기능

• 통합검색 — 접근 가능한 모든 게시판에서 제목/본문에 검색어가 포함된 글을 게시판별로 그룹핑해 표시(제목+본문 요약+썸네일), 그룹당 최대 5건·최대 8개 게시판, "더보기"는 플러그인 내에서 페이징 처리(코어 검색 페이지로 이동하지 않음)
• 이미지 탭 — 썸네일이 있는 글만 모아 그리드로 표시
• 웹문서/사이트/뉴스 탭 — 관리자가 등록한 사이트·RSS/사이트맵 소스와, 웹마스터 도구로 소유확인을 마친 외부 사이트·뉴스 게시자를 함께 노출
• 사이트/뉴스 소스 등록 관리자 화면(admin.php, 최고관리자 전용) — data/*.json 파일 기반으로 저장(별도 DB 테이블·설치 스크립트 불필요)
• 웹마스터 도구(webmaster.php) — 로그인 없이 외부 사이트 운영자가 직접 등록 후 메타태그 또는 인증파일로 소유확인
• robots.txt를 준수하는 자동 크롤링 — 관리자가 등록만 해두면 소유확인 없이도 사이트맵/RSS/링크패턴 기반으로 자동 수집, 9종 메타태그로 준수도 점수를 매겨 우선순위 채택, MediaWiki(위키) 사이트 전용 처리 포함
• 검색옵션 — 정렬(관련도순/최신순), 기간(전체~1년) 필터
• 검색창 부가기능 — 음성 검색(Web Speech API), 2벌식 화면 키보드(입력도구) — theme/portal 헤더 검색창과 공용
• 실종아동정보(안전드림 safe182) 사이드 노출 — 검색어가 없거나 결과가 없을 때만 표시되는 선택 기능(API 키를 등록해야 동작)

구성 파일

• plugin/portal-search-page/index.php — 검색 결과 페이지
• plugin/portal-search-page/admin.php — 사이트·뉴스 소스 등록 + 웹마스터 도구 등록 현황 관리(최고관리자 전용)
• plugin/portal-search-page/webmaster.php — 공개 사이트 등록·소유확인 페이지(로그인 불필요)
• plugin/portal-search-page/site.save.php / news.save.php / webmaster.save.php / safe182.save.php — 각 기능의 AJAX 저장 엔드포인트
• plugin/portal-search-page/search.common.php — 설정/CRUD/검색·수집·소유확인 공용 함수
• plugin/portal-search-page/css/style.css, js/admin.js, js/webmaster.js, js/search-tools.js — 스타일 및 스크립트
• plugin/portal-search-page/cron_autocrawl.php — 자동 크롤링 사전 수집 스크립트(CLI 전용, crontab 등록은 선택 사항)

설치 방법

1. 첨부된 zip을 /plugin/ 경로에 압축 해제 (결과: /plugin/portal-search-page/)
2. 코어 DB 테이블을 생성하지 않으며 설정은 모두 data/*.json 파일에 저장됩니다. data/ 폴더와 .htaccess는 최초 실행 시 코드가 자동 생성하므로 별도 작업이 필요 없습니다
3. 검색창을 이 플러그인으로 연결하려면 테마의 검색 폼 action을 G5_PLUGIN_URL.'/portal-search-page/index.php'로 지정하세요 (PORTAL 테마는 이미 연동되어 있고, $is_admin == 'super'일 때만 보이는 관리자 설정 톱니바퀴 버튼도 검색창 옆에 함께 추가되어 있습니다)
4. 최고관리자로 /plugin/portal-search-page/admin.php 접속 후 사이트/뉴스 소스 등록, 필요 시 하단 "실종아동정보 서비스 설정"에서 안전드림 API 키 입력

※ 첨부파일에는 data/ 폴더(등록된 사이트·뉴스 소스, 각종 캐시, 실종아동정보 API 키 등 설치본별 런타임 데이터)가 포함되어 있지 않습니다. 코드가 최초 실행 시 필요한 파일/폴더를 자동 생성합니다.