Files
Gnuboard7/templates/_bundled/sirsoft-basic/layouts/search/index.json
T
HeuJung 04f1066e66 fix(release): 7.0.7 사전점검 실측 발견 결함 6건 보완 및 규정 반영
브라우저·SEO 실측(T1~T7 매트릭스 + 봇 렌더 스윕)에서 발견된 결함을 보완한다.

- 코어: 회원 일괄 상태변경 응답 메시지의 :count 플레이스홀더 미치환 수정
- 게시판·페이지: 비밀글·삭제글·미발행 첨부 썸네일이 KVE-2026-1914 게이트로
 깨진 것을 한시 서명 preview URL(게이트 통과 직렬화 발급 + 유효 서명 허용)로
 복구 — 무서명·변조·만료 요청 게이트는 종전과 동일
- 페이지: 발행/미발행 전환(after_publish)에도 SEO 캐시·사이트맵 갱신 구독
- 게시판: 게시판 디렉토리(전체 목록 + 내장 최근글)에 열람 권한 필터 적용
- 검색 화면: searchResults 데이터소스 auth_mode=optional 선언으로 로그인
 회원 검색 범위 복구 + data-sources.md 선언 의무 규정화(coverage 등록)
2026-08-18 10:38:50 +09:00

174 lines
8.2 KiB
JSON

{
"version": "1.0.0",
"layout_name": "search/index",
"permissions": [],
"extends": "_user_base",
"meta": {
"seo": {
"enabled": true,
"extensions": [
{ "type": "module", "id": "sirsoft-ecommerce" }
],
"data_sources": ["searchResults"],
"page_type": "search",
"toggle_setting": "$module_settings:sirsoft-ecommerce:seo.seo_search_result",
"vars": {
"site_name": "$core_settings:general.site_name"
},
"priority": 0.3,
"changefreq": "daily",
"og": {
"type": "website",
"title": "{{_seo.search.title ?? ''}}"
},
"structured_data": {
"@type": "SearchResultsPage",
"name": "{{_seo.search.title ?? ''}}"
}
}
},
"state": {
"q": ""
},
"init_actions": [
{
"handler": "setState",
"params": {
"target": "global",
"_local": {
"q": "{{query?.q || ''}}"
}
}
}
],
"data_sources": [
{
"id": "searchResults",
"label_key": "$t:editor.data_source.searchResults",
"type": "api",
"comment": "탭·게시판필터·정렬·페이지·커서는 전역 상태가 아니라 URL 쿼리를 읽는다. 전역 상태에 두면 주소가 바뀌지 않아 새로고침·뒤로가기에서 전부 초기값으로 돌아가고 결과를 그대로 공유할 수도 없다. cursor 는 커서로 넘길 수 있는 정렬(최신순 등)에서 이전/다음 이동 시 채워진다. 비어 있으면 서버가 첫 페이지로 읽고 다음 커서를 발급한다 — 관련도순은 계산값 정렬이라 서버가 커서를 발급하지 않고 page 로만 움직인다. auth_mode=optional: 검색 라우트는 optional.sanctum 으로 로그인 회원의 열람 범위(회원 전용 게시판 포함)를 해석하므로, 토큰이 있으면 반드시 실어 보낸다 — 미선언(none)이면 로그인 회원도 비회원 범위로 검색되어 서버측 권한 해석이 무력화된다",
"endpoint": "/api/search?q={{query?.q}}&type={{query?.type ?? 'all'}}&board_slug={{query?.board_slug ?? ''}}&sort={{query?.sort ?? 'relevance'}}&page={{query?.page ?? 1}}&cursor={{query?.cursor ?? ''}}&per_page={{(query?.type === 'products') ? 12 : 10}}",
"method": "GET",
"auth_mode": "optional",
"auto_fetch": true,
"loading_strategy": "progressive",
"condition": "{{query?.q}}",
"fallback": {
"data": {
"keyword": "",
"total": 0,
"results": {
"posts": {
"total": 0,
"items": []
},
"products": {
"total": 0,
"items": []
},
"pages": {
"total": 0,
"items": []
}
}
}
}
}
],
"slots": {
"content": [
{
"type": "layout",
"name": "Container",
"props": {
"className": "py-4"
},
"responsive": {
"desktop": {
"props": {
"className": "py-8"
}
}
},
"children": [
{
"comment": "페이지 헤더",
"type": "basic",
"name": "Div",
"props": {
"className": "mb-6"
},
"children": [
{
"type": "basic",
"name": "H1",
"props": {
"className": "text-2xl font-bold text-gray-900 dark:text-white flex items-center gap-2"
},
"children": [
{
"type": "basic",
"name": "Icon",
"props": {
"name": "search",
"size": "lg"
}
},
{
"type": "basic",
"name": "Span",
"text": "$t:search.title"
}
]
}
]
},
{
"partial": "partials/search/_search_input.json"
},
{
"partial": "partials/search/_search_tabs.json"
},
{
"partial": "partials/search/_search_filters.json"
},
{
"partial": "partials/search/_search_states.json"
},
{
"partial": "partials/search/_search_results.json"
},
{
"comment": "페이지네이션 — 총 건수가 상한에 걸리면 last_page 가 null 로 온다. 그때는 페이지 번호 목록과 마지막 페이지 점프가 사라지고 이전/다음만 남으며, 다음 이동은 has_more_pages 로 끝까지 열려 있다",
"type": "composite",
"name": "Pagination",
"if": "{{query?.q && (query?.type ?? 'all') !== 'all' && ((searchResults?.data?.last_page ?? 0) > 1 || searchResults?.data?.has_more_pages === true || (searchResults?.data?.current_page ?? 1) > 1)}}",
"props": {
"comment": "커서로 넘길 때 서버는 페이지 번호를 세지 않으므로 표시용 번호는 화면이 센다",
"currentPage": "{{Number(query?.page ?? searchResults?.data?.current_page ?? 1)}}",
"totalPages": "{{searchResults?.data?.last_page ?? null}}",
"hasMorePages": "{{searchResults?.data?.has_more_pages ?? false}}",
"className": "mt-6 flex justify-center"
},
"actions": [
{
"comment": "같은 검색 안에서의 페이지 이동이라 mergeQuery 로 검색어·탭·정렬·게시판필터를 그대로 승계한다. 커서는 이동 방향으로 정한다 — 이 시점의 query.page 는 아직 이동 전 값이라 앞뒤를 알 수 있고, 서버가 커서를 발급하지 않는 정렬(관련도순)에서는 빈 값이 되어 키가 지워지고 page 로만 움직인다",
"event": "onPageChange",
"handler": "navigate",
"params": {
"path": "/search",
"mergeQuery": true,
"query": {
"page": "{{$args[0]}}",
"cursor": "{{$args[0] > Number(query?.page ?? 1) ? (searchResults?.data?.next_cursor ?? '') : ($args[0] < Number(query?.page ?? 1) ? (searchResults?.data?.prev_cursor ?? '') : '')}}"
}
}
}
]
}
]
}
]
}
}